@nuxt/test-utils-nightly 3.21.0-20251029-131418-f2d3def → 3.21.0-20251030-161832-4f04851

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

@@ -7,9 +7,33 @@ import { RenderOptions as RenderOptions$1 } from '@testing-library/vue';
 
 type Awaitable<T> = T | Promise<T>;
 type OptionalFunction<T> = T | (() => Awaitable<T>);
+/**
+ * `registerEndpoint` allows you create Nitro endpoint that returns mocked data. It can come in handy if you want to test a component that makes requests to API to display some data.
+ * @param url - endpoint name (e.g. `/test/`).
+ * @param options - factory function that returns the mocked data or an object containing the `handler`, `method`, and `once` properties.
+ * - `handler`: the event handler function
+ * - `method`: (optional) HTTP method to match (e.g., 'GET', 'POST')
+ * - `once`: (optional) if true, the handler will only be used for the first matching request and then automatically removed
+ * @example
+ * ```ts
+ * import { registerEndpoint } from '@nuxt/test-utils/runtime'
+ *
+ * registerEndpoint("/test/", () => ({
+ *  test: "test-field"
+ * }))
+ *
+ * // With once option
+ * registerEndpoint("/api/user", {
+ *   handler: () => ({ name: "Alice" }),
+ *   once: true
+ * })
+ * ```
+ * @see https://nuxt.com/docs/getting-started/testing#registerendpoint
+ */
 declare function registerEndpoint(url: string, options: EventHandler | {
     handler: EventHandler;
-    method: HTTPMethod;
+    method?: HTTPMethod;
+    once?: boolean;
 }): () => void;
 /**
  * `mockNuxtImport` allows you to mock Nuxt's auto import functionality.

package/dist/runtime-utils/index.mjs

@@ -11,16 +11,25 @@ function registerEndpoint(url, options) {
   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 } : options;
+  const config = typeof options === "function" ? { handler: options, method: void 0, once: false } : options;
   config.handler = defineEventHandler(config.handler);
   const hasBeenRegistered = window.__registry.has(url);
   endpointRegistry[url] ||= [];
   endpointRegistry[url].push(config);
   if (!hasBeenRegistered) {
     window.__registry.add(url);
-    app.use("/_" + url, defineEventHandler((event) => {
+    app.use("/_" + url, defineEventHandler(async (event) => {
       const latestHandler = [...endpointRegistry[url] || []].reverse().find((config2) => config2.method ? event.method === config2.method : true);
-      return latestHandler?.handler(event);
+      if (!latestHandler) return;
+      const result = await latestHandler.handler(event);
+      if (!latestHandler.once) return result;
+      const index = endpointRegistry[url]?.indexOf(latestHandler);
+      if (index === void 0 || index === -1) return result;
+      endpointRegistry[url]?.splice(index, 1);
+      if (endpointRegistry[url]?.length === 0) {
+        window.__registry.delete(url);
+      }
+      return result;
     }), {
       match(_, event) {
         return endpointRegistry[url]?.some((config2) => config2.method ? event?.method === config2.method : true) ?? false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nuxt/test-utils-nightly",
-  "version": "3.21.0-20251029-131418-f2d3def",
+  "version": "3.21.0-20251030-161832-4f04851",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/nuxt/test-utils.git"
@@ -183,17 +183,5 @@
   "engines": {
     "node": "^20.0.0 || ^22.0.0 || >=24.0.0"
   },
-  "packageManager": "pnpm@10.19.0",
-  "pnpm": {
-    "onlyBuiltDependencies": [
-      "@tailwindcss/oxide",
-      "better-sqlite3"
-    ],
-    "ignoredBuiltDependencies": [
-      "esbuild",
-      "oxc-resolver",
-      "unrs-resolver",
-      "vue-demi"
-    ]
-  }
+  "packageManager": "pnpm@10.19.0"
 }