@vitest/utils 4.0.14 → 4.0.16

package/dist/display.d.ts

@@ -21,8 +21,9 @@ interface StringifyOptions extends PrettyFormatOptions {
 declare function stringify(object: unknown, maxDepth?: number, { maxLength, ...options }?: StringifyOptions): string;
 declare const formatRegExp: RegExp;
 declare function format(...args: unknown[]): string;
+declare function browserFormat(...args: unknown[]): string;
 declare function inspect(obj: unknown, options?: LoupeOptions): string;
 declare function objDisplay(obj: unknown, options?: LoupeOptions): string;
 
-export { format, formatRegExp, inspect, objDisplay, stringify };
+export { browserFormat, format, formatRegExp, inspect, objDisplay, stringify };
 export type { LoupeOptions, StringifyOptions };

package/dist/display.js

@@ -609,11 +609,20 @@ function stringify(object, maxDepth = 10, { maxLength, ...options } = {}) {
 	}) : result;
 }
 const formatRegExp = /%[sdjifoOc%]/g;
-function format(...args) {
+function baseFormat(args, options = {}) {
+	const formatArg = (item, inspecOptions) => {
+		if (options.prettifyObject) {
+			return stringify(item, undefined, {
+				printBasicPrototype: false,
+				escapeString: false
+			});
+		}
+		return inspect(item, inspecOptions);
+	};
 	if (typeof args[0] !== "string") {
 		const objects = [];
 		for (let i = 0; i < args.length; i++) {
-			objects.push(inspect(args[i], {
+			objects.push(formatArg(args[i], {
 				depth: 0,
 				colors: false
 			}));
@@ -643,7 +652,7 @@ function format(...args) {
 					if (typeof value.toString === "function" && value.toString !== Object.prototype.toString) {
 						return value.toString();
 					}
-					return inspect(value, {
+					return formatArg(value, {
 						depth: 0,
 						colors: false
 					});
@@ -665,11 +674,11 @@ function format(...args) {
 				return Number.parseInt(String(value)).toString();
 			}
 			case "%f": return Number.parseFloat(String(args[i++])).toString();
-			case "%o": return inspect(args[i++], {
+			case "%o": return formatArg(args[i++], {
 				showHidden: true,
 				showProxy: true
 			});
-			case "%O": return inspect(args[i++]);
+			case "%O": return formatArg(args[i++]);
 			case "%c": {
 				i++;
 				return "";
@@ -690,11 +699,17 @@ function format(...args) {
 		if (x === null || typeof x !== "object") {
 			str += ` ${x}`;
 		} else {
-			str += ` ${inspect(x)}`;
+			str += ` ${formatArg(x)}`;
 		}
 	}
 	return str;
 }
+function format(...args) {
+	return baseFormat(args);
+}
+function browserFormat(...args) {
+	return baseFormat(args, { prettifyObject: true });
+}
 function inspect(obj, options = {}) {
 	if (options.truncate === 0) {
 		options.truncate = Number.POSITIVE_INFINITY;
@@ -724,4 +739,4 @@ function objDisplay(obj, options = {}) {
 	return str;
 }
 
-export { format, formatRegExp, inspect, objDisplay, stringify };
+export { browserFormat, format, formatRegExp, inspect, objDisplay, stringify };

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.14",
+  "version": "4.0.16",
   "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.14"
+    "@vitest/pretty-format": "4.0.16"
   },
   "devDependencies": {
     "@jridgewell/trace-mapping": "0.3.31",