feat(test-utils): add mockFn and mockLogger utils

docs/content/2.guide/6.going-further/7.testing.md

@@ -184,6 +184,11 @@ describe('ssr', async () => {
 
 For more usage, please refer to our [tests for Nuxt 3 framework](https://github.com/nuxt/framework/blob/main/test/basic.test.ts).
 
+## Mock utils
+
+- `mockFn()`: Returns a mocked function based on test runner.
+- `mockLogger()`: Mocks logger using [consola.mocklogs](https://github.com/unjs/consola#mocktypes) and `mockFn()`. Returns an object of mocked logger types.
+
 ## Testing in a Browser
 
 ::alert{icon=🚧}

packages/test-utils/src/context.ts

@@ -22,7 +22,9 @@ export function createTestContext (options: Partial<TestOptions>): TestContext {
     }
   })
 
-  return setTestContext({ options: _options as TestOptions })
+  return setTestContext({
+    options: _options as TestOptions
+  })
 }
 
 export function useTestContext (): TestContext {

packages/test-utils/src/index.ts

@@ -1,5 +1,6 @@
 export * from './browser'
 export * from './context'
+export * from './mock'
 export * from './nuxt'
 export * from './server'
 export * from './setup'

packages/test-utils/src/mock.ts

@@ -0,0 +1,16 @@
+import consola from 'consola'
+import { useTestContext } from './context'
+
+export function mockFn () {
+  const ctx = useTestContext()
+  return ctx.mockFn
+}
+
+export function mockLogger (): Record<string, Function> {
+  const mocks: any = {}
+  consola.mockTypes((type) => {
+    mocks[type] = mockFn()
+    return mocks[type]
+  })
+  return mocks
+}

packages/test-utils/src/setup/jest.ts

@@ -1,6 +1,11 @@
 import type { TestHooks } from '../types'
 
-export default function setupJest (hooks: TestHooks) {
+export default async function setupJest (hooks: TestHooks) {
+  // @ts-ignore
+  const jest = await import('jest')
+
+  hooks.ctx.mockFn = jest.fn
+
   // TODO: add globals existing check to provide better error message
   // @ts-expect-error jest types
   test('setup', hooks.setup, 120 * 1000)

packages/test-utils/src/setup/vitest.ts

@@ -2,6 +2,9 @@ import type { TestHooks } from '../types'
 
 export default async function setupVitest (hooks: TestHooks) {
   const vitest = await import('vitest')
+
+  hooks.ctx.mockFn = vitest.vi.fn
+
   vitest.beforeAll(hooks.setup, 120 * 1000)
   vitest.beforeEach(hooks.beforeEach)
   vitest.afterEach(hooks.afterEach)

packages/test-utils/src/types.ts

@@ -31,6 +31,7 @@ export interface TestContext {
   browser?: Browser
   url?: string
   serverProcess?: ExecaChildProcess
+  mockFn?: Function
 }
 
 export interface TestHooks {