@nuxt/test-utils 3.13.1 → 3.14.1

package/dist/config.d.mts

@@ -18,40 +18,46 @@ declare function getVitestConfigFromNuxt(options?: GetVitestConfigOptions, loadN
 declare function defineVitestConfig(config?: InlineConfig & {
     test?: InlineConfig$1;
 }): vite.UserConfig & Promise<vite.UserConfig> & (vite.UserConfigFnObject & vite.UserConfigExport);
+interface NuxtEnvironmentOptions {
+    rootDir?: string;
+    /**
+     * The starting URL for your Nuxt window environment
+     * @default {http://localhost:3000}
+     */
+    url?: string;
+    /**
+     * You can define how environment options are read when loading the Nuxt configuration.
+     */
+    dotenv?: Partial<DotenvOptions>;
+    /**
+     * Configuration that will override the values in your `nuxt.config` file.
+     */
+    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}
+     */
+    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}
+     */
+    domEnvironment?: 'happy-dom' | 'jsdom';
+    mock?: {
+        intersectionObserver?: boolean;
+        indexedDb?: boolean;
+    };
+}
+declare module 'vitest/node' {
+    interface EnvironmentOptions {
+        nuxt?: NuxtEnvironmentOptions;
+    }
+}
 declare module 'vitest' {
     interface EnvironmentOptions {
-        nuxt?: {
-            rootDir?: string;
-            /**
-             * The starting URL for your Nuxt window environment
-             * @default {http://localhost:3000}
-             */
-            url?: string;
-            /**
-             * You can define how environment options are read when loading the Nuxt configuration.
-             */
-            dotenv?: Partial<DotenvOptions>;
-            /**
-             * Configuration that will override the values in your `nuxt.config` file.
-             */
-            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}
-             */
-            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}
-             */
-            domEnvironment?: 'happy-dom' | 'jsdom';
-            mock?: {
-                intersectionObserver?: boolean;
-                indexedDb?: boolean;
-            };
-        };
+        nuxt?: NuxtEnvironmentOptions;
     }
 }
 

package/dist/config.d.ts

@@ -18,40 +18,46 @@ declare function getVitestConfigFromNuxt(options?: GetVitestConfigOptions, loadN
 declare function defineVitestConfig(config?: InlineConfig & {
     test?: InlineConfig$1;
 }): vite.UserConfig & Promise<vite.UserConfig> & (vite.UserConfigFnObject & vite.UserConfigExport);
+interface NuxtEnvironmentOptions {
+    rootDir?: string;
+    /**
+     * The starting URL for your Nuxt window environment
+     * @default {http://localhost:3000}
+     */
+    url?: string;
+    /**
+     * You can define how environment options are read when loading the Nuxt configuration.
+     */
+    dotenv?: Partial<DotenvOptions>;
+    /**
+     * Configuration that will override the values in your `nuxt.config` file.
+     */
+    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}
+     */
+    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}
+     */
+    domEnvironment?: 'happy-dom' | 'jsdom';
+    mock?: {
+        intersectionObserver?: boolean;
+        indexedDb?: boolean;
+    };
+}
+declare module 'vitest/node' {
+    interface EnvironmentOptions {
+        nuxt?: NuxtEnvironmentOptions;
+    }
+}
 declare module 'vitest' {
     interface EnvironmentOptions {
-        nuxt?: {
-            rootDir?: string;
-            /**
-             * The starting URL for your Nuxt window environment
-             * @default {http://localhost:3000}
-             */
-            url?: string;
-            /**
-             * You can define how environment options are read when loading the Nuxt configuration.
-             */
-            dotenv?: Partial<DotenvOptions>;
-            /**
-             * Configuration that will override the values in your `nuxt.config` file.
-             */
-            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}
-             */
-            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}
-             */
-            domEnvironment?: 'happy-dom' | 'jsdom';
-            mock?: {
-                intersectionObserver?: boolean;
-                indexedDb?: boolean;
-            };
-        };
+        nuxt?: NuxtEnvironmentOptions;
     }
 }
 

package/dist/config.mjs

@@ -44,6 +44,10 @@ async function startNuxtAndGetViteConfig(rootDir = process.cwd(), options = {})
       cwd: rootDir,
       fileName: ".env.test"
     }),
+    defaults: {
+      // suppress compatibility date warning for runtime environment tests
+      compatibilityDate: "2024-04-03"
+    },
     overrides: defu(
       {
         appId: "nuxt-app",

package/dist/e2e.d.mts

@@ -1,7 +1,6 @@
-import { T as TestOptions, a as TestContext, b as TestHooks } from './shared/test-utils.TBc-WRBw.mjs';
-export { G as GotoOptions, e as TestRunner, c as createBrowser, d as createPage, g as getBrowser, w as waitForHydration } from './shared/test-utils.TBc-WRBw.mjs';
+import { T as TestOptions, a as TestContext, b as TestHooks } from './shared/test-utils.CyoO8zI7.mjs';
+export { $ as $fetch, G as GotoOptions, 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.CyoO8zI7.mjs';
 import { LogType } from 'consola';
-import * as nitropack from 'nitropack';
 import 'playwright-core';
 import '@nuxt/schema';
 import 'execa';
@@ -20,15 +19,6 @@ declare function mockLogger(): Record<LogType, (...args: unknown[]) => void>;
 declare function loadFixture(): Promise<void>;
 declare function buildFixture(): Promise<void>;
 
-interface StartServerOptions {
-    env?: Record<string, unknown>;
-}
-declare function startServer(options?: StartServerOptions): Promise<void>;
-declare function stopServer(): Promise<void>;
-declare function fetch(path: string, options?: RequestInit): Promise<Response>;
-declare const $fetch: nitropack.$Fetch<unknown, nitropack.NitroFetchRequest>;
-declare function url(path: string): string;
-
 declare function setupCucumber(hooks: TestHooks): Promise<void>;
 
 declare function setupJest(hooks: TestHooks): Promise<void>;
@@ -52,4 +42,4 @@ interface RunTestOptions {
 }
 declare function runTests(opts: RunTestOptions): Promise<void>;
 
-export { $fetch, type RunTestOptions, type StartServerOptions, TestContext, TestHooks, TestOptions, buildFixture, createTest, createTestContext, exposeContextToEnv, fetch, isDev, loadFixture, mockFn, mockLogger, recoverContextFromEnv, runTests, setTestContext, setup, setupMaps, startServer, stopServer, url, useTestContext };
+export { type RunTestOptions, TestContext, TestHooks, TestOptions, buildFixture, createTest, createTestContext, exposeContextToEnv, isDev, loadFixture, mockFn, mockLogger, recoverContextFromEnv, runTests, setTestContext, setup, setupMaps, useTestContext };

package/dist/e2e.d.ts

@@ -1,7 +1,6 @@
-import { T as TestOptions, a as TestContext, b as TestHooks } from './shared/test-utils.TBc-WRBw.js';
-export { G as GotoOptions, e as TestRunner, c as createBrowser, d as createPage, g as getBrowser, w as waitForHydration } from './shared/test-utils.TBc-WRBw.js';
+import { T as TestOptions, a as TestContext, b as TestHooks } from './shared/test-utils.CyoO8zI7.js';
+export { $ as $fetch, G as GotoOptions, 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.CyoO8zI7.js';
 import { LogType } from 'consola';
-import * as nitropack from 'nitropack';
 import 'playwright-core';
 import '@nuxt/schema';
 import 'execa';
@@ -20,15 +19,6 @@ declare function mockLogger(): Record<LogType, (...args: unknown[]) => void>;
 declare function loadFixture(): Promise<void>;
 declare function buildFixture(): Promise<void>;
 
-interface StartServerOptions {
-    env?: Record<string, unknown>;
-}
-declare function startServer(options?: StartServerOptions): Promise<void>;
-declare function stopServer(): Promise<void>;
-declare function fetch(path: string, options?: RequestInit): Promise<Response>;
-declare const $fetch: nitropack.$Fetch<unknown, nitropack.NitroFetchRequest>;
-declare function url(path: string): string;
-
 declare function setupCucumber(hooks: TestHooks): Promise<void>;
 
 declare function setupJest(hooks: TestHooks): Promise<void>;
@@ -52,4 +42,4 @@ interface RunTestOptions {
 }
 declare function runTests(opts: RunTestOptions): Promise<void>;
 
-export { $fetch, type RunTestOptions, type StartServerOptions, TestContext, TestHooks, TestOptions, buildFixture, createTest, createTestContext, exposeContextToEnv, fetch, isDev, loadFixture, mockFn, mockLogger, recoverContextFromEnv, runTests, setTestContext, setup, setupMaps, startServer, stopServer, url, useTestContext };
+export { type RunTestOptions, TestContext, TestHooks, TestOptions, buildFixture, createTest, createTestContext, exposeContextToEnv, isDev, loadFixture, mockFn, mockLogger, recoverContextFromEnv, runTests, setTestContext, setup, setupMaps, useTestContext };

package/dist/e2e.mjs

@@ -1,7 +1,7 @@
-import { d as distDir } from './shared/test-utils.C7cWLW4C.mjs';
-export { b as buildFixture, c as createBrowser, a as createPage, e as createTest, g as getBrowser, l as loadFixture, f as setup, s as setupMaps, w as waitForHydration } from './shared/test-utils.C7cWLW4C.mjs';
-import { u as useTestContext } from './shared/test-utils.D8NWZeqn.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.D8NWZeqn.mjs';
+import { d as distDir } from './shared/test-utils.BZS9cHDP.mjs';
+export { b as buildFixture, c as createBrowser, a as createPage, e as createTest, g as getBrowser, l as loadFixture, f as setup, s as setupMaps, w as waitForHydration } from './shared/test-utils.BZS9cHDP.mjs';
+import { u as useTestContext } from './shared/test-utils.BumFEtZ8.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.BumFEtZ8.mjs';
 import { consola } from 'consola';
 import { resolve } from 'pathe';
 import 'node:fs';
@@ -12,6 +12,7 @@ import 'node:url';
 import 'execa';
 import 'get-port-please';
 import 'ofetch';
+import 'ufo';
 
 function mockFn() {
   const ctx = useTestContext();

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.D8NWZeqn.mjs';
+import { $ as $fetch, u as useTestContext } from './shared/test-utils.BumFEtZ8.mjs';
 import 'execa';
 import 'get-port-please';
 import 'ofetch';

package/dist/module.mjs

@@ -35,7 +35,7 @@ const createMockPlugin = (ctx) => createUnplugin(() => {
         ecmaVersion: "latest",
         ranges: true
       });
-    } catch (e) {
+    } catch {
       return;
     }
     let insertionPoint = 0;
@@ -316,7 +316,7 @@ const NuxtRootStubPlugin = createUnplugin((options) => {
   };
 });
 
-const vitePluginBlocklist = ["vite-plugin-vue-inspector", "vite-plugin-vue-inspector:post", "vite-plugin-inspect"];
+const vitePluginBlocklist = ["vite-plugin-vue-inspector", "vite-plugin-vue-inspector:post", "vite-plugin-inspect", "nuxt:type-check"];
 const module = defineNuxtModule({
   meta: {
     name: "@nuxt/test-utils",

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, b as TestHooks, G as GotoOptions } from './shared/test-utils.TBc-WRBw.mjs';
+import { T as TestOptions$1, b as TestHooks, G as GotoOptions } from './shared/test-utils.CyoO8zI7.mjs';
 import '@nuxt/schema';
 import 'execa';
 

package/dist/playwright.d.ts

@@ -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, b as TestHooks, G as GotoOptions } from './shared/test-utils.TBc-WRBw.js';
+import { T as TestOptions$1, b as TestHooks, G as GotoOptions } from './shared/test-utils.CyoO8zI7.js';
 import '@nuxt/schema';
 import 'execa';
 

package/dist/playwright.mjs

@@ -1,12 +1,13 @@
 import { test as test$1 } from '@playwright/test';
 export { expect } from '@playwright/test';
-import { e as createTest, w as waitForHydration } from './shared/test-utils.C7cWLW4C.mjs';
+import { e as createTest, w as waitForHydration } from './shared/test-utils.BZS9cHDP.mjs';
 import 'node:path';
 import 'defu';
+import 'ufo';
 import 'consola';
 import 'node:fs';
 import '@nuxt/kit';
-import { d as url } from './shared/test-utils.D8NWZeqn.mjs';
+import { d as url } from './shared/test-utils.BumFEtZ8.mjs';
 import 'pathe';
 import 'node:url';
 import 'execa';

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

@@ -82,7 +82,7 @@ declare function mockComponent<PropsOptions extends Readonly<ComponentPropsOptio
 type MountSuspendedOptions<T> = ComponentMountingOptions<T> & {
     route?: RouteLocationRaw;
 };
-type SetupState = Record<string, any>;
+type SetupState$1 = Record<string, any>;
 /**
  * `mountSuspended` allows you to mount any vue component within the Nuxt environment, allowing async setup and access to injections from your Nuxt plugins. For example:
  *
@@ -110,12 +110,13 @@ type SetupState = Record<string, any>;
  * @param options optional options to set up your component
  */
 declare function mountSuspended<T>(component: T, options?: MountSuspendedOptions<T>): Promise<ReturnType<typeof mount<T>> & {
-    setupState: SetupState;
+    setupState: SetupState$1;
 }>;
 
 type RenderOptions<C = unknown> = RenderOptions$1<C> & {
     route?: RouteLocationRaw;
 };
+type SetupState = Record<string, any>;
 /**
  * `renderSuspended` allows you to mount any vue component within the Nuxt environment, allowing async setup and access to injections from your Nuxt plugins.
  *
@@ -146,7 +147,9 @@ type RenderOptions<C = unknown> = RenderOptions$1<C> & {
  * @param component the component to be tested
  * @param options optional options to set up your component
  */
-declare function renderSuspended<T>(component: T, options?: RenderOptions<T>): Promise<_testing_library_vue.RenderResult>;
+declare function renderSuspended<T>(component: T, options?: RenderOptions<T>): Promise<_testing_library_vue.RenderResult & {
+    setupState: SetupState;
+}>;
 declare global {
     interface Window {
         __cleanup?: Array<() => void>;

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

@@ -82,7 +82,7 @@ declare function mockComponent<PropsOptions extends Readonly<ComponentPropsOptio
 type MountSuspendedOptions<T> = ComponentMountingOptions<T> & {
     route?: RouteLocationRaw;
 };
-type SetupState = Record<string, any>;
+type SetupState$1 = Record<string, any>;
 /**
  * `mountSuspended` allows you to mount any vue component within the Nuxt environment, allowing async setup and access to injections from your Nuxt plugins. For example:
  *
@@ -110,12 +110,13 @@ type SetupState = Record<string, any>;
  * @param options optional options to set up your component
  */
 declare function mountSuspended<T>(component: T, options?: MountSuspendedOptions<T>): Promise<ReturnType<typeof mount<T>> & {
-    setupState: SetupState;
+    setupState: SetupState$1;
 }>;
 
 type RenderOptions<C = unknown> = RenderOptions$1<C> & {
     route?: RouteLocationRaw;
 };
+type SetupState = Record<string, any>;
 /**
  * `renderSuspended` allows you to mount any vue component within the Nuxt environment, allowing async setup and access to injections from your Nuxt plugins.
  *
@@ -146,7 +147,9 @@ type RenderOptions<C = unknown> = RenderOptions$1<C> & {
  * @param component the component to be tested
  * @param options optional options to set up your component
  */
-declare function renderSuspended<T>(component: T, options?: RenderOptions<T>): Promise<_testing_library_vue.RenderResult>;
+declare function renderSuspended<T>(component: T, options?: RenderOptions<T>): Promise<_testing_library_vue.RenderResult & {
+    setupState: SetupState;
+}>;
 declare global {
     interface Window {
         __cleanup?: Array<() => void>;

package/dist/runtime-utils/index.mjs

@@ -1,7 +1,7 @@
 import { defineEventHandler } from 'h3';
 import { mount } from '@vue/test-utils';
 import { reactive, h as h$1, Suspense, nextTick, isReadonly, unref, effectScope } from 'vue';
-import { defu } from 'defu';
+import { createDefu, defu } from 'defu';
 import { defineComponent, useRouter, h, tryUseNuxtApp } from '#imports';
 import NuxtRoot from '#build/root-component.mjs';
 
@@ -133,7 +133,7 @@ async function mountSuspended(component, options) {
                     } : void 0,
                     setup: setup ? (props2) => wrappedSetup(props2, setupContext) : void 0
                   };
-                  return () => h$1(clonedComponent, { ...defu(setProps, props), ...attrs }, slots);
+                  return () => h$1(clonedComponent, { ...defuReplaceArray(setProps, props), ...attrs }, slots);
                 }
               })
             }
@@ -161,6 +161,12 @@ async function mountSuspended(component, options) {
     }
   );
 }
+const defuReplaceArray = createDefu((obj, key, value) => {
+  if (Array.isArray(obj[key])) {
+    obj[key] = value;
+    return true;
+  }
+});
 
 const WRAPPER_EL_ID = "test-wrapper";
 async function renderSuspended(component, options) {
@@ -174,11 +180,21 @@ async function renderSuspended(component, options) {
   const { render: renderFromTestingLibrary } = await import('@testing-library/vue');
   const vueApp = tryUseNuxtApp()?.vueApp || globalThis.__unctx__.get("nuxt-app").tryUse().vueApp;
   const { render, setup } = component;
+  let setupContext;
+  let setupState;
   for (const fn of window.__cleanup || []) {
     fn();
   }
   document.querySelector(`#${WRAPPER_EL_ID}`)?.remove();
-  let setupContext;
+  let passedProps;
+  const wrappedSetup = async (props2, setupContext2) => {
+    passedProps = props2;
+    if (setup) {
+      const result = await setup(props2, setupContext2);
+      setupState = result && typeof result === "object" ? result : {};
+      return result;
+    }
+  };
   return new Promise((resolve) => {
     const utils = renderFromTestingLibrary(
       {
@@ -191,8 +207,7 @@ async function renderSuspended(component, options) {
           });
           return scope.run(() => NuxtRoot.setup(props2, {
             ...ctx,
-            expose: () => {
-            }
+            expose: () => ({})
           }));
         },
         render: (renderContext) => (
@@ -204,16 +219,34 @@ async function renderSuspended(component, options) {
             { id: WRAPPER_EL_ID },
             h$1(
               Suspense,
-              { onResolve: () => nextTick().then(() => resolve(utils)) },
+              {
+                onResolve: () => nextTick().then(() => {
+                  utils.setupState = setupState;
+                  resolve(utils);
+                })
+              },
               {
                 default: () => h$1({
+                  name: "RenderHelper",
                   async setup() {
                     const router = useRouter();
                     await router.replace(route);
                     const clonedComponent = {
+                      name: "RenderSuspendedComponent",
                       ...component,
-                      render: render ? (_ctx, ...args) => render(renderContext, ...args) : void 0,
-                      setup: setup ? (props2) => setup(props2, setupContext) : void 0
+                      render: render ? function(_ctx, ...args) {
+                        for (const key in setupState || {}) {
+                          renderContext[key] = isReadonly(setupState[key]) ? unref(setupState[key]) : setupState[key];
+                        }
+                        for (const key in props || {}) {
+                          renderContext[key] = _ctx[key];
+                        }
+                        for (const key in passedProps || {}) {
+                          renderContext[key] = passedProps[key];
+                        }
+                        return render.call(this, renderContext, ...args);
+                      } : void 0,
+                      setup: setup ? (props2) => wrappedSetup(props2, setupContext) : void 0
                     };
                     return () => h$1(clonedComponent, { ...props && typeof props === "object" ? props : {}, ...attrs }, slots);
                   }

package/dist/shared/{test-utils.C7cWLW4C.mjs → test-utils.BZS9cHDP.mjs}

@@ -1,4 +1,4 @@
-import { u as useTestContext, d as url, c as createTestContext, s as setTestContext, b as stopServer, a as startServer } from './test-utils.D8NWZeqn.mjs';
+import { u as useTestContext, d as url, c as createTestContext, s as setTestContext, b as stopServer, a as startServer } from './test-utils.BumFEtZ8.mjs';
 import { existsSync, promises } from 'node:fs';
 import { resolve } from 'node:path';
 import { defu } from 'defu';
@@ -82,27 +82,29 @@ async function loadFixture() {
   ctx.options.rootDir = resolveRootDir();
   if (!ctx.options.dev) {
     const randomId = Math.random().toString(36).slice(2, 8);
-    const buildDir2 = ctx.options.buildDir || resolve(ctx.options.rootDir, ".nuxt", "test", randomId);
+    const buildDir = ctx.options.buildDir || resolve(ctx.options.rootDir, ".nuxt", "test", randomId);
     ctx.options.nuxtConfig = defu(ctx.options.nuxtConfig, {
-      buildDir: buildDir2,
+      buildDir,
       nitro: {
         output: {
-          dir: resolve(buildDir2, "output")
+          dir: resolve(buildDir, "output")
         }
       }
     });
   }
-  ctx.nuxt = await kit.loadNuxt({
-    cwd: ctx.options.rootDir,
-    dev: ctx.options.dev,
-    overrides: ctx.options.nuxtConfig,
-    configFile: ctx.options.configFile
-  });
-  const buildDir = ctx.nuxt.options.buildDir;
-  if (!existsSync(buildDir)) {
-    await promises.mkdir(buildDir, { recursive: true });
-    ctx.teardown = ctx.teardown || [];
-    ctx.teardown.push(() => promises.rm(buildDir, { recursive: true, force: true }));
+  if (ctx.options.build) {
+    ctx.nuxt = await kit.loadNuxt({
+      cwd: ctx.options.rootDir,
+      dev: ctx.options.dev,
+      overrides: ctx.options.nuxtConfig,
+      configFile: ctx.options.configFile
+    });
+    const buildDir = ctx.nuxt.options.buildDir;
+    if (!existsSync(buildDir)) {
+      await promises.mkdir(buildDir, { recursive: true });
+      ctx.teardown = ctx.teardown || [];
+      ctx.teardown.push(() => promises.rm(buildDir, { recursive: true, force: true }));
+    }
   }
 }
 async function buildFixture() {
@@ -174,7 +176,7 @@ function createTest(options) {
       await buildFixture();
     }
     if (ctx.options.server) {
-      await startServer();
+      await startServer(ctx.options.env);
     }
     if (ctx.options.waitFor) {
       await new Promise((resolve) => setTimeout(resolve, ctx.options.waitFor));

package/dist/shared/{test-utils.D8NWZeqn.mjs → test-utils.BumFEtZ8.mjs}

@@ -3,6 +3,7 @@ import { getRandomPort, waitForPort } from 'get-port-please';
 import { fetch as fetch$1, $fetch as $fetch$1 } from 'ofetch';
 import * as _kit from '@nuxt/kit';
 import { resolve as resolve$1 } from 'pathe';
+import { withTrailingSlash, joinURL } from 'ufo';
 import { resolve } from 'node:path';
 import { defu } from 'defu';
 
@@ -17,18 +18,26 @@ function createTestContext(options) {
     logLevel: 1,
     server: true,
     build: options.browser !== false || options.server !== false,
-    nuxtConfig: {},
+    nuxtConfig: {
+      // suppress compatibility date warning for runtime environment tests
+      compatibilityDate: "2024-04-03"
+    },
     browserOptions: {
       type: "chromium"
     }
   });
+  if (_options.host) {
+    _options.build = false;
+    _options.server = false;
+  }
   if (process.env.VITEST === "true") {
     _options.runner || (_options.runner = "vitest");
   } else if (process.env.JEST_WORKER_ID) {
     _options.runner || (_options.runner = "jest");
   }
   return setTestContext({
-    options: _options
+    options: _options,
+    url: withTrailingSlash(_options.host)
   });
 }
 function useTestContext() {
@@ -62,7 +71,7 @@ async function startServer(options = {}) {
   await stopServer();
   const host = "127.0.0.1";
   const port = ctx.options.port || await getRandomPort(host);
-  ctx.url = `http://${host}:${port}`;
+  ctx.url = `http://${host}:${port}/`;
   if (ctx.options.dev) {
     const nuxiCLI = await kit.resolvePath("nuxi/cli");
     ctx.serverProcess = execa(nuxiCLI, ["_dev"], {
@@ -75,7 +84,8 @@ async function startServer(options = {}) {
         PORT: String(port),
         HOST: host,
         NODE_ENV: "development",
-        ...options.env
+        ...options.env,
+        ...ctx.options.env
       }
     });
     await waitForPort(port, { retries: 32, host }).catch(() => {
@@ -104,7 +114,8 @@ async function startServer(options = {}) {
         PORT: String(port),
         HOST: host,
         NODE_ENV: "test",
-        ...options.env
+        ...options.env,
+        ...ctx.options.env
       }
     });
     await waitForPort(port, { retries: 20, host });
@@ -130,7 +141,7 @@ function url(path) {
   if (path.startsWith(ctx.url)) {
     return path;
   }
-  return ctx.url + path;
+  return joinURL(ctx.url, path);
 }
 
 export { $fetch as $, startServer as a, stopServer as b, createTestContext as c, url as d, exposeContextToEnv as e, fetch as f, isDev as i, recoverContextFromEnv as r, setTestContext as s, useTestContext as u };

package/dist/shared/test-utils.CyoO8zI7.d.mts

@@ -0,0 +1,109 @@
+import { Browser, BrowserContextOptions, Page, Response as Response$1, LaunchOptions } from 'playwright-core';
+import { NuxtConfig, Nuxt } from '@nuxt/schema';
+import { ExecaChildProcess } from 'execa';
+
+declare function createBrowser(): Promise<void>;
+declare function getBrowser(): Promise<Browser>;
+type _GotoOptions = NonNullable<Parameters<Page['goto']>[1]>;
+interface GotoOptions extends Omit<_GotoOptions, 'waitUntil'> {
+    waitUntil?: 'hydration' | 'route' | _GotoOptions['waitUntil'];
+}
+interface NuxtPage extends Omit<Page, 'goto'> {
+    goto: (url: string, options?: GotoOptions) => Promise<Response$1 | null>;
+}
+declare function createPage(path?: string, options?: BrowserContextOptions): Promise<NuxtPage>;
+declare function waitForHydration(page: Page, url: string, waitUntil?: GotoOptions['waitUntil']): Promise<void>;
+
+interface StartServerOptions {
+    env?: Record<string, unknown>;
+}
+declare function startServer(options?: StartServerOptions): Promise<void>;
+declare function stopServer(): Promise<void>;
+declare function fetch(path: string, options?: RequestInit): Promise<Response>;
+declare const $fetch: (typeof globalThis)["$fetch"];
+declare function url(path: string): string;
+
+type TestRunner = 'vitest' | 'jest' | 'cucumber';
+interface TestOptions {
+    testDir: string;
+    fixture: string;
+    /**
+     * Name of the configuration file.
+     * @default `'nuxt.config`
+     */
+    configFile: string;
+    /**
+     * Path to a directory with a Nuxt app to be put under test.
+     * @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)
+     */
+    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 `60000`
+     */
+    setupTimeout: 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`
+     */
+    browser: boolean;
+    /**
+     * Specify the runner for the test suite. One of `'vitest' | 'jest' | 'cucumber'`.
+     * @default `vitest`
+     */
+    runner: TestRunner;
+    logLevel: number;
+    browserOptions: {
+        /** The type of browser to launch - either `chromium`, `firefox` or `webkit` */
+        type: 'chromium' | 'firefox' | 'webkit';
+        /** `object` of options that will be passed to playwright when launching the browser. See [full API reference](https://playwright.dev/docs/api/class-browsertype#browser-type-launch). */
+        launch?: LaunchOptions;
+    };
+    /**
+     * Whether to launch a server to respond to requests in the test suite.
+     * @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`
+     */
+    host?: string;
+    /**
+     * If provided, set the launched test server port to the value.
+     * @default `undefined`
+     */
+    port?: number;
+    env?: StartServerOptions['env'];
+}
+interface TestContext {
+    options: TestOptions;
+    nuxt?: Nuxt;
+    browser?: Browser;
+    url?: string;
+    serverProcess?: ExecaChildProcess;
+    mockFn?: (...args: unknown[]) => unknown;
+    /**
+     * Functions to run on the vitest `afterAll` hook.
+     * Useful for removing anything created during the test.
+     */
+    teardown?: (() => void)[];
+}
+interface TestHooks {
+    beforeEach: () => void;
+    afterEach: () => void;
+    afterAll: () => Promise<void>;
+    setup: () => Promise<void>;
+    ctx: TestContext;
+}
+
+export { $fetch as $, type GotoOptions as G, type StartServerOptions as S, type TestOptions as T, type TestContext as a, type TestHooks as b, createBrowser as c, createPage as d, stopServer as e, fetch as f, getBrowser as g, type TestRunner as h, startServer as s, url as u, waitForHydration as w };

package/dist/shared/test-utils.CyoO8zI7.d.ts

@@ -0,0 +1,109 @@
+import { Browser, BrowserContextOptions, Page, Response as Response$1, LaunchOptions } from 'playwright-core';
+import { NuxtConfig, Nuxt } from '@nuxt/schema';
+import { ExecaChildProcess } from 'execa';
+
+declare function createBrowser(): Promise<void>;
+declare function getBrowser(): Promise<Browser>;
+type _GotoOptions = NonNullable<Parameters<Page['goto']>[1]>;
+interface GotoOptions extends Omit<_GotoOptions, 'waitUntil'> {
+    waitUntil?: 'hydration' | 'route' | _GotoOptions['waitUntil'];
+}
+interface NuxtPage extends Omit<Page, 'goto'> {
+    goto: (url: string, options?: GotoOptions) => Promise<Response$1 | null>;
+}
+declare function createPage(path?: string, options?: BrowserContextOptions): Promise<NuxtPage>;
+declare function waitForHydration(page: Page, url: string, waitUntil?: GotoOptions['waitUntil']): Promise<void>;
+
+interface StartServerOptions {
+    env?: Record<string, unknown>;
+}
+declare function startServer(options?: StartServerOptions): Promise<void>;
+declare function stopServer(): Promise<void>;
+declare function fetch(path: string, options?: RequestInit): Promise<Response>;
+declare const $fetch: (typeof globalThis)["$fetch"];
+declare function url(path: string): string;
+
+type TestRunner = 'vitest' | 'jest' | 'cucumber';
+interface TestOptions {
+    testDir: string;
+    fixture: string;
+    /**
+     * Name of the configuration file.
+     * @default `'nuxt.config`
+     */
+    configFile: string;
+    /**
+     * Path to a directory with a Nuxt app to be put under test.
+     * @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)
+     */
+    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 `60000`
+     */
+    setupTimeout: 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`
+     */
+    browser: boolean;
+    /**
+     * Specify the runner for the test suite. One of `'vitest' | 'jest' | 'cucumber'`.
+     * @default `vitest`
+     */
+    runner: TestRunner;
+    logLevel: number;
+    browserOptions: {
+        /** The type of browser to launch - either `chromium`, `firefox` or `webkit` */
+        type: 'chromium' | 'firefox' | 'webkit';
+        /** `object` of options that will be passed to playwright when launching the browser. See [full API reference](https://playwright.dev/docs/api/class-browsertype#browser-type-launch). */
+        launch?: LaunchOptions;
+    };
+    /**
+     * Whether to launch a server to respond to requests in the test suite.
+     * @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`
+     */
+    host?: string;
+    /**
+     * If provided, set the launched test server port to the value.
+     * @default `undefined`
+     */
+    port?: number;
+    env?: StartServerOptions['env'];
+}
+interface TestContext {
+    options: TestOptions;
+    nuxt?: Nuxt;
+    browser?: Browser;
+    url?: string;
+    serverProcess?: ExecaChildProcess;
+    mockFn?: (...args: unknown[]) => unknown;
+    /**
+     * Functions to run on the vitest `afterAll` hook.
+     * Useful for removing anything created during the test.
+     */
+    teardown?: (() => void)[];
+}
+interface TestHooks {
+    beforeEach: () => void;
+    afterEach: () => void;
+    afterAll: () => Promise<void>;
+    setup: () => Promise<void>;
+    ctx: TestContext;
+}
+
+export { $fetch as $, type GotoOptions as G, type StartServerOptions as S, type TestOptions as T, type TestContext as a, type TestHooks as b, createBrowser as c, createPage as d, stopServer as e, fetch as f, getBrowser as g, type TestRunner as h, startServer as s, url as u, waitForHydration as w };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nuxt/test-utils",
-  "version": "3.13.1",
+  "version": "3.14.1",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/nuxt/test-utils.git"
@@ -40,18 +40,18 @@
     "release": "pnpm prepack && pnpm test:examples && changelogen --release --push"
   },
   "dependencies": {
-    "@nuxt/kit": "^3.11.2",
-    "@nuxt/schema": "^3.11.2",
-    "c12": "^1.10.0",
+    "@nuxt/kit": "^3.12.4",
+    "@nuxt/schema": "^3.12.4",
+    "c12": "^1.11.1",
     "consola": "^3.2.3",
     "defu": "^6.1.4",
     "destr": "^2.0.3",
     "estree-walker": "^3.0.3",
     "execa": "^8.0.1",
-    "fake-indexeddb": "^5.0.2",
+    "fake-indexeddb": "^6.0.0",
     "get-port-please": "^3.1.2",
     "local-pkg": "^0.5.0",
-    "magic-string": "^0.30.10",
+    "magic-string": "^0.30.11",
     "node-fetch-native": "^1.6.4",
     "ofetch": "^1.3.4",
     "pathe": "^1.1.2",
@@ -59,46 +59,48 @@
     "radix3": "^1.1.2",
     "scule": "^1.3.0",
     "std-env": "^3.7.0",
-    "ufo": "^1.5.3",
-    "unenv": "^1.9.0",
-    "unplugin": "^1.10.1",
+    "ufo": "^1.5.4",
+    "unenv": "^1.10.0",
+    "unplugin": "^1.12.1",
     "vitest-environment-nuxt": "^1.0.0"
   },
   "devDependencies": {
-    "@cucumber/cucumber": "10.7.0",
+    "@cucumber/cucumber": "10.8.0",
     "@jest/globals": "29.7.0",
     "@nuxt/devtools": "1.0.8",
-    "@nuxt/eslint-config": "0.3.13",
-    "@nuxt/module-builder": "0.6.0",
-    "@playwright/test": "1.44.0",
+    "@nuxt/eslint-config": "0.5.0",
+    "@nuxt/module-builder": "0.8.2",
+    "@playwright/test": "1.46.0",
     "@testing-library/vue": "8.1.0",
     "@types/estree": "1.0.5",
-    "@types/jsdom": "21.1.6",
+    "@types/jsdom": "21.1.7",
     "@types/semver": "7.5.8",
-    "@vitest/ui": "1.6.0",
+    "@vitest/ui": "2.0.5",
     "@vue/test-utils": "2.4.6",
     "changelogen": "0.5.5",
-    "eslint": "9.3.0",
-    "h3": "1.11.1",
-    "jiti": "1.21.0",
-    "nitropack": "2.9.6",
-    "nuxt": "3.11.2",
-    "playwright-core": "1.44.0",
-    "rollup": "4.17.2",
-    "semver": "7.6.2",
+    "compatx": "0.1.8",
+    "eslint": "9.9.0",
+    "h3": "1.12.0",
+    "jiti": "1.21.6",
+    "nitropack": "2.9.7",
+    "nuxt": "3.12.4",
+    "playwright-core": "1.46.0",
+    "rollup": "4.20.0",
+    "semver": "7.6.3",
+    "typescript": "5.5.4",
     "unbuild": "latest",
-    "unimport": "3.7.1",
-    "vite": "5.2.11",
-    "vitest": "1.6.0",
-    "vue-router": "4.3.2",
-    "vue-tsc": "2.0.19"
+    "unimport": "3.10.0",
+    "vite": "5.4.0",
+    "vitest": "2.0.5",
+    "vue-router": "4.4.3",
+    "vue-tsc": "2.0.29"
   },
   "peerDependencies": {
     "@cucumber/cucumber": "^10.3.1",
     "@jest/globals": "^29.5.0",
     "@playwright/test": "^1.43.1",
     "@testing-library/vue": "^7.0.0 || ^8.0.1",
-    "@vitest/ui": "^0.34.6 || ^1.0.0",
+    "@vitest/ui": "^0.34.6 || ^1.0.0 || ^2.0.0",
     "@vue/test-utils": "^2.4.2",
     "h3": "*",
     "happy-dom": "^9.10.9 || ^10.0.0 || ^11.0.0 || ^12.0.0 || ^13.0.0 || ^14.0.0",
@@ -106,7 +108,7 @@
     "nitropack": "*",
     "playwright-core": "^1.43.1",
     "vite": "*",
-    "vitest": "^0.34.6 || ^1.0.0",
+    "vitest": "^0.34.6 || ^1.0.0 || ^2.0.0",
     "vue": "^3.3.4",
     "vue-router": "^4.0.0"
   },
@@ -143,21 +145,19 @@
     }
   },
   "resolutions": {
-    "@cucumber/cucumber": "10.7.0",
-    "@nuxt/kit": "^3.11.2",
-    "@nuxt/schema": "^3.11.2",
+    "@cucumber/cucumber": "10.8.0",
+    "@nuxt/devtools": "1.0.8",
+    "@nuxt/kit": "^3.12.4",
+    "@nuxt/schema": "^3.12.4",
     "@nuxt/test-utils": "workspace:*",
-    "rollup": "4.17.2",
-    "vite": "5.2.11",
-    "vue": "^3.4.27"
+    "rollup": "4.20.0",
+    "vite": "5.4.0",
+    "vite-node": "2.0.5",
+    "vitest": "2.0.5",
+    "vue": "^3.4.37"
   },
   "engines": {
-    "node": ">=18.20.2"
+    "node": ">=18.20.4"
   },
-  "packageManager": "pnpm@9.1.1",
-  "pnpm": {
-    "patchedDependencies": {
-      "nuxt@3.11.2": "patches/nuxt@3.11.2.patch"
-    }
-  }
+  "packageManager": "pnpm@9.7.0"
 }

package/dist/shared/test-utils.TBc-WRBw.d.mts

@@ -1,60 +0,0 @@
-import { Browser, BrowserContextOptions, Page, Response, LaunchOptions } from 'playwright-core';
-import { NuxtConfig, Nuxt } from '@nuxt/schema';
-import { ExecaChildProcess } from 'execa';
-
-declare function createBrowser(): Promise<void>;
-declare function getBrowser(): Promise<Browser>;
-type _GotoOptions = NonNullable<Parameters<Page['goto']>[1]>;
-interface GotoOptions extends Omit<_GotoOptions, 'waitUntil'> {
-    waitUntil?: 'hydration' | 'route' | _GotoOptions['waitUntil'];
-}
-interface NuxtPage extends Omit<Page, 'goto'> {
-    goto: (url: string, options?: GotoOptions) => Promise<Response | null>;
-}
-declare function createPage(path?: string, options?: BrowserContextOptions): Promise<NuxtPage>;
-declare function waitForHydration(page: Page, url: string, waitUntil?: GotoOptions['waitUntil']): Promise<void>;
-
-type TestRunner = 'vitest' | 'jest' | 'cucumber';
-interface TestOptions {
-    testDir: string;
-    fixture: string;
-    configFile: string;
-    rootDir: string;
-    buildDir: string;
-    nuxtConfig: NuxtConfig;
-    build: boolean;
-    dev: boolean;
-    setupTimeout: number;
-    waitFor: number;
-    browser: boolean;
-    runner: TestRunner;
-    logLevel: number;
-    browserOptions: {
-        type: 'chromium' | 'firefox' | 'webkit';
-        launch?: LaunchOptions;
-    };
-    server: boolean;
-    port?: number;
-}
-interface TestContext {
-    options: TestOptions;
-    nuxt?: Nuxt;
-    browser?: Browser;
-    url?: string;
-    serverProcess?: ExecaChildProcess;
-    mockFn?: (...args: unknown[]) => unknown;
-    /**
-     * Functions to run on the vitest `afterAll` hook.
-     * Useful for removing anything created during the test.
-     */
-    teardown?: (() => void)[];
-}
-interface TestHooks {
-    beforeEach: () => void;
-    afterEach: () => void;
-    afterAll: () => Promise<void>;
-    setup: () => Promise<void>;
-    ctx: TestContext;
-}
-
-export { type GotoOptions as G, type TestOptions as T, type TestContext as a, type TestHooks as b, createBrowser as c, createPage as d, type TestRunner as e, getBrowser as g, waitForHydration as w };

package/dist/shared/test-utils.TBc-WRBw.d.ts

@@ -1,60 +0,0 @@
-import { Browser, BrowserContextOptions, Page, Response, LaunchOptions } from 'playwright-core';
-import { NuxtConfig, Nuxt } from '@nuxt/schema';
-import { ExecaChildProcess } from 'execa';
-
-declare function createBrowser(): Promise<void>;
-declare function getBrowser(): Promise<Browser>;
-type _GotoOptions = NonNullable<Parameters<Page['goto']>[1]>;
-interface GotoOptions extends Omit<_GotoOptions, 'waitUntil'> {
-    waitUntil?: 'hydration' | 'route' | _GotoOptions['waitUntil'];
-}
-interface NuxtPage extends Omit<Page, 'goto'> {
-    goto: (url: string, options?: GotoOptions) => Promise<Response | null>;
-}
-declare function createPage(path?: string, options?: BrowserContextOptions): Promise<NuxtPage>;
-declare function waitForHydration(page: Page, url: string, waitUntil?: GotoOptions['waitUntil']): Promise<void>;
-
-type TestRunner = 'vitest' | 'jest' | 'cucumber';
-interface TestOptions {
-    testDir: string;
-    fixture: string;
-    configFile: string;
-    rootDir: string;
-    buildDir: string;
-    nuxtConfig: NuxtConfig;
-    build: boolean;
-    dev: boolean;
-    setupTimeout: number;
-    waitFor: number;
-    browser: boolean;
-    runner: TestRunner;
-    logLevel: number;
-    browserOptions: {
-        type: 'chromium' | 'firefox' | 'webkit';
-        launch?: LaunchOptions;
-    };
-    server: boolean;
-    port?: number;
-}
-interface TestContext {
-    options: TestOptions;
-    nuxt?: Nuxt;
-    browser?: Browser;
-    url?: string;
-    serverProcess?: ExecaChildProcess;
-    mockFn?: (...args: unknown[]) => unknown;
-    /**
-     * Functions to run on the vitest `afterAll` hook.
-     * Useful for removing anything created during the test.
-     */
-    teardown?: (() => void)[];
-}
-interface TestHooks {
-    beforeEach: () => void;
-    afterEach: () => void;
-    afterAll: () => Promise<void>;
-    setup: () => Promise<void>;
-    ctx: TestContext;
-}
-
-export { type GotoOptions as G, type TestOptions as T, type TestContext as a, type TestHooks as b, createBrowser as c, createPage as d, type TestRunner as e, getBrowser as g, waitForHydration as w };