vitest 4.1.0-beta.1 → 4.1.0-beta.2

package/dist/chunks/{reporters.d.Db3MiIWX.d.ts → reporters.d.7faYdkxy.d.ts}

@@ -1,16 +1,16 @@
-import { TaskMeta, Suite, File, SerializableRetry, TestAnnotation, TestArtifact, ImportDuration, Test, Task, TaskResultPack, FileSpecification, CancelReason, SequenceSetupFiles, SequenceHooks } from '@vitest/runner';
+import { TaskMeta, Suite, File, SerializableRetry, TestAnnotation, TestArtifact, ImportDuration, Test, Task, TaskResultPack, FileSpecification, CancelReason, SequenceSetupFiles, SequenceHooks, TestTagDefinition } from '@vitest/runner';
 import { TestError, SerializedError, Arrayable, ParsedStack, Awaitable } from '@vitest/utils';
-import { A as AfterSuiteRunMeta, U as UserConsoleLog, P as ProvidedContext, L as LabelColor } from './rpc.d.RH3apGEf.js';
+import { A as AfterSuiteRunMeta, U as UserConsoleLog, P as ProvidedContext, L as LabelColor } from './rpc.d.CM7x9-sm.js';
 import { Writable } from 'node:stream';
 import { DevEnvironment, TransformResult as TransformResult$1, ViteDevServer, Plugin, UserConfig as UserConfig$1, DepOptimizationConfig, ServerOptions, ConfigEnv, AliasOptions } from 'vite';
-import { S as SerializedTestSpecification, c as SourceModuleDiagnostic, B as BrowserTesterOptions } from './browser.d.8hOapKZr.js';
-import { B as BrowserTraceViewMode, S as SerializedConfig, F as FakeTimerInstallOpts } from './config.d.idH22YSr.js';
+import { S as SerializedTestSpecification, c as SourceModuleDiagnostic, B as BrowserTesterOptions } from './browser.d.BE4kbYok.js';
+import { B as BrowserTraceViewMode, S as SerializedConfig, F as FakeTimerInstallOpts } from './config.d.Cr1Ep39N.js';
 import { PrettyFormatOptions } from '@vitest/pretty-format';
 import { SnapshotSummary, SnapshotStateOptions } from '@vitest/snapshot';
 import { SerializedDiffOptions } from '@vitest/utils/diff';
 import { chai } from '@vitest/expect';
 import { happyDomTypes, jsdomTypes } from 'vitest/optional-types.js';
-import { c as ContextTestEnvironment, d as WorkerExecuteContext, e as WorkerTestEnvironment } from './worker.d.Bji1eq5g.js';
+import { c as ContextTestEnvironment, d as WorkerExecuteContext, e as WorkerTestEnvironment } from './worker.d.CPzI2ZzJ.js';
 import { O as OTELCarrier } from './traces.d.402V_yFI.js';
 import { B as BenchmarkResult } from './benchmark.d.DAaHLpsq.js';
 import { MockedModule } from '@vitest/mocker';
@@ -72,6 +72,53 @@ interface ConstructorOptionsOverride {
 	resources?: "usable";
 }
 
+interface TestSpecificationOptions {
+	testNamePattern?: RegExp;
+	testIds?: string[];
+	testLines?: number[];
+	testTagsFilter?: string[];
+}
+declare class TestSpecification {
+	/**
+	* The task id associated with the test module.
+	*/
+	readonly taskId: string;
+	/**
+	* The test project that the module belongs to.
+	*/
+	readonly project: TestProject;
+	/**
+	* The id of the module in the Vite module graph. It is usually an absolute file path.
+	*/
+	readonly moduleId: string;
+	/**
+	* The current test pool. It's possible to have multiple pools in a single test project with `typecheck.enabled`.
+	* @experimental In later versions, the project will only support a single pool.
+	*/
+	readonly pool: Pool;
+	/**
+	* Line numbers of the test locations to run.
+	*/
+	readonly testLines: number[] | undefined;
+	/**
+	* Regular expression pattern to filter test names.
+	*/
+	readonly testNamePattern: RegExp | undefined;
+	/**
+	* The ids of tasks inside of this specification to run.
+	*/
+	readonly testIds: string[] | undefined;
+	/**
+	* The tags of tests to run.
+	*/
+	readonly testTagsFilter: string[] | undefined;
+	/**
+	* Test module associated with the specification. This will be `undefined` if tests have not been run yet.
+	*/
+	get testModule(): TestModule | undefined;
+	toJSON(): SerializedTestSpecification;
+}
+
 declare class ReportedTaskImplementation {
 	/**
 	* The project associated with the test or suite.
@@ -120,6 +167,10 @@ declare class TestCase extends ReportedTaskImplementation {
 	*/
 	readonly parent: TestSuite | TestModule;
 	/**
+	* Tags associated with the test.
+	*/
+	readonly tags: string[];
+	/**
 	* Full name of the test including all parent suites separated with `>`.
 	*/
 	get fullName(): string;
@@ -146,6 +197,10 @@ declare class TestCase extends ReportedTaskImplementation {
 	* Diagnostic is only available after the test has finished.
 	*/
 	diagnostic(): TestDiagnostic | undefined;
+	/**
+	* Returns a new test specification that can be used to filter or run this specific test case.
+	*/
+	toTestSpecification(): TestSpecification;
 }
 declare class TestCollection {
 	#private;
@@ -231,6 +286,10 @@ declare class TestSuite extends SuiteImplementation {
 	*/
 	state(): TestSuiteState;
 	/**
+	* Returns a new test specification that can be used to filter or run this specific test suite.
+	*/
+	toTestSpecification(): TestSpecification;
+	/**
 	* Full name of the suite including all parent suites separated with `>`.
 	*/
 	get fullName(): string;
@@ -255,6 +314,10 @@ declare class TestModule extends SuiteImplementation {
 	*/
 	readonly relativeModuleId: string;
 	/**
+	* Returns a new test specification that can be used to filter or run this specific test module.
+	*/
+	toTestSpecification(): TestSpecification;
+	/**
 	* Checks the running state of the test file.
 	*/
 	state(): TestModuleState;
@@ -280,6 +343,11 @@ interface TaskOptions {
 	readonly shuffle: boolean | undefined;
 	readonly retry: SerializableRetry | undefined;
 	readonly repeats: number | undefined;
+	readonly tags: string[] | undefined;
+	/**
+	* Only tests have a `timeout` option.
+	*/
+	readonly timeout: number | undefined;
 	readonly mode: "run" | "only" | "skip" | "todo";
 }
 type TestSuiteState = "skipped" | "pending" | "failed" | "passed";
@@ -402,48 +470,6 @@ declare function experimental_getRunnerTask(entity: TestSuite): Suite;
 declare function experimental_getRunnerTask(entity: TestModule): File;
 declare function experimental_getRunnerTask(entity: TestCase | TestSuite | TestModule): Suite | File | Test;
 
-interface TestSpecificationOptions {
-	testNamePattern?: RegExp;
-	testIds?: string[];
-	testLines?: number[];
-}
-declare class TestSpecification {
-	/**
-	* The task id associated with the test module.
-	*/
-	readonly taskId: string;
-	/**
-	* The test project that the module belongs to.
-	*/
-	readonly project: TestProject;
-	/**
-	* The id of the module in the Vite module graph. It is usually an absolute file path.
-	*/
-	readonly moduleId: string;
-	/**
-	* The current test pool. It's possible to have multiple pools in a single test project with `typecheck.enabled`.
-	* @experimental In later versions, the project will only support a single pool.
-	*/
-	readonly pool: Pool;
-	/**
-	* Line numbers of the test locations to run.
-	*/
-	readonly testLines: number[] | undefined;
-	/**
-	* Regular expression pattern to filter test names.
-	*/
-	readonly testNamePattern: RegExp | undefined;
-	/**
-	* The ids of tasks inside of this specification to run.
-	*/
-	readonly testIds: string[] | undefined;
-	/**
-	* Test module associated with the specification. This will be `undefined` if tests have not been run yet.
-	*/
-	get testModule(): TestModule | undefined;
-	toJSON(): SerializedTestSpecification;
-}
-
 interface CoverageSummaryData {
     lines: Totals;
     statements: Totals;
@@ -877,6 +903,8 @@ declare class Logger {
 	deprecate(message: string): void;
 	clearHighlightCache(filename?: string): void;
 	highlight(filename: string, source: string): string;
+	printNoTestTagsFound(): void;
+	printTags(): void;
 	printNoTestFound(filters?: string[]): void;
 	printBanner(): void;
 	printBrowserBanner(project: TestProject): void;
@@ -1093,6 +1121,7 @@ declare class VitestWatcher {
 	readonly changedTests: Set<string>;
 	private readonly _onRerun;
 	constructor(vitest: Vitest);
+	close(): void;
 	unregisterWatcher: () => void;
 	registerWatcher(): this;
 	private scheduleRerun;
@@ -1161,7 +1190,6 @@ declare class Vitest {
 	private restartsCount;
 	private readonly specifications;
 	private pool;
-	private _config?;
 	private _vite?;
 	private _state?;
 	private _cache?;
@@ -1195,6 +1223,7 @@ declare class Vitest {
 	* Test results and test file stats cache. Primarily used by the sequencer to sort tests.
 	*/
 	get cache(): VitestCache;
+	listTags(): Promise<void>;
 	enableCoverage(): Promise<void>;
 	disableCoverage(): void;
 	private clearAllCachePaths;
@@ -1446,7 +1475,9 @@ interface BrowserProvider {
 	*/
 	supportsParallelism: boolean;
 	getCommandsContext: (sessionId: string) => Record<string, unknown>;
-	openPage: (sessionId: string, url: string) => Promise<void>;
+	openPage: (sessionId: string, url: string, options: {
+		parallel: boolean;
+	}) => Promise<void>;
 	getCDPSession?: (sessionId: string) => Promise<CDPSession>;
 	close: () => Awaitable<void>;
 }
@@ -2118,6 +2149,7 @@ interface JsonAssertionResult {
 	duration?: Milliseconds | null;
 	failureMessages: Array<string> | null;
 	location?: Callsite | null;
+	tags: string[];
 }
 interface JsonTestResult {
 	message: string;
@@ -3070,7 +3102,34 @@ interface InlineConfig {
 		* Enabling this will also show a breakdown by default in UI, but you can always press a button to toggle it.
 		*/
 		printImportBreakdown?: boolean;
+		/**
+		* Controls whether Vitest uses Vite's module runner to run the code or fallback to the native `import`.
+		*
+		* If Node.js cannot process the code, consider registering [module loader](https://nodejs.org/api/module.html#customization-hooks) via `execArgv`.
+		* @default true
+		*/
+		viteModuleRunner?: boolean;
+		/**
+		* If module runner is disabled, Vitest uses a module loader to transform files to support
+		* `import.meta.vitest` and `vi.mock`.
+		*
+		* If you don't use these features, you can disable this.
+		*
+		* This option only affects `loader.load` method, Vitest always defines a `loader.resolve` to populate the module graph.
+		*/
+		nodeLoader?: boolean;
 	};
+	/**
+	* Define tags available in your test files.
+	*
+	* If test defines a tag that is not listed here, an error will be thrown.
+	*/
+	tags?: TestTagDefinition[];
+	/**
+	* Should Vitest throw an error if test has a tag that is not defined in the config.
+	* @default true
+	*/
+	strictTags?: boolean;
 }
 interface TypecheckConfig {
 	/**
@@ -3191,11 +3250,20 @@ interface UserConfig extends InlineConfig {
 	* @experimental
 	*/
 	clearCache?: boolean;
+	/**
+	* Tags expression to filter tests to run. Multiple filters will be applied using AND logic.
+	* @see {@link https://vitest.dev/guide/test-tags#syntax}
+	*/
+	tagsFilter?: string[];
+	/**
+	* Log all available tags instead of running tests.
+	*/
+	listTags?: boolean | "json";
 }
 type OnUnhandledErrorCallback = (error: (TestError | Error) & {
 	type: string;
 }) => boolean | void;
-interface ResolvedConfig extends Omit<Required<UserConfig>, "project" | "config" | "filters" | "browser" | "coverage" | "testNamePattern" | "related" | "api" | "reporters" | "resolveSnapshotPath" | "benchmark" | "shard" | "cache" | "sequence" | "typecheck" | "runner" | "pool" | "cliExclude" | "diff" | "setupFiles" | "snapshotEnvironment" | "bail" | "name" | "vmMemoryLimit" | "fileParallelism"> {
+interface ResolvedConfig extends Omit<Required<UserConfig>, "project" | "config" | "filters" | "browser" | "coverage" | "testNamePattern" | "related" | "api" | "reporters" | "resolveSnapshotPath" | "benchmark" | "shard" | "cache" | "sequence" | "typecheck" | "runner" | "pool" | "cliExclude" | "diff" | "setupFiles" | "snapshotEnvironment" | "bail" | "name" | "vmMemoryLimit" | "fileParallelism" | "tagsFilter"> {
 	mode: VitestRunMode;
 	name: ProjectName["label"];
 	color?: ProjectName["color"];
@@ -3248,8 +3316,9 @@ interface ResolvedConfig extends Omit<Required<UserConfig>, "project" | "config"
 	maxWorkers: number;
 	vmMemoryLimit?: UserConfig["vmMemoryLimit"];
 	dumpDir?: string;
+	tagsFilter?: string[];
 }
-type NonProjectOptions = "shard" | "watch" | "run" | "cache" | "update" | "reporters" | "outputFile" | "teardownTimeout" | "silent" | "forceRerunTriggers" | "testNamePattern" | "ui" | "open" | "uiBase" | "snapshotFormat" | "resolveSnapshotPath" | "passWithNoTests" | "onConsoleLog" | "onStackTrace" | "dangerouslyIgnoreUnhandledErrors" | "slowTestThreshold" | "inspect" | "inspectBrk" | "coverage" | "watchTriggerPatterns";
+type NonProjectOptions = "shard" | "watch" | "run" | "cache" | "update" | "reporters" | "outputFile" | "teardownTimeout" | "silent" | "forceRerunTriggers" | "testNamePattern" | "ui" | "open" | "uiBase" | "snapshotFormat" | "resolveSnapshotPath" | "passWithNoTests" | "onConsoleLog" | "onStackTrace" | "dangerouslyIgnoreUnhandledErrors" | "slowTestThreshold" | "inspect" | "inspectBrk" | "coverage" | "watchTriggerPatterns" | "tagsFilter";
 interface ServerDepsOptions {
 	/**
 	* Externalize means that Vite will bpass the package to native Node.

package/dist/chunks/{rpc.HLmECnw_.js → rpc.DcRWTy5G.js}

@@ -1,6 +1,6 @@
 import { getSafeTimers } from '@vitest/utils/timers';
 import { c as createBirpc } from './index.Chj8NDwU.js';
-import { g as getWorkerState } from './utils.DvEY5TfP.js';
+import { g as getWorkerState } from './utils.DT4VyRyl.js';
 
 /* Ported from https://github.com/boblauer/MockDate/blob/master/src/mockdate.ts */
 /*

package/dist/chunks/{rpc.d.RH3apGEf.d.ts → rpc.d.CM7x9-sm.d.ts}

@@ -56,6 +56,7 @@ interface RuntimeRPC {
 	getCountOfFailedTests: () => number;
 	snapshotSaved: (snapshot: SnapshotResult) => void;
 	resolveSnapshotPath: (testPath: string) => string;
+	ensureModuleGraphEntry: (id: string, importer: string) => void;
 }
 interface RunnerRPC {
 	onCancel: (reason: CancelReason) => void;

package/dist/chunks/{setup-common.BcqLPsn5.js → setup-common.cvFp-ao9.js}

@@ -1,7 +1,7 @@
 import { r as resolveCoverageProviderModule } from './coverage.D_JHT54q.js';
 import { addSerializer } from '@vitest/snapshot';
 import { setSafeTimers } from '@vitest/utils/timers';
-import { g as getWorkerState } from './utils.DvEY5TfP.js';
+import { g as getWorkerState } from './utils.DT4VyRyl.js';
 
 async function startCoverageInsideWorker(options, loader, runtimeOptions) {
 	const coverageModule = await resolveCoverageProviderModule(options, loader);
@@ -26,7 +26,7 @@ async function setupCommonEnv(config) {
 	if (globalSetup) return;
 	globalSetup = true;
 	setSafeTimers();
-	if (config.globals) (await import('./globals.DjuGMoMc.js')).registerApiGlobally();
+	if (config.globals) (await import('./globals.C6Ecf1TO.js')).registerApiGlobally();
 }
 function setupDefines(config) {
 	for (const key in config.defines) globalThis[key] = config.defines[key];