@nuxt/test-utils 3.23.0 → 4.0.0

package/README.md

@@ -1,5 +1,8 @@
 # Nuxt Test Utils
 
+[![nuxt.care health](https://img.shields.io/endpoint?url=https://nuxt.care/api/badge/test-utils)](https://nuxt.care/?search=test-utils)
+
+
 🧪 [Nuxt](https://nuxt.com/) Test Utils
 
 ## Overview

package/dist/config.d.mts

@@ -57,11 +57,6 @@ declare module 'vitest/node' {
         nuxt?: NuxtEnvironmentOptions;
     }
 }
-declare module 'vitest' {
-    interface EnvironmentOptions {
-        nuxt?: NuxtEnvironmentOptions;
-    }
-}
 
 export { defineVitestConfig, defineVitestProject, getVitestConfigFromNuxt };
 export type { NuxtEnvironmentOptions };

package/dist/config.mjs

@@ -1,7 +1,7 @@
 import process from 'node:process';
 import { defineConfig } from 'vite';
 import { setupDotenv } from 'c12';
-import { defu } from 'defu';
+import { createDefu, defu } from 'defu';
 import { createResolver, findPath } from '@nuxt/kit';
 import { resolveModulePath } from 'exsolve';
 import { getPackageInfoSync } from 'local-pkg';
@@ -241,25 +241,29 @@ function defineVitestConfig(config = {}) {
     }
     const defaultEnvironment = resolvedConfig.test.environment || "node";
     if (defaultEnvironment !== "nuxt") {
-      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,
+      const merge = createDefu((obj, key, value) => {
+        if (Array.isArray(value) && Array.isArray(obj[key])) {
+          obj[key] = [.../* @__PURE__ */ new Set([...value, ...obj[key]])];
+          return true;
+        }
+      });
+      const nuxtProject = merge({
+        ...resolvedConfig,
         test: {
+          ...resolvedConfig.test,
           name: "nuxt",
           environment: "nuxt",
-          include: [
-            "**/*.nuxt.{test,spec}.{js,mjs,cjs,ts,mts,cts,jsx,tsx}",
-            "{test,tests}/nuxt/**.*"
-          ]
+          include: []
         }
-      });
-      resolvedConfig.test[key].push({
-        extends: true,
+      }, resolvedConfig);
+      nuxtProject.test.include = [
+        "**/*.nuxt.{test,spec}.{js,mjs,cjs,ts,mts,cts,jsx,tsx}",
+        "{test,tests}/nuxt/**.*"
+      ];
+      const defaultProject = merge({
+        ...resolvedConfig,
         test: {
+          ...resolvedConfig.test,
           name: defaultEnvironment,
           environment: defaultEnvironment,
           exclude: [
@@ -272,7 +276,10 @@ function defineVitestConfig(config = {}) {
             "./{test,tests}/nuxt/**.*"
           ]
         }
-      });
+      }, resolvedConfig);
+      resolvedConfig.test = {
+        projects: [nuxtProject, defaultProject]
+      };
     }
     return resolvedConfig;
   });

package/dist/e2e.d.mts

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

package/dist/e2e.mjs

@@ -1,4 +1,4 @@
-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.5cnw0YZR.mjs';
+export { b as buildFixture, c as createBrowser, a as createPage, d as createTest, g as getBrowser, l as loadFixture, s as setup, e as setupMaps, w as waitForHydration } from './shared/test-utils.E_cAGA8l.mjs';
 import { u as useTestContext } from './shared/test-utils.BsmyE2FA.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.BsmyE2FA.mjs';
 import { consola } from 'consola';

package/dist/module.d.mts

@@ -1,10 +1,10 @@
 import * as _nuxt_schema from '@nuxt/schema';
-import { UserConfig } from 'vitest/node';
+import { TestUserConfig } from 'vitest/config';
 
 interface NuxtVitestOptions {
     startOnBoot?: boolean;
     logToConsole?: boolean;
-    vitestConfig?: UserConfig;
+    vitestConfig?: TestUserConfig;
 }
 declare const _default: _nuxt_schema.NuxtModule<NuxtVitestOptions, NuxtVitestOptions, false>;
 

package/dist/module.mjs

@@ -1,4 +1,5 @@
-import { resolveIgnorePatterns, logger, useNuxt, addDevServerHandler, defineNuxtModule, createResolver, resolvePath } from '@nuxt/kit';
+import { resolveIgnorePatterns, logger, addDevServerHandler, useNuxt, defineNuxtModule, createResolver, resolvePath } from '@nuxt/kit';
+import { refreshCustomTabs, addCustomTab, onDevToolsInitialized } from '@nuxt/devtools-kit';
 import { extname, join, dirname, relative, resolve } from 'pathe';
 import { isCI, hasTTY, provider } from 'std-env';
 import { walk } from 'estree-walker';
@@ -13,7 +14,7 @@ import { detectPackageManager, addDependency } from 'nypm';
 import { h } from 'vue';
 import { debounce } from 'perfect-debounce';
 import { fork } from 'node:child_process';
-import { c as createVitestTestSummary, l as listenCliMessages, s as sendMessageToCli } from './shared/test-utils.DDUpsMYL.mjs';
+import { l as listenCliMessages, s as sendMessageToCli, c as createVitestTestSummary } from './shared/test-utils.DDUpsMYL.mjs';
 import { distDir } from '#dirs';
 import 'destr';
 import 'scule';
@@ -24,6 +25,7 @@ const PLUGIN_NAME$1 = "nuxt:vitest:mock-transform";
 const HELPER_MOCK_IMPORT = "mockNuxtImport";
 const HELPER_MOCK_COMPONENT = "mockComponent";
 const HELPER_MOCK_HOIST = "__NUXT_VITEST_MOCKS";
+const HELPER_MOCK_HOIST_ORIGINAL = "__NUXT_VITEST_MOCKS_ORIGINAL";
 const HELPERS_NAME = [HELPER_MOCK_IMPORT, HELPER_MOCK_COMPONENT];
 const createMockPlugin = (ctx) => createUnplugin(() => {
   function transform(code, id) {
@@ -150,25 +152,23 @@ const createMockPlugin = (ctx) => createUnplugin(() => {
         ...Array.from(mockImportMap.entries()).flatMap(
           ([from, mocks]) => {
             importPathsList.add(from);
+            const quotedFrom = JSON.stringify(from);
+            const mockModuleEntry = `globalThis.${HELPER_MOCK_HOIST}[${quotedFrom}]`;
             const lines = [
-              `vi.mock(${JSON.stringify(from)}, async (importOriginal) => {`,
-              `  const mocks = globalThis.${HELPER_MOCK_HOIST}`,
-              `  if (!mocks[${JSON.stringify(from)}]) {`,
-              `    mocks[${JSON.stringify(from)}] = { ...await importOriginal(${JSON.stringify(from)}) }`,
+              `vi.mock(${quotedFrom}, async (importOriginal) => {`,
+              `  if (!${mockModuleEntry}) {`,
+              `    const original = await importOriginal(${quotedFrom})`,
+              `    ${mockModuleEntry} = { ...original }`,
+              `    ${mockModuleEntry}.${HELPER_MOCK_HOIST_ORIGINAL} = { ...original }`,
               `  }`
             ];
             for (const mock of mocks) {
-              if (mock.import.name === "default") {
-                lines.push(
-                  `  mocks[${JSON.stringify(from)}]["default"] = await (${mock.factory})();`
-                );
-              } else {
-                lines.push(
-                  `  mocks[${JSON.stringify(from)}][${JSON.stringify(mock.name)}] = await (${mock.factory})();`
-                );
-              }
+              const quotedName = JSON.stringify(mock.import.name === "default" ? "default" : mock.name);
+              lines.push(
+                `  ${mockModuleEntry}[${quotedName}] = await (${mock.factory})(${mockModuleEntry}.${HELPER_MOCK_HOIST_ORIGINAL}[${quotedName}]);`
+              );
             }
-            lines.push(`  return mocks[${JSON.stringify(from)}] `);
+            lines.push(`  return ${mockModuleEntry} `);
             lines.push(`});`);
             return lines;
           }
@@ -768,17 +768,9 @@ async function updateGitignore(nuxt, answers) {
 async function setupDevTools(vitestWrapper, nuxt = useNuxt()) {
   const iframeSrc = "/__test_utils_vitest__/";
   const updateTabs = debounce(() => {
-    nuxt.callHook("devtools:customTabs:refresh");
+    refreshCustomTabs(nuxt);
   }, 100);
-  nuxt.hook("devtools:customTabs", (tabs) => {
-    const tab = createVitestCustomTab(vitestWrapper, { iframeSrc });
-    const index = tabs.findIndex(({ name }) => tab.name === name);
-    if (index === -1) {
-      tabs.push(tab);
-    } else {
-      tabs.splice(index, 1, tab);
-    }
-  });
+  addCustomTab(() => createVitestCustomTab(vitestWrapper, { iframeSrc }), nuxt);
   addDevServerHandler({
     route: iframeSrc,
     handler: Object.assign(() => iframeContentHtml(vitestWrapper.uiUrl), { __is_handler__: true })
@@ -961,7 +953,7 @@ function vitestWrapper(options) {
   };
 }
 
-const version = "3.23.0";
+const version = "4.0.0";
 const pkg = {
 	version: version};
 
@@ -1007,9 +999,9 @@ const module$1 = defineNuxtModule({
     if (!nuxt.options.dev) return;
     if (process.env.TEST || process.env.VITE_TEST) return;
     const vitestWrapper2 = createVitestWrapper(options, nuxt);
-    nuxt.hook("devtools:before", async () => {
+    onDevToolsInitialized(async () => {
       await setupDevTools(vitestWrapper2, nuxt);
-    });
+    }, nuxt);
     if (options.startOnBoot) {
       vitestWrapper2.start();
     }

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, a as TestHooks } from './shared/test-utils.C9GKP_T5.mjs';
+import { T as TestOptions$1, G as GotoOptions, a as TestHooks } from './shared/test-utils.BLyxqr96.mjs';
 import '@nuxt/schema';
 import 'tinyexec';
 import 'ofetch';

package/dist/playwright.mjs

@@ -1,10 +1,10 @@
 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.5cnw0YZR.mjs';
+import { isWindows } from 'std-env';
+import { w as waitForHydration, d as createTest } from './shared/test-utils.E_cAGA8l.mjs';
 import 'node:path';
 import 'ufo';
-import 'std-env';
 import 'consola';
 import 'node:fs';
 import 'destr';
@@ -19,6 +19,7 @@ import 'tinyexec';
 import 'get-port-please';
 import 'ofetch';
 
+const FIXTURE_TIMEOUT = isWindows ? 12e4 : 6e4;
 const test = test$1.extend({
   nuxt: [void 0, { option: true, scope: "worker" }],
   defaults: [{ nuxt: void 0 }, { option: true, scope: "worker" }],
@@ -29,7 +30,7 @@ const test = test$1.extend({
       await use(hooks);
       await hooks.afterAll();
     },
-    { scope: "worker" }
+    { scope: "worker", timeout: FIXTURE_TIMEOUT }
   ],
   baseURL: async ({ _nuxtHooks }, use) => {
     _nuxtHooks.beforeEach();

package/dist/runtime/browser-entry.mjs

@@ -1,8 +1,5 @@
 import environmentOptions from "nuxt-vitest-environment-options";
 import { setupNuxt } from "./shared/nuxt.mjs";
 import { setupWindow } from "./shared/environment.mjs";
-const el = document.querySelector(environmentOptions.nuxt.rootId || "nuxt-test");
-if (!el) {
-  await setupWindow(window, environmentOptions);
-  await setupNuxt();
-}
+await setupWindow(window, environmentOptions);
+await setupNuxt();

package/dist/runtime/entry.mjs

@@ -1,7 +1,8 @@
-import { vi } from "vitest";
+import { beforeAll } from "vitest";
 import { setupNuxt } from "./shared/nuxt.mjs";
 if (typeof window !== "undefined" && window.__NUXT_VITEST_ENVIRONMENT__) {
-  await setupNuxt();
-  vi.resetModules();
+  beforeAll(async () => {
+    await setupNuxt();
+  });
 }
 export {};

package/dist/runtime/shared/environment.mjs

@@ -16,16 +16,6 @@ export async function setupWindow(win, environmentOptions) {
     data: {},
     state: {}
   };
-  const rootId = environmentOptions.nuxt.rootId || "nuxt-test";
-  let el;
-  try {
-    el = win.document.querySelector(rootId);
-  } catch {
-  }
-  if (el) {
-    return () => {
-    };
-  }
   const consoleInfo = console.info;
   console.info = (...args) => {
     if (args[0] === "<Suspense> is an experimental feature and its API will likely change.") {
@@ -34,7 +24,7 @@ export async function setupWindow(win, environmentOptions) {
     return consoleInfo(...args);
   };
   const app = win.document.createElement("div");
-  app.id = rootId;
+  app.id = environmentOptions.nuxt.rootId || "nuxt-test";
   win.document.body.appendChild(app);
   if (!win.fetch || !("Request" in win)) {
     await import("node-fetch-native/polyfill");

package/dist/runtime/shared/vue-wrapper-plugin.mjs

@@ -1,7 +1,7 @@
 import { config } from "@vue/test-utils";
 const PLUGIN_NAME = "nuxt-test-utils";
 export function getVueWrapperPlugin() {
-  const installed = config.plugins.VueWrapper.installedPlugins.find(({ options: options2 }) => options2._name === PLUGIN_NAME);
+  const installed = config.plugins.VueWrapper.installedPlugins.find(({ options: options2 }) => options2?._name === PLUGIN_NAME);
   if (installed) return installed.options;
   const options = createPluginOptions();
   config.plugins.VueWrapper.install((instance, options2) => {

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

@@ -58,7 +58,7 @@ declare function registerEndpoint(url: string, options: EventHandler | {
  * ```
  * @see https://nuxt.com/docs/getting-started/testing#mocknuxtimport
  */
-declare function mockNuxtImport<T = unknown>(_target: string | T, _factory: () => T | Promise<T>): void;
+declare function mockNuxtImport<T = unknown>(_target: string | T, _factory: (original: T) => T | Promise<T>): void;
 /**
  * `mockComponent` allows you to mock Nuxt's component.
  * @param path - component name in PascalCase, or the relative path of the component.

package/dist/runtime-utils/index.mjs

@@ -1,17 +1,32 @@
 import { mount } from '@vue/test-utils';
-import { reactive, h as h$1, Suspense, nextTick as nextTick$1, getCurrentInstance, onErrorCaptured, effectScope } from 'vue';
+import { reactive, h as h$1, Suspense, nextTick, getCurrentInstance, onErrorCaptured, effectScope } from 'vue';
 import { defu } from 'defu';
 import { defineComponent, useRouter, h, tryUseNuxtApp } from '#imports';
 import NuxtRoot from '#build/root-component.mjs';
 
-const endpointRegistry = {};
+function getEndpointRegistry() {
+  const app = window.__app ?? {};
+  return app._registeredEndpointRegistry ||= {};
+}
+function findEndpointRegistryHandlers(url) {
+  const endpointRegistry = getEndpointRegistry();
+  const pathname = url.replace(/[?#].*$/, "");
+  for (const [key, handlers] of Object.entries(endpointRegistry)) {
+    if (key === url || key === pathname) {
+      if (handlers?.length) {
+        return handlers;
+      }
+    }
+  }
+}
 function registerEndpoint(url, options) {
   const app = window.__app;
   if (!app) {
     throw new Error("registerEndpoint() can only be used in a `@nuxt/test-utils` runtime environment");
   }
-  const config = typeof options === "function" ? { handler: options, method: void 0, once: false } : options;
+  const config = typeof options === "function" ? { url, handler: options, method: void 0, once: false } : { ...options, url };
   config.handler = Object.assign(config.handler, { __is_handler__: true });
+  const endpointRegistry = getEndpointRegistry();
   endpointRegistry[url] ||= [];
   endpointRegistry[url].push(config);
   window.__registry.add(url);
@@ -34,16 +49,17 @@ function mockComponent(_path, _component) {
   );
 }
 const handler = Object.assign(async (event) => {
-  const url = "url" in event && event.url ? event.url.pathname.replace(/^\/_/, "") : event.path.replace(/[?#].*$/, "").replace(/^\/_/, "");
-  const latestHandler = [...endpointRegistry[url] || []].reverse().find((config) => config.method ? event.method === config.method : true);
+  const url = "url" in event && event.url ? (event.url.pathname + event.url.search).replace(/^\/_/, "") : event.path.replace(/^\/_/, "");
+  const registeredHandlers = findEndpointRegistryHandlers(url);
+  const latestHandler = [...registeredHandlers || []].reverse().find((config) => config.method ? event.method === config.method : true);
   if (!latestHandler) return;
   const result = await latestHandler.handler(event);
   if (!latestHandler.once) return result;
-  const index = endpointRegistry[url]?.indexOf(latestHandler);
+  const index = registeredHandlers?.indexOf(latestHandler);
   if (index === void 0 || index === -1) return result;
-  endpointRegistry[url]?.splice(index, 1);
-  if (endpointRegistry[url]?.length === 0) {
-    window.__registry.delete(url);
+  registeredHandlers?.splice(index, 1);
+  if (registeredHandlers?.length === 0) {
+    window.__registry.delete(latestHandler.url);
   }
   return result;
 }, { __is_handler__: true });
@@ -51,9 +67,10 @@ function registerGlobalHandler(app) {
   app.use(handler, {
     match: (...args) => {
       const [eventOrPath, _event = eventOrPath] = args;
-      const url = typeof eventOrPath === "string" ? eventOrPath.replace(/^\/_/, "").replace(/[?#].*$/, "") : eventOrPath.url.pathname.replace(/^\/_/, "");
+      const url = typeof eventOrPath === "string" ? eventOrPath.replace(/^\/_/, "") : (eventOrPath.url.pathname + eventOrPath.url.search).replace(/^\/_/, "");
       const event = _event;
-      return endpointRegistry[url]?.some((config) => config.method ? event?.method === config.method : true) ?? false;
+      const registeredHandlers = findEndpointRegistryHandlers(url);
+      return registeredHandlers?.some((config) => config.method ? event?.method === config.method : true) ?? false;
     }
   });
   return true;
@@ -197,7 +214,7 @@ function wrapperSuspended(component, options, {
         render: wrappedRender(() => h$1(
           Suspense,
           {
-            onResolve: () => nextTick$1().then(() => {
+            onResolve: () => nextTick().then(() => {
               if (isMountSettled) return;
               isMountSettled = true;
               wrapper.setupState = setupState;

package/dist/shared/{test-utils.C9GKP_T5.d.mts → test-utils.BLyxqr96.d.mts}

@@ -1,4 +1,4 @@
-import { Browser, Page, Response as Response$1, BrowserContextOptions, LaunchOptions } from 'playwright-core';
+import { Page, Response as Response$1, BrowserContextOptions, Browser, LaunchOptions } from 'playwright-core';
 import { NuxtConfig, Nuxt } from '@nuxt/schema';
 import { exec } from 'tinyexec';
 import { $Fetch } from 'ofetch';
@@ -116,5 +116,5 @@ interface TestHooks {
     ctx: TestContext;
 }
 
-export { $fetch as $, createBrowser as c, createPage as d, stopServer as e, fetch as f, getBrowser as g, startServer as s, url as u, waitForHydration as w };
-export type { GotoOptions as G, NuxtPage as N, StartServerOptions as S, TestOptions as T, TestHooks as a, TestContext as b, TestRunner as h };
+export { $fetch as $, createBrowser as d, createPage as e, fetch as f, getBrowser as g, stopServer as h, startServer as s, url as u, waitForHydration as w };
+export type { GotoOptions as G, NuxtPage as N, StartServerOptions as S, TestOptions as T, TestHooks as a, TestContext as b, TestRunner as c };

package/dist/shared/{test-utils.5cnw0YZR.mjs → test-utils.E_cAGA8l.mjs}

@@ -117,10 +117,10 @@ async function buildFixture() {
 async function setupBun(hooks) {
   const bunTest = await import('bun:test');
   hooks.ctx.mockFn = bunTest.mock;
-  bunTest.beforeAll(hooks.beforeAll);
+  bunTest.beforeAll(hooks.beforeAll, hooks.ctx.options.setupTimeout);
   bunTest.beforeEach(hooks.beforeEach);
   bunTest.afterEach(hooks.afterEach);
-  bunTest.afterAll(hooks.afterAll);
+  bunTest.afterAll(hooks.afterAll, hooks.ctx.options.teardownTimeout);
 }
 
 async function setupCucumber(hooks) {
@@ -209,4 +209,4 @@ async function setup(options = {}) {
   await setupFn(hooks);
 }
 
-export { createPage as a, buildFixture as b, createBrowser as c, createTest as d, setup as e, getBrowser as g, loadFixture as l, setupMaps as s, waitForHydration as w };
+export { createPage as a, buildFixture as b, createBrowser as c, createTest as d, setupMaps as e, getBrowser as g, loadFixture as l, setup as s, waitForHydration as w };

package/dist/vitest-environment.d.mts

@@ -2,7 +2,7 @@ import { Environment } from 'vitest/environments';
 import { H3Event as H3Event$1 } from 'h3';
 import { H3Event } from 'h3-next';
 import { $Fetch } from 'nitropack';
-import { JSDOMOptions, HappyDOMOptions } from 'vitest/node';
+import { EnvironmentOptions } from 'vitest/node';
 
 declare const _default: Environment;
 
@@ -29,8 +29,8 @@ interface NuxtWindow extends Window {
     Headers: typeof Headers;
 }
 interface EnvironmentNuxtOptions {
-    jsdom?: JSDOMOptions;
-    happyDom?: HappyDOMOptions;
+    jsdom?: EnvironmentOptions['jsdom'];
+    happyDom?: EnvironmentOptions['happyDOM'];
 }
 type EnvironmentNuxt = (global: typeof globalThis, options: EnvironmentNuxtOptions) => Promise<{
     window: NuxtWindow;

package/dist/vitest-environment.mjs

@@ -128,16 +128,6 @@ async function setupWindow(win, environmentOptions) {
     data: {},
     state: {}
   };
-  const rootId = environmentOptions.nuxt.rootId || "nuxt-test";
-  let el;
-  try {
-    el = win.document.querySelector(rootId);
-  } catch {
-  }
-  if (el) {
-    return () => {
-    };
-  }
   const consoleInfo = console.info;
   console.info = (...args) => {
     if (args[0] === "<Suspense> is an experimental feature and its API will likely change.") {
@@ -146,7 +136,7 @@ async function setupWindow(win, environmentOptions) {
     return consoleInfo(...args);
   };
   const app = win.document.createElement("div");
-  app.id = rootId;
+  app.id = environmentOptions.nuxt.rootId || "nuxt-test";
   win.document.body.appendChild(app);
   if (!win.fetch || !("Request" in win)) {
     await import('node-fetch-native/polyfill');
@@ -247,22 +237,22 @@ const environmentMap = {
 };
 const index = {
   name: "nuxt",
-  transformMode: "web",
+  viteEnvironment: "client",
   async setup(global, environmentOptions) {
     const url = joinURL(
-      environmentOptions?.nuxt.url ?? "http://localhost:3000",
-      environmentOptions?.nuxtRuntimeConfig.app?.baseURL || "/"
+      environmentOptions.nuxt?.url ?? "http://localhost:3000",
+      environmentOptions.nuxtRuntimeConfig?.app?.baseURL || "/"
     );
-    const environmentName = environmentOptions.nuxt.domEnvironment;
+    const environmentName = environmentOptions.nuxt?.domEnvironment;
     const environment = environmentMap[environmentName] || environmentMap["happy-dom"];
     const { window: win, teardown } = await environment(global, defu(environmentOptions, {
       happyDom: { url },
       jsdom: { url }
     }));
-    if (environmentOptions?.nuxt?.mock?.intersectionObserver) {
+    if (environmentOptions.nuxt?.mock?.intersectionObserver) {
       win.IntersectionObserver ||= IntersectionObserver;
     }
-    if (environmentOptions?.nuxt?.mock?.indexedDb) {
+    if (environmentOptions.nuxt?.mock?.indexedDb) {
       win.indexedDB = indexedDB;
     }
     const teardownWindow = await setupWindow(win, environmentOptions);

package/dist/vitest-wrapper/cli.mjs

@@ -32,10 +32,16 @@ function createCustomReporter(onVitestInit) {
     onTestRunStart() {
       sendMessageToHost("updated", toUpdatedResult());
     },
-    onTaskUpdate() {
+    onTestModuleCollected() {
       sendMessageToHost("updated", toUpdatedResult());
     },
-    onFinished() {
+    onTestCaseResult() {
+      sendMessageToHost("updated", toUpdatedResult());
+    },
+    onTestModuleEnd() {
+      sendMessageToHost("updated", toUpdatedResult());
+    },
+    onTestRunEnd() {
       sendMessageToHost("finished", toFinishedResult());
     }
   };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nuxt/test-utils",
-  "version": "3.23.0",
+  "version": "4.0.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/nuxt/test-utils.git"
@@ -57,7 +57,7 @@
     "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' --filter '!example-app-bun' -r test && pnpm --filter example-app-cucumber -r test",
+    "test:examples": "pnpm --filter '!@nuxt/test-utils' --filter '!example-app-cucumber' --filter '!example-app-jest' --filter '!example-app-bun' -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",
@@ -67,8 +67,9 @@
     "dev:prepare": "nuxt prepare && unbuild --stub && pnpm -r dev:prepare"
   },
   "dependencies": {
-    "@clack/prompts": "1.0.0-alpha.9",
-    "@nuxt/kit": "^3.20.2",
+    "@clack/prompts": "1.0.0",
+    "@nuxt/devtools-kit": "^2.7.0",
+    "@nuxt/kit": "^3.21.0",
     "c12": "^3.3.3",
     "consola": "^3.4.2",
     "defu": "^6.1.4",
@@ -77,70 +78,69 @@
     "exsolve": "^1.0.8",
     "fake-indexeddb": "^6.2.5",
     "get-port-please": "^3.2.0",
-    "h3": "^1.15.4",
-    "h3-next": "npm:h3@^2.0.1-rc.7",
+    "h3": "^1.15.5",
+    "h3-next": "npm:h3@2.0.1-rc.11",
     "local-pkg": "^1.1.2",
     "magic-string": "^0.30.21",
     "node-fetch-native": "^1.6.7",
     "node-mock-http": "^1.0.4",
-    "nypm": "^0.6.2",
+    "nypm": "^0.6.4",
     "ofetch": "^1.5.1",
     "pathe": "^2.0.3",
-    "perfect-debounce": "^2.0.0",
+    "perfect-debounce": "^2.1.0",
     "radix3": "^1.1.2",
     "scule": "^1.3.0",
     "std-env": "^3.10.0",
     "tinyexec": "^1.0.2",
-    "ufo": "^1.6.1",
-    "unplugin": "^2.3.11",
+    "ufo": "^1.6.3",
+    "unplugin": "^3.0.0",
     "vitest-environment-nuxt": "^1.0.1",
-    "vue": "^3.5.26"
+    "vue": "^3.5.27"
   },
   "devDependencies": {
-    "@cucumber/cucumber": "12.5.0",
+    "@cucumber/cucumber": "12.6.0",
     "@jest/globals": "30.2.0",
-    "@nuxt/devtools-kit": "2.7.0",
-    "@nuxt/eslint-config": "1.12.1",
-    "@nuxt/schema": "4.2.2",
-    "@playwright/test": "1.57.0",
+    "@nuxt/eslint-config": "1.13.0",
+    "@nuxt/schema": "4.3.0",
+    "@playwright/test": "1.58.1",
     "@testing-library/vue": "8.1.0",
-    "@types/bun": "1.3.5",
+    "@types/bun": "1.3.8",
     "@types/estree": "1.0.8",
     "@types/jsdom": "27.0.0",
     "@types/node": "latest",
     "@types/semver": "7.7.1",
-    "@vitest/browser-playwright": "4.0.16",
+    "@vitest/browser-playwright": "4.0.18",
     "@vue/test-utils": "2.4.6",
     "changelogen": "0.6.2",
     "compatx": "0.2.0",
     "eslint": "9.39.2",
     "installed-check": "9.3.0",
-    "knip": "5.80.0",
-    "nitropack": "2.12.9",
-    "nuxt": "4.2.2",
-    "oxc-parser": "^0.107.0",
-    "pkg-pr-new": "0.0.62",
-    "playwright-core": "1.57.0",
-    "rollup": "4.55.1",
+    "knip": "5.83.0",
+    "nitropack": "2.13.1",
+    "nuxt": "4.3.0",
+    "oxc-parser": "0.112.0",
+    "pkg-pr-new": "0.0.63",
+    "playwright-core": "1.58.1",
+    "rollup": "4.57.1",
     "semver": "7.7.3",
     "typescript": "5.9.3",
     "unbuild": "latest",
     "unimport": "5.6.0",
-    "vite": "7.3.0",
-    "vitest": "3.2.4",
-    "vue-router": "4.6.4",
-    "vue-tsc": "3.2.2"
+    "vite": "7.3.1",
+    "vitest": "4.0.18",
+    "vue-router": "5.0.2",
+    "vue-tsc": "3.2.4"
   },
   "peerDependencies": {
-    "@cucumber/cucumber": "^10.3.1 || >=11.0.0",
-    "@jest/globals": "^29.5.0 || >=30.0.0",
+    "@cucumber/cucumber": ">=11.0.0",
+    "@jest/globals": ">=30.0.0",
     "@playwright/test": "^1.43.1",
-    "@testing-library/vue": "^7.0.0 || ^8.0.1",
+    "@testing-library/vue": "^8.0.1",
     "@vue/test-utils": "^2.4.2",
-    "happy-dom": "*",
-    "jsdom": "*",
+    "happy-dom": ">=20.0.11",
+    "jsdom": ">=27.4.0",
     "playwright-core": "^1.43.1",
-    "vitest": "^3.2.0"
+    "vitest": "^4.0.2"
   },
   "peerDependenciesMeta": {
     "@cucumber/cucumber": {
@@ -175,19 +175,19 @@
     }
   },
   "resolutions": {
-    "@cucumber/cucumber": "12.5.0",
-    "@nuxt/schema": "4.2.2",
+    "@cucumber/cucumber": "12.6.0",
+    "@nuxt/schema": "4.3.0",
     "@nuxt/test-utils": "workspace:*",
-    "@types/node": "24.10.4",
+    "@types/node": "24.10.9",
     "nitro": "https://pkg.pr.new/nitrojs/nitro@00598a8",
-    "rollup": "4.55.1",
-    "vite": "7.3.0",
-    "vite-node": "5.2.0",
-    "vitest": "3.2.4",
-    "vue": "^3.5.26"
+    "rollup": "4.57.1",
+    "vite": "7.3.1",
+    "vite-node": "5.3.0",
+    "vitest": "4.0.18",
+    "vue": "^3.5.27"
   },
   "engines": {
-    "node": "^20.11.1 || ^22.0.0 || >=24.0.0"
+    "node": "^20.19.0 || ^22.12.0 || >=24.0.0"
   },
-  "packageManager": "pnpm@10.27.0"
+  "packageManager": "pnpm@10.28.2"
 }