@nuxt/test-utils-nightly 4.0.0-1699284628.89ffa77 → 4.0.0-1702810232.fba662c

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016-present - Nuxt Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,18 @@
+# Nuxt Test Utils
+
+🧪 [Nuxt](https://nuxt.com/) Test Utils
+
+## Overview
+
+Nuxt offers first-class support for e2e and unit testing of your Nuxt applications.
+
+Nuxt Test Utils is currently powering [the tests we use on Nuxt itself](https://github.com/nuxt/nuxt/tree/main/test), as well as tests used throughout the module ecosystem.
+
+You can find out more about how to use Nuxt Test Utils:
+
+- in [a general overview](https://nuxt.com/docs/getting-started/testing)
+- in [an in-depth guide for module authors](https://nuxt.com/docs/guide/going-further/modules/#testing)
+
+## License
+
+[MIT](./LICENSE)

package/config.d.ts

@@ -0,0 +1 @@
+export * from './dist/config'

package/dist/config.d.mts

@@ -0,0 +1,46 @@
+import * as vite from 'vite';
+import { InlineConfig } from 'vite';
+import { NuxtConfig, Nuxt } from '@nuxt/schema';
+import { InlineConfig as InlineConfig$1 } from 'vitest';
+
+interface GetVitestConfigOptions {
+    nuxt: Nuxt;
+    viteConfig: InlineConfig;
+}
+declare function getVitestConfigFromNuxt(options?: GetVitestConfigOptions, overrides?: NuxtConfig): Promise<InlineConfig & {
+    test: InlineConfig$1;
+}>;
+declare function defineVitestConfig(config?: InlineConfig & {
+    test?: InlineConfig$1;
+}): vite.UserConfig & Promise<vite.UserConfig> & vite.UserConfigFnObject & vite.UserConfigExport;
+declare module 'vitest' {
+    interface EnvironmentOptions {
+        nuxt?: {
+            rootDir?: string;
+            /**
+             * The starting URL for your Nuxt window environment
+             * @default {http://localhost:3000}
+             */
+            url?: string;
+            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;
+            };
+        };
+    }
+}
+
+export { defineVitestConfig, getVitestConfigFromNuxt };

package/dist/config.d.ts

@@ -0,0 +1,46 @@
+import * as vite from 'vite';
+import { InlineConfig } from 'vite';
+import { NuxtConfig, Nuxt } from '@nuxt/schema';
+import { InlineConfig as InlineConfig$1 } from 'vitest';
+
+interface GetVitestConfigOptions {
+    nuxt: Nuxt;
+    viteConfig: InlineConfig;
+}
+declare function getVitestConfigFromNuxt(options?: GetVitestConfigOptions, overrides?: NuxtConfig): Promise<InlineConfig & {
+    test: InlineConfig$1;
+}>;
+declare function defineVitestConfig(config?: InlineConfig & {
+    test?: InlineConfig$1;
+}): vite.UserConfig & Promise<vite.UserConfig> & vite.UserConfigFnObject & vite.UserConfigExport;
+declare module 'vitest' {
+    interface EnvironmentOptions {
+        nuxt?: {
+            rootDir?: string;
+            /**
+             * The starting URL for your Nuxt window environment
+             * @default {http://localhost:3000}
+             */
+            url?: string;
+            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;
+            };
+        };
+    }
+}
+
+export { defineVitestConfig, getVitestConfigFromNuxt };

package/dist/config.mjs

@@ -0,0 +1,156 @@
+import { defineConfig } from 'vite';
+import { defu } from 'defu';
+import { createResolver } from '@nuxt/kit';
+
+async function startNuxtAndGetViteConfig(rootDir = process.cwd(), overrides) {
+  const { loadNuxt, buildNuxt } = await import('@nuxt/kit');
+  const nuxt = await loadNuxt({
+    cwd: rootDir,
+    dev: false,
+    overrides: defu(
+      {
+        ssr: false,
+        test: true,
+        modules: ["@nuxt/test-utils/module"]
+      },
+      overrides
+    )
+  });
+  if (!nuxt.options._installedModules.find((i) => i?.meta?.name === "@nuxt/test-utils")) {
+    throw new Error(
+      "Failed to load `@nuxt/test-utils/module`. You may need to add it to your nuxt.config."
+    );
+  }
+  const promise = new Promise((resolve, reject) => {
+    nuxt.hook("vite:configResolved", (viteConfig, { isClient }) => {
+      if (isClient) {
+        resolve({ nuxt, viteConfig });
+        throw new Error("_stop_");
+      }
+    });
+    buildNuxt(nuxt).catch((err) => {
+      if (!err.toString().includes("_stop_")) {
+        reject(err);
+      }
+    });
+  }).finally(() => nuxt.close());
+  return promise;
+}
+const excludedPlugins = [
+  "nuxt:import-protection",
+  "vite-plugin-checker"
+];
+async function getVitestConfigFromNuxt(options, overrides) {
+  const { rootDir = process.cwd(), ..._overrides } = overrides || {};
+  if (!options) {
+    options = await startNuxtAndGetViteConfig(rootDir, {
+      test: true,
+      ..._overrides
+    });
+  }
+  options.viteConfig.plugins = (options.viteConfig.plugins || []).filter((p) => !excludedPlugins.includes(p?.name));
+  const resolvedConfig = defu(
+    // overrides
+    {
+      define: {
+        ["process.env.NODE_ENV"]: "process.env.NODE_ENV"
+      },
+      test: {
+        dir: process.cwd(),
+        environmentOptions: {
+          nuxtRuntimeConfig: options.nuxt.options.runtimeConfig,
+          nuxtRouteRules: defu(
+            {},
+            options.nuxt.options.routeRules,
+            options.nuxt.options.nitro?.routeRules
+          )
+        },
+        environmentMatchGlobs: [
+          ["**/*.nuxt.{test,spec}.{js,mjs,cjs,ts,mts,cts,jsx,tsx}", "nuxt"],
+          ["{test,tests}/nuxt/**.*", "nuxt"]
+        ],
+        server: {
+          deps: {
+            inline: [
+              // vite-node defaults
+              /\/node_modules\/(.*\/)?(nuxt|nuxt3|nuxt-nightly)\//,
+              /^#/,
+              // additional deps
+              "@nuxt/test-utils",
+              "@nuxt/test-utils-nightly",
+              "@nuxt/test-utils-edge",
+              "vitest-environment-nuxt",
+              ...options.nuxt.options.build.transpile.filter(
+                (r) => typeof r === "string" || r instanceof RegExp
+              )
+            ]
+          }
+        },
+        deps: {
+          optimizer: {
+            web: {
+              enabled: false
+            }
+          }
+        }
+      }
+    },
+    {
+      server: { middlewareMode: false },
+      plugins: [
+        {
+          name: "disable-auto-execute",
+          enforce: "pre",
+          transform(code, id) {
+            if (id.match(/nuxt(3|-nightly)?\/.*\/entry\./)) {
+              return code.replace(
+                /(?<!vueAppPromise = )entry\(\)\.catch/,
+                "Promise.resolve().catch"
+              );
+            }
+          }
+        }
+      ]
+    },
+    // resolved vite config
+    options.viteConfig,
+    // (overrideable) defaults
+    {
+      test: {
+        environmentOptions: {
+          nuxt: {
+            rootId: options.nuxt.options.app.rootId || void 0,
+            mock: {
+              intersectionObserver: true,
+              indexedDb: false
+            }
+          }
+        }
+      }
+    }
+  );
+  delete resolvedConfig.define["process.browser"];
+  if (!Array.isArray(resolvedConfig.test.setupFiles)) {
+    resolvedConfig.test.setupFiles = [resolvedConfig.test.setupFiles].filter(Boolean);
+  }
+  const resolver = createResolver(import.meta.url);
+  resolvedConfig.test.setupFiles.unshift(resolver.resolve("./runtime/entry"));
+  return resolvedConfig;
+}
+function defineVitestConfig(config = {}) {
+  return defineConfig(async () => {
+    if (process.env.__NUXT_VITEST_RESOLVED__)
+      return config;
+    const overrides = config.test?.environmentOptions?.nuxt?.overrides || {};
+    overrides.rootDir = config.test?.environmentOptions?.nuxt?.rootDir;
+    if (config.test?.setupFiles && !Array.isArray(config.test.setupFiles)) {
+      config.test.setupFiles = [config.test.setupFiles].filter(Boolean);
+    }
+    return defu(
+      config,
+      await getVitestConfigFromNuxt(void 0, structuredClone(overrides))
+    );
+  });
+}
+
+export { defineVitestConfig, getVitestConfigFromNuxt };

package/dist/{index.d.mts → e2e.d.mts}

@@ -37,6 +37,11 @@ interface TestContext {
     url?: string;
     serverProcess?: ExecaChildProcess;
     mockFn?: Function;
+    /**
+     * Functions to run on the vitest `afterAll` hook.
+     * Useful for removing anything created during the test.
+     */
+    teardown?: (() => void)[];
 }
 interface TestHooks {
     beforeEach: () => void;

package/dist/{index.d.ts → e2e.d.ts}

@@ -37,6 +37,11 @@ interface TestContext {
     url?: string;
     serverProcess?: ExecaChildProcess;
     mockFn?: Function;
+    /**
+     * Functions to run on the vitest `afterAll` hook.
+     * Useful for removing anything created during the test.
+     */
+    teardown?: (() => void)[];
 }
 interface TestHooks {
     beforeEach: () => void;

package/dist/{index.mjs → e2e.mjs}

@@ -1,7 +1,7 @@
-import { u as useTestContext, a as url, c as createTestContext, s as setTestContext, b as stopServer, d as startServer } from './shared/test-utils-nightly.8f432eb9.mjs';
-export { $ as $fetch, e as exposeContextToEnv, f as fetch, i as isDev, r as recoverContextFromEnv } from './shared/test-utils-nightly.8f432eb9.mjs';
+import { u as useTestContext, a as url, c as createTestContext, s as setTestContext, b as stopServer, d as startServer } from './shared/test-utils-nightly.ddf5bsCK.mjs';
+export { $ as $fetch, e as exposeContextToEnv, f as fetch, i as isDev, r as recoverContextFromEnv } from './shared/test-utils-nightly.ddf5bsCK.mjs';
 import { consola } from 'consola';
-import { promises, existsSync } from 'node:fs';
+import { existsSync, promises } from 'node:fs';
 import { resolve } from 'node:path';
 import { defu } from 'defu';
 import * as _kit from '@nuxt/kit';
@@ -15,7 +15,10 @@ async function createBrowser() {
   const ctx = useTestContext();
   let playwright;
   try {
-    playwright = await import(String("playwright-core"));
+    playwright = await import(
+      /* vite-ignore */
+      'playwright-core'
+    );
   } catch {
     throw new Error(`
       The dependency 'playwright-core' not found.
@@ -80,12 +83,12 @@ async function loadFixture() {
   ctx.options.rootDir = resolveRootDir();
   if (!ctx.options.dev) {
     const randomId = Math.random().toString(36).slice(2, 8);
-    const buildDir = resolve(ctx.options.rootDir, ".nuxt", randomId);
+    const buildDir2 = ctx.options.buildDir || resolve(ctx.options.rootDir, ".nuxt", "test", randomId);
     ctx.options.nuxtConfig = defu(ctx.options.nuxtConfig, {
-      buildDir,
+      buildDir: buildDir2,
       nitro: {
         output: {
-          dir: resolve(buildDir, "output")
+          dir: resolve(buildDir2, "output")
         }
       }
     });
@@ -96,7 +99,12 @@ async function loadFixture() {
     overrides: ctx.options.nuxtConfig,
     configFile: ctx.options.configFile
   });
-  await promises.mkdir(ctx.nuxt.options.buildDir, { recursive: true });
+  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() {
   const ctx = useTestContext();
@@ -148,6 +156,7 @@ function createTest(options) {
     if (ctx.browser) {
       await ctx.browser.close();
     }
+    await Promise.all((ctx.teardown || []).map((fn) => fn()));
   };
   const setup2 = async () => {
     if (ctx.options.fixture) {
@@ -218,6 +227,7 @@ async function runTests(opts) {
           inline: [
             distDir,
             "@nuxt/test-utils",
+            "@nuxt/test-utils-nightly",
             "@nuxt/test-utils-edge"
           ]
         },

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

package/dist/module.d.mts

@@ -0,0 +1,11 @@
+import * as _nuxt_schema from '@nuxt/schema';
+import { UserConfig } from 'vitest';
+
+interface NuxtVitestOptions {
+    startOnBoot?: boolean;
+    logToConsole?: boolean;
+    vitestConfig?: UserConfig;
+}
+declare const _default: _nuxt_schema.NuxtModule<NuxtVitestOptions>;
+
+export { type NuxtVitestOptions, _default as default };

package/dist/module.d.ts

@@ -0,0 +1,11 @@
+import * as _nuxt_schema from '@nuxt/schema';
+import { UserConfig } from 'vitest';
+
+interface NuxtVitestOptions {
+    startOnBoot?: boolean;
+    logToConsole?: boolean;
+    vitestConfig?: UserConfig;
+}
+declare const _default: _nuxt_schema.NuxtModule<NuxtVitestOptions>;
+
+export { type NuxtVitestOptions, _default as default };