@nuxt/test-utils 3.19.1 → 3.20.1

package/dist/config.d.mts

@@ -24,7 +24,7 @@ interface NuxtEnvironmentOptions {
     rootDir?: string;
     /**
      * The starting URL for your Nuxt window environment
-     * @default {http://localhost:3000}
+     * @default 'http://localhost:3000'
      */
     url?: string;
     /**
@@ -37,14 +37,14 @@ interface NuxtEnvironmentOptions {
     overrides?: NuxtConfig;
     /**
      * The id of the root div to which the app should be mounted. You should also set `app.rootId` to the same value.
-     * @default {nuxt-test}
+     * @default 'nuxt-test'
      */
     rootId?: string;
     /**
      * The name of the DOM environment to use.
      *
      * It also needs to be installed as a dev dependency in your project.
-     * @default {happy-dom}
+     * @default 'happy-dom'
      */
     domEnvironment?: 'happy-dom' | 'jsdom';
     mock?: {

package/dist/config.mjs

@@ -226,15 +226,19 @@ function defineVitestConfig(config = {}) {
     if (resolvedConfig.test.browser?.enabled) {
       return resolvedConfig;
     }
-    if ("workspace" in resolvedConfig.test) {
+    if ("workspace" in resolvedConfig.test || "projects" in resolvedConfig.test) {
       throw new Error(
-        "The `workspace` option is not supported with `defineVitestConfig`. Instead, use `defineVitestProject` to define each workspace project that uses the Nuxt environment."
+        "The `projects` option is not supported with `defineVitestConfig`. Instead, use `defineVitestProject` to define each workspace project that uses the Nuxt environment."
       );
     }
     const defaultEnvironment = resolvedConfig.test.environment || "node";
     if (defaultEnvironment !== "nuxt") {
-      resolvedConfig.test.workspace = [];
-      resolvedConfig.test.workspace.push({
+      const key = "projects" in resolvedConfig.test ? "projects" : "workspace" in resolvedConfig.test ? "workspace" : await import('vitest/package.json', { with: { type: 'json' } }).then((r) => {
+        const [major, minor] = (r.default || r).version.split(".");
+        return Number.parseInt(major, 10) > 3 || Number.parseInt(major, 10) === 3 && Number.parseInt(minor, 10) >= 2;
+      }) ? "projects" : "workspace";
+      resolvedConfig.test[key] = [];
+      resolvedConfig.test[key].push({
         extends: true,
         test: {
           name: "nuxt",
@@ -245,6 +249,22 @@ function defineVitestConfig(config = {}) {
           ]
         }
       });
+      resolvedConfig.test[key].push({
+        extends: true,
+        test: {
+          name: defaultEnvironment,
+          environment: defaultEnvironment,
+          exclude: [
+            "**/node_modules/**",
+            "**/dist/**",
+            "**/cypress/**",
+            "**/.{idea,git,cache,output,temp}/**",
+            "**/{karma,rollup,webpack,vite,vitest,jest,ava,babel,nyc,cypress,tsup,build,eslint,prettier}.config.*",
+            "./**/*.nuxt.{test,spec}.{js,mjs,cjs,ts,mts,cts,jsx,tsx}",
+            "./{test,tests}/nuxt/**.*"
+          ]
+        }
+      });
     }
     return resolvedConfig;
   });

package/dist/e2e.d.mts

@@ -1,5 +1,5 @@
-import { T as TestOptions, a as TestContext, b as TestHooks } from './shared/test-utils.DtJCg4f3.mjs';
-export { $ as $fetch, G as GotoOptions, N as NuxtPage, S as StartServerOptions, h as TestRunner, c as createBrowser, d as createPage, f as fetch, g as getBrowser, s as startServer, e as stopServer, u as url, w as waitForHydration } from './shared/test-utils.DtJCg4f3.mjs';
+import { T as TestOptions, a as TestContext, b as TestHooks } from './shared/test-utils.20kU0tZa.mjs';
+export { $ as $fetch, G as GotoOptions, N as NuxtPage, S as StartServerOptions, h as TestRunner, c as createBrowser, d as createPage, f as fetch, g as getBrowser, s as startServer, e as stopServer, u as url, w as waitForHydration } from './shared/test-utils.20kU0tZa.mjs';
 import { LogType } from 'consola';
 import 'playwright-core';
 import '@nuxt/schema';

package/dist/e2e.mjs

@@ -1,6 +1,6 @@
-export { b as buildFixture, c as createBrowser, a as createPage, d as createTest, g as getBrowser, l as loadFixture, e as setup, s as setupMaps, w as waitForHydration } from './shared/test-utils.CT3RJOY3.mjs';
-import { u as useTestContext } from './shared/test-utils.B8qEdk9k.mjs';
-export { $ as $fetch, c as createTestContext, e as exposeContextToEnv, f as fetch, i as isDev, r as recoverContextFromEnv, s as setTestContext, a as startServer, b as stopServer, d as url } from './shared/test-utils.B8qEdk9k.mjs';
+export { b as buildFixture, c as createBrowser, a as createPage, d as createTest, g as getBrowser, l as loadFixture, e as setup, s as setupMaps, w as waitForHydration } from './shared/test-utils.CtoalVlS.mjs';
+import { u as useTestContext } from './shared/test-utils.CtwoJP76.mjs';
+export { $ as $fetch, c as createTestContext, e as exposeContextToEnv, f as fetch, i as isDev, r as recoverContextFromEnv, s as setTestContext, a as startServer, b as stopServer, d as url } from './shared/test-utils.CtwoJP76.mjs';
 import { consola } from 'consola';
 import { resolve } from 'pathe';
 import { distDir } from '#dirs';

package/dist/experimental.mjs

@@ -1,6 +1,6 @@
 import { resolve } from 'pathe';
 import { stringifyQuery } from 'ufo';
-import { $ as $fetch, u as useTestContext } from './shared/test-utils.B8qEdk9k.mjs';
+import { $ as $fetch, u as useTestContext } from './shared/test-utils.CtwoJP76.mjs';
 import 'tinyexec';
 import 'get-port-please';
 import 'ofetch';

package/dist/module.mjs

@@ -1,6 +1,5 @@
 import { pathToFileURL } from 'node:url';
-import { useNuxt, resolveIgnorePatterns, addVitePlugin, defineNuxtModule, createResolver, resolvePath, logger } from '@nuxt/kit';
-import { mergeConfig } from 'vite';
+import { useNuxt, resolveIgnorePatterns, addVitePlugin, defineNuxtModule, createResolver, resolvePath, importModule, logger } from '@nuxt/kit';
 import { getPort } from 'get-port-please';
 import { h } from 'vue';
 import { debounce } from 'perfect-debounce';
@@ -13,6 +12,7 @@ import { createUnplugin } from 'unplugin';
 import { readFileSync } from 'node:fs';
 import { extname, join, dirname } from 'pathe';
 import 'node:process';
+import 'vite';
 import 'c12';
 import 'destr';
 import 'scule';
@@ -217,7 +217,7 @@ vi.hoisted(() => {
         const vitestPlugins = plugins.filter((p) => (p.name === "vite:mocks" || p.name.startsWith("vitest:")) && (p.enforce || "order" in p && p.order) === "post");
         const lastNuxt = findLastIndex(
           plugins,
-          (i) => i.name?.startsWith("nuxt:")
+          (i) => !!i?.name?.startsWith("nuxt:")
         );
         if (lastNuxt === -1) return;
         for (const plugin of vitestPlugins) {
@@ -279,7 +279,7 @@ function setupImportMocking() {
     ctx.components = _;
   });
   nuxt.hook("imports:sources", (presets) => {
-    const idx = presets.findIndex((p) => p.imports.includes("setInterval"));
+    const idx = presets.findIndex((p) => p.imports?.includes("setInterval"));
     if (idx !== -1) {
       presets.splice(idx, 1);
     }
@@ -360,6 +360,7 @@ const module = defineNuxtModule({
     }, 100);
     let URL;
     async function start() {
+      const { mergeConfig } = await importModule("vite", { paths: nuxt.options.modulesDir });
       const rawViteConfig = mergeConfig({}, await rawViteConfigPromise);
       const viteConfig = await getVitestConfigFromNuxt({ nuxt, viteConfig: defu({ test: options.vitestConfig }, rawViteConfig) });
       viteConfig.plugins = (viteConfig.plugins || []).filter((p) => {

package/dist/playwright.d.mts

@@ -1,7 +1,7 @@
 import * as _playwright_test from '@playwright/test';
 export { expect } from '@playwright/test';
 import { Response } from 'playwright-core';
-import { T as TestOptions$1, G as GotoOptions, b as TestHooks } from './shared/test-utils.DtJCg4f3.mjs';
+import { T as TestOptions$1, G as GotoOptions, b as TestHooks } from './shared/test-utils.20kU0tZa.mjs';
 import '@nuxt/schema';
 import 'tinyexec';
 

package/dist/playwright.mjs

@@ -1,14 +1,14 @@
 import defu from 'defu';
 import { test as test$1 } from '@playwright/test';
 export { expect } from '@playwright/test';
-import { w as waitForHydration, d as createTest } from './shared/test-utils.CT3RJOY3.mjs';
+import { w as waitForHydration, d as createTest } from './shared/test-utils.CtoalVlS.mjs';
 import 'node:path';
 import 'ufo';
 import 'std-env';
 import 'consola';
 import 'node:fs';
 import '@nuxt/kit';
-import { d as url } from './shared/test-utils.B8qEdk9k.mjs';
+import { d as url } from './shared/test-utils.CtwoJP76.mjs';
 import 'pathe';
 import '#dirs';
 import 'tinyexec';

package/dist/runtime/mocks/vue-devtools.d.ts

@@ -3,3 +3,9 @@ export declare function createRpcServer(): void;
 export declare const devtools: {
     init(): void;
 };
+export declare function addCustomCommand(): void;
+export declare function addCustomTab(): void;
+export declare function onDevToolsClientConnected(): void;
+export declare function onDevToolsConnected(): void;
+export declare function removeCustomCommand(): void;
+export declare function setupDevToolsPlugin(): void;

package/dist/runtime/mocks/vue-devtools.mjs

@@ -5,3 +5,15 @@ export const devtools = {
   init() {
   }
 };
+export function addCustomCommand() {
+}
+export function addCustomTab() {
+}
+export function onDevToolsClientConnected() {
+}
+export function onDevToolsConnected() {
+}
+export function removeCustomCommand() {
+}
+export function setupDevToolsPlugin() {
+}

package/dist/runtime/shared/environment.mjs

@@ -36,26 +36,51 @@ export async function setupWindow(win, environmentOptions) {
   app.id = rootId;
   win.document.body.appendChild(app);
   const h3App = createApp();
-  if (!win.fetch) {
+  if (!win.fetch || !("Request" in win)) {
     await import("node-fetch-native/polyfill");
     win.URLSearchParams = globalThis.URLSearchParams;
+    win.Request ??= class Request extends globalThis.Request {
+      constructor(input, init) {
+        if (typeof input === "string") {
+          super(new URL(input, win.location.origin), init);
+        } else {
+          super(input, init);
+        }
+      }
+    };
   }
   const nodeHandler = toNodeListener(h3App);
   const registry = /* @__PURE__ */ new Set();
-  win.fetch = async (url, init) => {
-    if (typeof url === "string") {
-      const base = url.split("?")[0];
-      if (registry.has(base) || registry.has(url)) {
-        url = "/_" + url;
-      }
-      if (url.startsWith("/")) {
-        const response = await fetchNodeRequestHandler(nodeHandler, url, init);
-        return normalizeFetchResponse(response);
-      }
+  const _fetch = fetch;
+  win.fetch = async (input, _init) => {
+    let url;
+    let init = _init;
+    if (typeof input === "string") {
+      url = input;
+    } else if (input instanceof URL) {
+      url = input.toString();
+    } else {
+      url = input.url;
+      init = {
+        method: init?.method ?? input.method,
+        body: init?.body ?? input.body,
+        headers: init?.headers ?? input.headers
+      };
+    }
+    const base = url.split("?")[0];
+    if (registry.has(base) || registry.has(url)) {
+      url = "/_" + url;
     }
-    return fetch(url, init);
+    if (url.startsWith("/")) {
+      const response = await fetchNodeRequestHandler(nodeHandler, url, init);
+      return normalizeFetchResponse(response);
+    }
+    return _fetch(input, _init);
   };
   win.$fetch = createFetch({ fetch: win.fetch, Headers: win.Headers });
+  win.$fetch.create = (options = {}) => {
+    return createFetch({ fetch: win.fetch, Headers: win.Headers, ...options });
+  };
   win.__registry = registry;
   win.__app = h3App;
   const timestamp = Date.now();

package/dist/runtime-utils/index.d.mts

@@ -67,6 +67,7 @@ declare function mockComponent<PropsOptions extends Readonly<ComponentPropsOptio
 
 type MountSuspendedOptions<T> = ComponentMountingOptions<T> & {
     route?: RouteLocationRaw;
+    scoped?: boolean;
 };
 type SetupState$1 = Record<string, any>;
 /**
@@ -98,6 +99,9 @@ type SetupState$1 = Record<string, any>;
 declare function mountSuspended<T>(component: T, options?: MountSuspendedOptions<T>): Promise<ReturnType<typeof mount<T>> & {
     setupState: SetupState$1;
 }>;
+declare global {
+    var __cleanup: Array<() => void> | undefined;
+}
 
 type RenderOptions<C = unknown> = RenderOptions$1<C> & {
     route?: RouteLocationRaw;

package/dist/runtime-utils/index.mjs

@@ -1,6 +1,6 @@
 import { defineEventHandler } from 'h3';
 import { mount } from '@vue/test-utils';
-import { reactive, h as h$1, Suspense, nextTick, getCurrentInstance, unref, isReadonly, defineComponent as defineComponent$1, effectScope } from 'vue';
+import { reactive, h as h$1, Suspense, nextTick, effectScope, unref, isReadonly, getCurrentInstance, isRef, defineComponent as defineComponent$1 } from 'vue';
 import { defu } from 'defu';
 import { defineComponent, useRouter, h, tryUseNuxtApp } from '#imports';
 import NuxtRoot from '#build/root-component.mjs';
@@ -19,17 +19,17 @@ function registerEndpoint(url, options) {
   if (!hasBeenRegistered) {
     window.__registry.add(url);
     app.use("/_" + url, defineEventHandler((event) => {
-      const latestHandler = [...endpointRegistry[url]].reverse().find((config2) => config2.method ? event.method === config2.method : true);
+      const latestHandler = [...endpointRegistry[url] || []].reverse().find((config2) => config2.method ? event.method === config2.method : true);
       return latestHandler?.handler(event);
     }), {
       match(_, event) {
-        return endpointRegistry[url]?.some((config2) => config2.method ? event?.method === config2.method : true);
+        return endpointRegistry[url]?.some((config2) => config2.method ? event?.method === config2.method : true) ?? false;
       }
     });
   }
   return () => {
-    endpointRegistry[url].splice(endpointRegistry[url].indexOf(config), 1);
-    if (endpointRegistry[url].length === 0) {
+    endpointRegistry[url]?.splice(endpointRegistry[url].indexOf(config), 1);
+    if (endpointRegistry[url]?.length === 0) {
       window.__registry.delete(url);
     }
   };
@@ -87,16 +87,50 @@ async function mountSuspended(component, options) {
     route = "/",
     ..._options
   } = options || {};
+  for (const cleanupFunction of globalThis.__cleanup || []) {
+    cleanupFunction();
+  }
   const vueApp = tryUseNuxtApp()?.vueApp || globalThis.__unctx__.get("nuxt-app").tryUse().vueApp;
   const { render, setup, data, computed, methods } = component;
   let setupContext;
   let setupState;
   const setProps = reactive({});
+  let interceptedEmit = null;
+  function getInterceptedEmitFunction(emit) {
+    if (emit !== interceptedEmit) {
+      interceptedEmit = interceptedEmit ?? ((event, ...args) => {
+        emit(event, ...args);
+        setupContext.emit(event, ...args);
+      });
+    }
+    return interceptedEmit;
+  }
+  function interceptEmitOnCurrentInstance() {
+    const currentInstance = getCurrentInstance();
+    if (!currentInstance) {
+      return;
+    }
+    currentInstance.emit = getInterceptedEmitFunction(currentInstance.emit);
+  }
   let passedProps;
+  let componentScope = null;
   const wrappedSetup = async (props2, setupContext2) => {
+    interceptEmitOnCurrentInstance();
     passedProps = props2;
     if (setup) {
-      const result = await setup(props2, setupContext2);
+      let result;
+      if (options?.scoped) {
+        componentScope = effectScope();
+        globalThis.__cleanup ||= [];
+        globalThis.__cleanup.push(() => {
+          componentScope?.stop();
+        });
+        result = await componentScope?.run(async () => {
+          return await setup(props2, setupContext2);
+        });
+      } else {
+        result = await setup(props2, setupContext2);
+      }
       setupState = result && typeof result === "object" ? result : {};
       return result;
     }
@@ -107,11 +141,24 @@ async function mountSuspended(component, options) {
         {
           setup: (props2, ctx) => {
             setupContext = ctx;
-            return NuxtRoot.setup(props2, {
-              ...ctx,
-              expose: () => {
-              }
-            });
+            if (options?.scoped) {
+              const scope = effectScope();
+              globalThis.__cleanup ||= [];
+              globalThis.__cleanup.push(() => {
+                scope.stop();
+              });
+              return scope.run(() => NuxtRoot.setup(props2, {
+                ...ctx,
+                expose: () => {
+                }
+              }));
+            } else {
+              return NuxtRoot.setup(props2, {
+                ...ctx,
+                expose: () => {
+                }
+              });
+            }
           },
           render: (renderContext) => h$1(
             Suspense,
@@ -134,14 +181,7 @@ async function mountSuspended(component, options) {
                     name: "MountSuspendedComponent",
                     ...component,
                     render: render ? function(_ctx, ...args) {
-                      const currentInstance = getCurrentInstance();
-                      if (currentInstance) {
-                        const oldEmit = currentInstance.emit;
-                        currentInstance.emit = (event, ...args2) => {
-                          oldEmit(event, ...args2);
-                          setupContext.emit(event, ...args2);
-                        };
-                      }
+                      interceptEmitOnCurrentInstance();
                       if (data && typeof data === "function") {
                         const dataObject = data();
                         for (const key in dataObject) {
@@ -170,18 +210,22 @@ async function mountSuspended(component, options) {
                         propsContext[key] = passedProps[key];
                       }
                       if (methods && typeof methods === "object") {
-                        for (const key in methods) {
-                          renderContext[key] = methods[key].bind(renderContext);
+                        for (const [key, value] of Object.entries(methods)) {
+                          renderContext[key] = value.bind(renderContext);
                         }
                       }
                       if (computed && typeof computed === "object") {
-                        for (const key in computed) {
-                          renderContext[key] = computed[key].call(renderContext);
+                        for (const [key, value] of Object.entries(computed)) {
+                          if ("get" in value) {
+                            renderContext[key] = value.get.call(renderContext);
+                          } else {
+                            renderContext[key] = value.call(renderContext);
+                          }
                         }
                       }
                       return render.call(this, renderContext, ...args);
                     } : void 0,
-                    setup: setup ? (props2) => wrappedSetup(props2, setupContext) : void 0
+                    setup: (props2) => wrappedSetup(props2, setupContext)
                   };
                   return () => h$1(clonedComponent, { ...props, ...setProps, ...attrs }, slots);
                 }
@@ -226,6 +270,9 @@ function wrappedMountedWrapper(wrapper) {
       if (prop === "element") {
         const component = target.findComponent({ name: "MountSuspendedComponent" });
         return component[prop];
+      } else if (prop === "vm") {
+        const vm = Reflect.get(target, prop, receiver);
+        return createVMProxy(vm, wrapper.setupState);
       } else {
         return Reflect.get(target, prop, receiver);
       }
@@ -241,6 +288,28 @@ function wrappedMountedWrapper(wrapper) {
   }
   return proxy;
 }
+function createVMProxy(vm, setupState) {
+  return new Proxy(vm, {
+    get(target, key, receiver) {
+      const value = Reflect.get(target, key, receiver);
+      if (setupState && typeof setupState === "object" && key in setupState) {
+        return unref(setupState[key]);
+      }
+      return value;
+    },
+    set(target, key, value, receiver) {
+      if (setupState && typeof setupState === "object" && key in setupState) {
+        const setupValue = setupState[key];
+        if (setupValue && isRef(setupValue)) {
+          setupValue.value = value;
+          return true;
+        }
+        return Reflect.set(setupState, key, value, receiver);
+      }
+      return Reflect.set(target, key, value, receiver);
+    }
+  });
+}
 
 const WRAPPER_EL_ID = "test-wrapper";
 async function renderSuspended(component, options) {
@@ -256,12 +325,30 @@ async function renderSuspended(component, options) {
   const { render, setup, data, computed, methods } = component;
   let setupContext;
   let setupState;
+  let interceptedEmit = null;
+  function getInterceptedEmitFunction(emit) {
+    if (emit !== interceptedEmit) {
+      interceptedEmit = interceptedEmit ?? ((event, ...args) => {
+        emit(event, ...args);
+        setupContext.emit(event, ...args);
+      });
+    }
+    return interceptedEmit;
+  }
+  function interceptEmitOnCurrentInstance() {
+    const currentInstance = getCurrentInstance();
+    if (!currentInstance) {
+      return;
+    }
+    currentInstance.emit = getInterceptedEmitFunction(currentInstance.emit);
+  }
   for (const fn of window.__cleanup || []) {
     fn();
   }
   document.querySelector(`#${WRAPPER_EL_ID}`)?.remove();
   let passedProps;
   const wrappedSetup = async (props2, setupContext2) => {
+    interceptEmitOnCurrentInstance();
     passedProps = props2;
     if (setup) {
       const result = await setup(props2, setupContext2);
@@ -316,6 +403,7 @@ async function renderSuspended(component, options) {
                         name: "RenderSuspendedComponent",
                         ...component,
                         render: render ? function(_ctx, ...args) {
+                          interceptEmitOnCurrentInstance();
                           if (data && typeof data === "function") {
                             const dataObject = data();
                             for (const key in dataObject) {
@@ -344,18 +432,22 @@ async function renderSuspended(component, options) {
                             propsContext[key] = passedProps[key];
                           }
                           if (methods && typeof methods === "object") {
-                            for (const key in methods) {
-                              renderContext[key] = methods[key].bind(renderContext);
+                            for (const [key, value] of Object.entries(methods)) {
+                              renderContext[key] = value.bind(renderContext);
                             }
                           }
                           if (computed && typeof computed === "object") {
-                            for (const key in computed) {
-                              renderContext[key] = computed[key].call(renderContext);
+                            for (const [key, value] of Object.entries(computed)) {
+                              if ("get" in value) {
+                                renderContext[key] = value.get.call(renderContext);
+                              } else {
+                                renderContext[key] = value.call(renderContext);
+                              }
                             }
                           }
                           return render.call(this, renderContext, ...args);
                         } : void 0,
-                        setup: setup ? (props2) => wrappedSetup(props2, setupContext) : void 0
+                        setup: (props2) => wrappedSetup(props2, setupContext)
                       };
                       return () => h$1(clonedComponent, { ...props && typeof props === "object" ? props : {}, ...attrs }, slots);
                     }

package/dist/shared/{test-utils.DtJCg4f3.d.mts → test-utils.20kU0tZa.d.mts}

@@ -29,41 +29,41 @@ interface TestOptions {
     fixture: string;
     /**
      * Name of the configuration file.
-     * @default `'nuxt.config`
+     * @default 'nuxt.config'
      */
     configFile: string;
     /**
      * Path to a directory with a Nuxt app to be put under test.
-     * @default `'.'`
+     * @default '.'
      */
     rootDir: string;
     buildDir: string;
     nuxtConfig: NuxtConfig;
     /**
      * Whether to run a separate build step.
-     * @default `true` (`false` if `browser` or `server` is disabled, or if a `host` is provided)
+     * @default true // (`false` if `browser` or `server` is disabled, or if a `host` is provided)
      */
     build: boolean;
     dev: boolean;
     /**
      * The amount of time (in milliseconds) to allow for `setupTest` to complete its work (which could include building or generating files for a Nuxt application, depending on the options that are passed).
-     * @default `120000` or `240000` on windows
+     * @default 120000 // or `240000` on windows
      */
     setupTimeout: number;
     /**
      * The amount of time (in milliseconds) to allow tearing down the test environment, such as closing the browser.
-     * @default `30000`
+     * @default 30000
      */
     teardownTimeout: number;
     waitFor: number;
     /**
      * Under the hood, Nuxt test utils uses [`playwright`](https://playwright.dev) to carry out browser testing. If this option is set, a browser will be launched and can be controlled in the subsequent test suite.
-     * @default `false`
+     * @default false
      */
     browser: boolean;
     /**
      * Specify the runner for the test suite. One of `'vitest' | 'jest' | 'cucumber' | 'bun'`.
-     * @default `vitest`
+     * @default 'vitest'
      */
     runner: TestRunner;
     logLevel: number;
@@ -75,17 +75,17 @@ interface TestOptions {
     };
     /**
      * Whether to launch a server to respond to requests in the test suite.
-     * @default `true` (`false` if a `host` is provided)
+     * @default true // (`false` if a `host` is provided)
      */
     server: boolean;
     /**
      * If provided, a URL to use as the test target instead of building and running a new server. Useful for running "real" end-to-end tests against a deployed version of your application, or against an already running local server.
-     * @default `undefined`
+     * @default undefined
      */
     host?: string;
     /**
      * If provided, set the launched test server port to the value.
-     * @default `undefined`
+     * @default undefined
      */
     port?: number;
     env?: StartServerOptions['env'];
@@ -109,7 +109,7 @@ interface TestHooks {
     afterAll: () => Promise<void>;
     beforeAll: () => Promise<void>;
     /**
-     * @deprecated use `beforeAll` intead
+     * @deprecated use `beforeAll` instead
      */
     setup: () => Promise<void>;
     ctx: TestContext;

package/dist/shared/{test-utils.CT3RJOY3.mjs → test-utils.CtoalVlS.mjs}

@@ -1,4 +1,4 @@
-import { u as useTestContext, d as url, c as createTestContext, a as startServer, b as stopServer, s as setTestContext } from './test-utils.B8qEdk9k.mjs';
+import { u as useTestContext, d as url, c as createTestContext, a as startServer, b as stopServer, s as setTestContext } from './test-utils.CtwoJP76.mjs';
 import { existsSync, promises } from 'node:fs';
 import { resolve } from 'node:path';
 import { defu } from 'defu';
@@ -59,7 +59,7 @@ async function waitForHydration(page, url2, waitUntil) {
 
 const kit = _kit.default || _kit;
 const isNuxtApp = (dir) => {
-  return existsSync(dir) && (existsSync(resolve(dir, "pages")) || existsSync(resolve(dir, "nuxt.config.js")) || existsSync(resolve(dir, "nuxt.config.mjs")) || existsSync(resolve(dir, "nuxt.config.cjs")) || existsSync(resolve(dir, "nuxt.config.ts")));
+  return existsSync(dir) && (existsSync(resolve(dir, "pages")) || existsSync(resolve(dir, "nuxt.config.js")) || existsSync(resolve(dir, "nuxt.config.mjs")) || existsSync(resolve(dir, "nuxt.config.cjs")) || existsSync(resolve(dir, "nuxt.config.ts")) || existsSync(resolve(dir, ".config", "nuxt.js")) || existsSync(resolve(dir, ".config", "nuxt.mjs")) || existsSync(resolve(dir, ".config", "nuxt.cjs")) || existsSync(resolve(dir, ".config", "nuxt.ts")));
 };
 const resolveRootDir = () => {
   const { options } = useTestContext();

package/dist/shared/{test-utils.B8qEdk9k.mjs → test-utils.CtwoJP76.mjs}

@@ -14,7 +14,7 @@ function createTestContext(options) {
     fixture: "fixture",
     configFile: "nuxt.config",
     setupTimeout: isWindows ? 24e4 : 12e4,
-    teardownTimeout: 3e4,
+    teardownTimeout: isWindows ? 6e4 : 3e4,
     dev: !!JSON.parse(process.env.NUXT_TEST_DEV || "false"),
     logLevel: 1,
     server: true,

package/dist/vitest-environment.mjs

@@ -41,26 +41,51 @@ async function setupWindow(win, environmentOptions) {
   app.id = rootId;
   win.document.body.appendChild(app);
   const h3App = createApp();
-  if (!win.fetch) {
+  if (!win.fetch || !("Request" in win)) {
     await import('node-fetch-native/polyfill');
     win.URLSearchParams = globalThis.URLSearchParams;
+    win.Request ??= class Request extends globalThis.Request {
+      constructor(input, init) {
+        if (typeof input === "string") {
+          super(new URL(input, win.location.origin), init);
+        } else {
+          super(input, init);
+        }
+      }
+    };
   }
   const nodeHandler = toNodeListener(h3App);
   const registry = /* @__PURE__ */ new Set();
-  win.fetch = async (url, init) => {
-    if (typeof url === "string") {
-      const base = url.split("?")[0];
-      if (registry.has(base) || registry.has(url)) {
-        url = "/_" + url;
-      }
-      if (url.startsWith("/")) {
-        const response = await fetchNodeRequestHandler(nodeHandler, url, init);
-        return normalizeFetchResponse(response);
-      }
+  const _fetch = fetch;
+  win.fetch = async (input, _init) => {
+    let url;
+    let init = _init;
+    if (typeof input === "string") {
+      url = input;
+    } else if (input instanceof URL) {
+      url = input.toString();
+    } else {
+      url = input.url;
+      init = {
+        method: init?.method ?? input.method,
+        body: init?.body ?? input.body,
+        headers: init?.headers ?? input.headers
+      };
+    }
+    const base = url.split("?")[0];
+    if (registry.has(base) || registry.has(url)) {
+      url = "/_" + url;
     }
-    return fetch(url, init);
+    if (url.startsWith("/")) {
+      const response = await fetchNodeRequestHandler(nodeHandler, url, init);
+      return normalizeFetchResponse(response);
+    }
+    return _fetch(input, _init);
   };
   win.$fetch = createFetch({ fetch: win.fetch, Headers: win.Headers });
+  win.$fetch.create = (options = {}) => {
+    return createFetch({ fetch: win.fetch, Headers: win.Headers, ...options });
+  };
   win.__registry = registry;
   win.__app = h3App;
   const timestamp = Date.now();
@@ -150,10 +175,11 @@ const jsdom = (async function(global, { jsdom = {} }) {
     console: false,
     cookieJar: false
   });
+  const virtualConsole = jsdomOptions.console && global.console ? new VirtualConsole() : void 0;
   const window = new JSDOM(jsdomOptions.html, {
     ...jsdomOptions,
     resources: jsdomOptions.resources ?? (jsdomOptions.userAgent ? new ResourceLoader({ userAgent: jsdomOptions.userAgent }) : void 0),
-    virtualConsole: jsdomOptions.console && global.console ? new VirtualConsole().sendTo(global.console) : void 0,
+    virtualConsole: virtualConsole ? "sendTo" in virtualConsole ? virtualConsole.sendTo(global.console) : virtualConsole.forwardTo(global.console) : void 0,
     cookieJar: jsdomOptions.cookieJar ? new CookieJar() : void 0
   }).window;
   window.scrollTo = () => {
@@ -161,6 +187,7 @@ const jsdom = (async function(global, { jsdom = {} }) {
   return {
     window,
     teardown() {
+      window.close();
     }
   };
 });
@@ -184,21 +211,15 @@ const index = {
       jsdom: { url }
     }));
     if (environmentOptions?.nuxt?.mock?.intersectionObserver) {
-      win.IntersectionObserver = win.IntersectionObserver || class IntersectionObserver {
-        observe() {
-        }
-        unobserve() {
-        }
-        disconnect() {
-        }
-      };
+      win.IntersectionObserver ||= IntersectionObserver;
     }
     if (environmentOptions?.nuxt?.mock?.indexedDb) {
       win.indexedDB = indexedDB;
     }
     const teardownWindow = await setupWindow(win, environmentOptions);
     const { keys, originals } = populateGlobal(global, win, {
-      bindFunctions: true
+      bindFunctions: true,
+      additionalKeys: ["fetch", "Request"]
     });
     return {
       // called after all tests with this env have been run
@@ -206,10 +227,24 @@ const index = {
         keys.forEach((key) => delete global[key]);
         teardownWindow();
         originals.forEach((v, k) => global[k] = v);
+        if (!global.IntersectionObserver) {
+          global.IntersectionObserver = IntersectionObserver;
+        }
         teardown();
       }
     };
   }
 };
+class IntersectionObserver {
+  observe() {
+  }
+  unobserve() {
+  }
+  disconnect() {
+  }
+  takeRecords() {
+    return [];
+  }
+}
 
 export { index as default };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nuxt/test-utils",
-  "version": "3.19.1",
+  "version": "3.20.1",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/nuxt/test-utils.git"
@@ -56,81 +56,85 @@
   "scripts": {
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
+    "test": "pnpm test:types && pnpm test:unit && pnpm test:examples",
     "test:examples": "pnpm --filter '!example-app-cucumber' --filter '!example-app-jest' -r test && pnpm --filter example-app-cucumber -r test",
+    "test:knip": "knip",
+    "test:engines": "pnpm installed-check --no-workspaces --ignore-dev",
     "test:types": "vue-tsc --noEmit",
     "test:unit": "vitest test/unit --run",
+    "build": "unbuild",
     "prepack": "unbuild",
-    "dev:prepare": "nuxi prepare && unbuild --stub && pnpm -r dev:prepare"
+    "dev:prepare": "nuxt prepare && unbuild --stub && pnpm -r dev:prepare"
   },
   "dependencies": {
-    "@nuxt/kit": "^3.17.4",
-    "@nuxt/schema": "^3.17.4",
-    "c12": "^3.0.4",
+    "@nuxt/kit": "^4.1.3",
+    "c12": "^3.3.1",
     "consola": "^3.4.2",
     "defu": "^6.1.4",
     "destr": "^2.0.5",
     "estree-walker": "^3.0.3",
-    "fake-indexeddb": "^6.0.1",
-    "get-port-please": "^3.1.2",
-    "h3": "^1.15.3",
-    "local-pkg": "^1.1.1",
-    "magic-string": "^0.30.17",
-    "node-fetch-native": "^1.6.5",
-    "node-mock-http": "^1.0.0",
+    "fake-indexeddb": "^6.2.4",
+    "get-port-please": "^3.2.0",
+    "h3": "^1.15.4",
+    "local-pkg": "^1.1.2",
+    "magic-string": "^0.30.19",
+    "node-fetch-native": "^1.6.7",
+    "node-mock-http": "^1.0.3",
     "ofetch": "^1.4.1",
     "pathe": "^2.0.3",
-    "perfect-debounce": "^1.0.0",
+    "perfect-debounce": "^2.0.0",
     "radix3": "^1.1.2",
     "scule": "^1.3.0",
-    "std-env": "^3.9.0",
+    "std-env": "^3.10.0",
     "tinyexec": "^1.0.1",
     "ufo": "^1.6.1",
-    "unplugin": "^2.3.4",
-    "vite": "^6.3.5",
+    "unplugin": "^2.3.10",
     "vitest-environment-nuxt": "^1.0.1",
-    "vue": "^3.5.14"
+    "vue": "^3.5.22"
   },
   "devDependencies": {
-    "@cucumber/cucumber": "11.3.0",
-    "@jest/globals": "29.7.0",
-    "@nuxt/devtools-kit": "2.4.1",
-    "@nuxt/eslint-config": "1.4.0",
-    "@playwright/test": "1.52.0",
+    "@cucumber/cucumber": "12.2.0",
+    "@jest/globals": "30.2.0",
+    "@nuxt/devtools-kit": "2.6.5",
+    "@nuxt/eslint-config": "1.9.0",
+    "@nuxt/schema": "4.1.3",
+    "@playwright/test": "1.56.1",
     "@testing-library/vue": "8.1.0",
-    "@types/bun": "1.2.13",
-    "@types/estree": "1.0.7",
-    "@types/jsdom": "21.1.7",
-    "@types/node": "22.15.19",
-    "@types/semver": "7.7.0",
+    "@types/bun": "1.3.0",
+    "@types/estree": "1.0.8",
+    "@types/jsdom": "27.0.0",
+    "@types/node": "latest",
+    "@types/semver": "7.7.1",
     "@vue/test-utils": "2.4.6",
-    "changelogen": "0.6.1",
+    "changelogen": "0.6.2",
     "compatx": "0.2.0",
-    "eslint": "9.27.0",
+    "eslint": "9.38.0",
     "installed-check": "9.3.0",
-    "knip": "5.56.0",
-    "nitropack": "2.11.12",
-    "nuxt": "3.17.4",
-    "pkg-pr-new": "0.0.50",
-    "playwright-core": "1.52.0",
-    "rollup": "4.41.0",
-    "semver": "7.7.2",
-    "typescript": "5.8.3",
+    "knip": "5.66.2",
+    "nitropack": "2.12.7",
+    "nuxt": "4.1.3",
+    "pkg-pr-new": "0.0.60",
+    "playwright-core": "1.56.1",
+    "rollup": "4.52.5",
+    "semver": "7.7.3",
+    "typescript": "5.9.3",
     "unbuild": "latest",
-    "unimport": "5.0.1",
-    "vitest": "3.1.4",
-    "vue-router": "4.5.1",
-    "vue-tsc": "2.2.10"
+    "unimport": "5.5.0",
+    "vite": "7.1.11",
+    "vitest": "3.2.4",
+    "vue-router": "4.6.3",
+    "vue-tsc": "3.1.1"
   },
   "peerDependencies": {
-    "@cucumber/cucumber": "^10.3.1 || ^11.0.0",
-    "@jest/globals": "^29.5.0",
+    "@cucumber/cucumber": "^10.3.1 || >=11.0.0",
+    "@jest/globals": "^29.5.0 || >=30.0.0",
     "@playwright/test": "^1.43.1",
     "@testing-library/vue": "^7.0.0 || ^8.0.1",
     "@vue/test-utils": "^2.4.2",
-    "happy-dom": "^9.10.9 || ^10.0.0 || ^11.0.0 || ^12.0.0 || ^13.0.0 || ^14.0.0 || ^15.0.0 || ^16.0.0 || ^17.0.0",
-    "jsdom": "^22.0.0 || ^23.0.0 || ^24.0.0 || ^25.0.0 || ^26.0.0",
+    "happy-dom": "*",
+    "jsdom": "*",
     "playwright-core": "^1.43.1",
-    "vitest": "^0.34.6 || ^1.0.0 || ^2.0.0 || ^3.0.0"
+    "vitest": "^3.2.0"
   },
   "peerDependenciesMeta": {
     "@cucumber/cucumber": {
@@ -165,26 +169,31 @@
     }
   },
   "resolutions": {
-    "@cucumber/cucumber": "11.3.0",
-    "@nuxt/kit": "^3.17.4",
-    "@nuxt/schema": "^3.17.4",
+    "@cucumber/cucumber": "12.2.0",
+    "@nuxt/kit": "^4.1.3",
+    "@nuxt/schema": "4.1.3",
     "@nuxt/test-utils": "workspace:*",
-    "rollup": "4.41.0",
-    "vite": "^6.3.5",
-    "vite-node": "3.1.4",
-    "vitest": "3.1.4",
-    "vue": "^3.5.14"
+    "@types/node": "22.18.8",
+    "rollup": "4.52.5",
+    "vite": "7.1.11",
+    "vite-node": "3.2.4",
+    "vitest": "3.2.4",
+    "vue": "^3.5.22"
   },
   "engines": {
-    "node": "^18.20.5 || ^20.9.0 || ^22.0.0 || >=23.0.0"
+    "node": "^20.0.0 || ^22.0.0 || >=24.0.0"
   },
-  "packageManager": "pnpm@10.11.0",
+  "packageManager": "pnpm@10.18.3",
   "pnpm": {
     "onlyBuiltDependencies": [
+      "@tailwindcss/oxide",
       "better-sqlite3"
     ],
     "ignoredBuiltDependencies": [
-      "esbuild"
+      "esbuild",
+      "oxc-resolver",
+      "unrs-resolver",
+      "vue-demi"
     ]
   }
 }