@vitest/utils 4.0.13 → 4.0.15

package/dist/timers.d.ts

@@ -13,6 +13,21 @@ interface SafeTimers {
 }
 declare function getSafeTimers(): SafeTimers;
 declare function setSafeTimers(): void;
+/**
+* Returns a promise that resolves after the specified duration.
+*
+* @param timeout - Delay in milliseconds
+* @param scheduler - Timer function to use, defaults to `setTimeout`. Useful for mocked timers.
+*
+* @example
+* await delay(100)
+*
+* @example
+* // With mocked timers
+* const { setTimeout } = getSafeTimers()
+* await delay(100, setTimeout)
+*/
+declare function delay(timeout: number, scheduler?: typeof setTimeout): Promise<void>;
 
-export { getSafeTimers, setSafeTimers };
+export { delay, getSafeTimers, setSafeTimers };
 export type { SafeTimers };

package/dist/timers.js

@@ -28,5 +28,22 @@ function setSafeTimers() {
 	};
 	globalThis[SAFE_TIMERS_SYMBOL] = timers;
 }
+/**
+* Returns a promise that resolves after the specified duration.
+*
+* @param timeout - Delay in milliseconds
+* @param scheduler - Timer function to use, defaults to `setTimeout`. Useful for mocked timers.
+*
+* @example
+* await delay(100)
+*
+* @example
+* // With mocked timers
+* const { setTimeout } = getSafeTimers()
+* await delay(100, setTimeout)
+*/
+function delay(timeout, scheduler = setTimeout) {
+	return new Promise((resolve) => scheduler(resolve, timeout));
+}
 
-export { getSafeTimers, setSafeTimers };
+export { delay, getSafeTimers, setSafeTimers };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vitest/utils",
   "type": "module",
-  "version": "4.0.13",
+  "version": "4.0.15",
   "description": "Shared Vitest utility functions",
   "license": "MIT",
   "funding": "https://opencollective.com/vitest",
@@ -82,7 +82,7 @@
   ],
   "dependencies": {
     "tinyrainbow": "^3.0.3",
-    "@vitest/pretty-format": "4.0.13"
+    "@vitest/pretty-format": "4.0.15"
   },
   "devDependencies": {
     "@jridgewell/trace-mapping": "0.3.31",