@vitest/runner 3.0.0-beta.4 → 3.0.1

package/dist/chunk-tasks.js

@@ -49,8 +49,8 @@ function interpretTaskModes(file, namePattern, testLocations, onlyMode, parentIs
         }
       }
       let hasLocationMatch = parentMatchedWithLocation;
-      if (testLocations !== void 0 && testLocations.length !== 0) {
-        if (t.location && (testLocations == null ? void 0 : testLocations.includes(t.location.line))) {
+      if (testLocations !== undefined && testLocations.length !== 0) {
+        if (t.location && (testLocations == null ? undefined : testLocations.includes(t.location.line))) {
           t.mode = "run";
           matchedLocations.push(t.location.line);
           hasLocationMatch = true;
@@ -81,16 +81,16 @@ function interpretTaskModes(file, namePattern, testLocations, onlyMode, parentIs
     }
   };
   traverseSuite(file, parentIsOnly, false);
-  const nonMatching = testLocations == null ? void 0 : testLocations.filter((loc) => !matchedLocations.includes(loc));
+  const nonMatching = testLocations == null ? undefined : testLocations.filter((loc) => !matchedLocations.includes(loc));
   if (nonMatching && nonMatching.length !== 0) {
     const message = nonMatching.length === 1 ? `line ${nonMatching[0]}` : `lines ${nonMatching.join(", ")}`;
-    if (file.result === void 0) {
+    if (file.result === undefined) {
       file.result = {
         state: "fail",
         errors: []
       };
     }
-    if (file.result.errors === void 0) {
+    if (file.result.errors === undefined) {
       file.result.errors = [];
     }
     file.result.errors.push(
@@ -171,7 +171,7 @@ function createFileTask(filepath, root, projectName, pool) {
     tasks: [],
     meta: /* @__PURE__ */ Object.create(null),
     projectName,
-    file: void 0,
+    file: undefined,
     pool
   };
   file.file = file;
@@ -271,16 +271,16 @@ function hasFailed(suite) {
   return toArray(suite).some(
     (s) => {
       var _a;
-      return ((_a = s.result) == null ? void 0 : _a.state) === "fail" || s.type === "suite" && hasFailed(s.tasks);
+      return ((_a = s.result) == null ? undefined : _a.state) === "fail" || s.type === "suite" && hasFailed(s.tasks);
     }
   );
 }
 function getNames(task) {
   const names = [task.name];
   let current = task;
-  while (current == null ? void 0 : current.suite) {
+  while (current == null ? undefined : current.suite) {
     current = current.suite;
-    if (current == null ? void 0 : current.name) {
+    if (current == null ? undefined : current.name) {
       names.unshift(current.name);
     }
   }

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { B as BeforeAllListener, A as AfterAllListener, b as BeforeEachListener, d as AfterEachListener, e as TaskHook, O as OnTestFailedHandler, f as OnTestFinishedHandler, a as Test, g as Custom, S as Suite, h as SuiteHooks, T as Task, F as File, i as SuiteAPI, j as TestAPI, k as SuiteCollector } from './tasks-B64RTJlW.js';
-export { D as DoneCallback, E as ExtendedContext, l as Fixture, m as FixtureFn, n as FixtureOptions, o as Fixtures, H as HookCleanupCallback, p as HookListener, I as InferFixturesTypes, R as RunMode, q as RuntimeContext, r as SequenceHooks, s as SequenceSetupFiles, t as SuiteFactory, u as TaskBase, v as TaskContext, w as TaskCustomOptions, x as TaskMeta, y as TaskPopulated, z as TaskResult, G as TaskResultPack, J as TaskState, K as TestContext, L as TestFunction, M as TestOptions, U as Use } from './tasks-B64RTJlW.js';
+import { B as BeforeAllListener, A as AfterAllListener, b as BeforeEachListener, d as AfterEachListener, e as TaskHook, O as OnTestFailedHandler, f as OnTestFinishedHandler, a as Test, g as Custom, S as Suite, h as SuiteHooks, i as TaskUpdateEvent, T as Task, F as File, j as SuiteAPI, k as TestAPI, l as SuiteCollector } from './tasks-CUXfn9LM.js';
+export { D as DoneCallback, E as ExtendedContext, m as Fixture, n as FixtureFn, o as FixtureOptions, p as Fixtures, H as HookCleanupCallback, q as HookListener, I as InferFixturesTypes, R as RunMode, r as RuntimeContext, s as SequenceHooks, t as SequenceSetupFiles, u as SuiteFactory, v as TaskBase, w as TaskContext, x as TaskCustomOptions, y as TaskEventPack, z as TaskMeta, G as TaskPopulated, J as TaskResult, K as TaskResultPack, L as TaskState, M as TestContext, N as TestFunction, P as TestOptions, U as Use } from './tasks-CUXfn9LM.js';
 import { Awaitable } from '@vitest/utils';
 import { VitestRunner, FileSpecification } from './types.js';
 export { CancelReason, VitestRunnerConfig, VitestRunnerConstructor, VitestRunnerImportSource } from './types.js';
@@ -105,6 +105,8 @@ declare const onTestFailed: TaskHook<OnTestFailedHandler>;
  *
  * **Note:** The `onTestFinished` hooks are running in reverse order of their registration. You can configure this by changing the `sequence.hooks` option in the config file.
  *
+ * **Note:** The `onTestFinished` hook is not called if the test is canceled with a dynamic `ctx.skip()` call.
+ *
  * @param {Function} fn - The callback function to be executed after a test finishes. The function can receive parameters providing details about the completed test, including its success or failure status.
  * @param {number} [timeout] - Optional timeout in milliseconds for the hook. If not provided, the default hook timeout from the runner's configuration is used.
  * @throws {Error} Throws an error if the function is not called within a test.
@@ -125,7 +127,7 @@ declare function getFn<Task = Test | Custom>(key: Task): () => Awaitable<void>;
 declare function setHooks(key: Suite, hooks: SuiteHooks): void;
 declare function getHooks(key: Suite): SuiteHooks;
 
-declare function updateTask(task: Task, runner: VitestRunner): void;
+declare function updateTask(event: TaskUpdateEvent, task: Task, runner: VitestRunner): void;
 declare function startTests(specs: string[] | FileSpecification[], runner: VitestRunner): Promise<File[]>;
 declare function publicCollect(specs: string[] | FileSpecification[], runner: VitestRunner): Promise<File[]>;
 
@@ -256,4 +258,4 @@ declare function createTaskCollector(fn: (...args: any[]) => any, context?: Reco
 
 declare function getCurrentTest<T extends Test | undefined>(): T;
 
-export { AfterAllListener, AfterEachListener, BeforeAllListener, BeforeEachListener, Custom, TestAPI as CustomAPI, File, FileSpecification, OnTestFailedHandler, OnTestFinishedHandler, Suite, SuiteAPI, SuiteCollector, SuiteHooks, Task, TaskHook, Test, TestAPI, VitestRunner, afterAll, afterEach, beforeAll, beforeEach, publicCollect as collectTests, createTaskCollector, describe, getCurrentSuite, getCurrentTest, getFn, getHooks, it, onTestFailed, onTestFinished, setFn, setHooks, startTests, suite, test, updateTask };
+export { AfterAllListener, AfterEachListener, BeforeAllListener, BeforeEachListener, Custom, TestAPI as CustomAPI, File, FileSpecification, OnTestFailedHandler, OnTestFinishedHandler, Suite, SuiteAPI, SuiteCollector, SuiteHooks, Task, TaskHook, TaskUpdateEvent, Test, TestAPI, VitestRunner, afterAll, afterEach, beforeAll, beforeEach, publicCollect as collectTests, createTaskCollector, describe, getCurrentSuite, getCurrentTest, getFn, getHooks, it, onTestFailed, onTestFinished, setFn, setHooks, startTests, suite, test, updateTask };

package/dist/index.js

@@ -1,4 +1,4 @@
-import { getSafeTimers, isObject, createDefer, isNegativeNaN, format, objDisplay, objectAttr, toArray, assertTypes, shuffle } from '@vitest/utils';
+import { getSafeTimers, isObject, createDefer, toArray, isNegativeNaN, format, objDisplay, objectAttr, assertTypes, shuffle } from '@vitest/utils';
 import { parseSingleStack } from '@vitest/utils/source-map';
 import { c as createChainable, b as createFileTask, a as calculateSuiteHash, s as someTasksAreOnly, i as interpretTaskModes, l as limitConcurrency, p as partitionSuiteChildren, o as hasTests, n as hasFailed } from './chunk-tasks.js';
 import { processError } from '@vitest/utils/error';
@@ -22,7 +22,7 @@ const collectorContext = {
 };
 function collectTask(task) {
   var _a;
-  (_a = collectorContext.currentSuite) == null ? void 0 : _a.tasks.push(task);
+  (_a = collectorContext.currentSuite) == null ? undefined : _a.tasks.push(task);
 }
 async function runWithSuite(suite, fn) {
   const prev = collectorContext.currentSuite;
@@ -43,7 +43,7 @@ function withTimeout(fn, timeout, isHook = false) {
           clearTimeout(timer);
           reject(new Error(makeTimeoutMsg(isHook, timeout)));
         }, timeout);
-        (_a = timer.unref) == null ? void 0 : _a.call(timer);
+        (_a = timer.unref) == null ? undefined : _a.call(timer);
       }),
       Promise.resolve(fn(...args)).then((result) => {
         return new Promise((resolve) => setTimeout(resolve, 0, result));
@@ -58,7 +58,8 @@ function createTestContext(test, runner) {
   };
   context.task = test;
   context.skip = (note) => {
-    test.pending = true;
+    test.result ?? (test.result = { state: "skip" });
+    test.result.pending = true;
     throw new PendingError("test is skipped; abort execution", test, note);
   };
   context.onTestFailed = (handler, timeout) => {
@@ -73,7 +74,7 @@ function createTestContext(test, runner) {
       withTimeout(handler, timeout ?? runner.config.hookTimeout, true)
     );
   };
-  return ((_a = runner.extendTaskContext) == null ? void 0 : _a.call(runner, context)) || context;
+  return ((_a = runner.extendTaskContext) == null ? undefined : _a.call(runner, context)) || context;
 }
 function makeTimeoutMsg(isHook, timeout) {
   return `${isHook ? "Hook" : "Test"} timed out in ${timeout}ms.
@@ -150,7 +151,7 @@ function withFixtures(fn, testContext) {
       return fn({});
     }
     const fixtures = getFixture(context);
-    if (!(fixtures == null ? void 0 : fixtures.length)) {
+    if (!(fixtures == null ? undefined : fixtures.length)) {
       return fn(context);
     }
     const usedProps = getUsedProps(fn);
@@ -407,12 +408,12 @@ function createSuiteCollector(name, factory = () => {
     const task2 = {
       id: "",
       name: name2,
-      suite: void 0,
+      suite: undefined,
       each: options.each,
       fails: options.fails,
-      context: void 0,
+      context: undefined,
       type: "test",
-      file: void 0,
+      file: undefined,
       retry: options.retry ?? runner.config.retry,
       repeats: options.repeats,
       mode: options.only ? "only" : options.skip ? "skip" : options.todo ? "todo" : "run",
@@ -422,7 +423,7 @@ function createSuiteCollector(name, factory = () => {
     if (options.concurrent || !options.sequential && runner.config.sequence.concurrent) {
       task2.concurrent = true;
     }
-    task2.shuffle = suiteOptions == null ? void 0 : suiteOptions.shuffle;
+    task2.shuffle = suiteOptions == null ? undefined : suiteOptions.shuffle;
     const context = createTestContext(task2, runner);
     Object.defineProperty(task2, "context", {
       value: context,
@@ -434,7 +435,7 @@ function createSuiteCollector(name, factory = () => {
         task2,
         withTimeout(
           withAwaitAsyncAssertions(withFixtures(handler, context), task2),
-          (options == null ? void 0 : options.timeout) ?? runner.config.testTimeout
+          (options == null ? undefined : options.timeout) ?? runner.config.testTimeout
         )
       );
     }
@@ -456,8 +457,8 @@ function createSuiteCollector(name, factory = () => {
     if (typeof suiteOptions === "object") {
       options = Object.assign({}, suiteOptions, options);
     }
-    options.concurrent = this.concurrent || !this.sequential && (options == null ? void 0 : options.concurrent);
-    options.sequential = this.sequential || !this.concurrent && (options == null ? void 0 : options.sequential);
+    options.concurrent = this.concurrent || !this.sequential && (options == null ? undefined : options.concurrent);
+    options.sequential = this.sequential || !this.concurrent && (options == null ? undefined : options.sequential);
     const test3 = task(formatName(name2), {
       ...this,
       ...options,
@@ -490,11 +491,11 @@ function createSuiteCollector(name, factory = () => {
       name,
       mode,
       each,
-      file: void 0,
-      shuffle: suiteOptions == null ? void 0 : suiteOptions.shuffle,
+      file: undefined,
+      shuffle: suiteOptions == null ? undefined : suiteOptions.shuffle,
       tasks: [],
       meta: /* @__PURE__ */ Object.create(null),
-      concurrent: suiteOptions == null ? void 0 : suiteOptions.concurrent
+      concurrent: suiteOptions == null ? undefined : suiteOptions.concurrent
     };
     if (runner && includeLocation && runner.config.includeTaskLocation) {
       const limit = Error.stackTraceLimit;
@@ -538,14 +539,15 @@ function createSuiteCollector(name, factory = () => {
 }
 function withAwaitAsyncAssertions(fn, task) {
   return async (...args) => {
-    await fn(...args);
+    const fnResult = await fn(...args);
     if (task.promises) {
       const result = await Promise.allSettled(task.promises);
-      const errors = result.map((r) => r.status === "rejected" ? r.reason : void 0).filter(Boolean);
+      const errors = result.map((r) => r.status === "rejected" ? r.reason : undefined).filter(Boolean);
       if (errors.length) {
         throw errors;
       }
     }
+    return fnResult;
   };
 }
 function createSuite() {
@@ -560,9 +562,9 @@ function createSuite() {
     const isConcurrentSpecified = options.concurrent || this.concurrent || options.sequential === false;
     const isSequentialSpecified = options.sequential || this.sequential || options.concurrent === false;
     options = {
-      ...currentSuite == null ? void 0 : currentSuite.options,
+      ...currentSuite == null ? undefined : currentSuite.options,
       ...options,
-      shuffle: this.shuffle ?? options.shuffle ?? ((_a = currentSuite == null ? void 0 : currentSuite.options) == null ? void 0 : _a.shuffle) ?? (runner == null ? void 0 : runner.config.sequence.shuffle)
+      shuffle: this.shuffle ?? options.shuffle ?? ((_a = currentSuite == null ? undefined : currentSuite.options) == null ? undefined : _a.shuffle) ?? (runner == null ? undefined : runner.config.sequence.shuffle)
     };
     const isConcurrent = isConcurrentSpecified || options.concurrent && !isSequentialSpecified;
     const isSequential = isSequentialSpecified || options.sequential && !isConcurrentSpecified;
@@ -607,7 +609,19 @@ function createSuite() {
           }
         }
       });
-      this.setContext("each", void 0);
+      this.setContext("each", undefined);
+    };
+  };
+  suiteFn.for = function(cases, ...args) {
+    if (Array.isArray(cases) && args.length) {
+      cases = formatTemplateString(cases, args);
+    }
+    return (name, optionsOrFn, fnOrOptions) => {
+      const name_ = formatName(name);
+      const { options, handler } = parseArguments(optionsOrFn, fnOrOptions);
+      cases.forEach((item, idx) => {
+        suite(formatTitle(name_, toArray(item), idx), options, () => handler(item));
+      });
     };
   };
   suiteFn.skipIf = (condition) => condition ? suite.skip : suite;
@@ -650,7 +664,7 @@ function createTaskCollector(fn, context) {
           }
         }
       });
-      this.setContext("each", void 0);
+      this.setContext("each", undefined);
     };
   };
   taskFn.for = function(cases, ...args) {
@@ -681,7 +695,7 @@ function createTaskCollector(fn, context) {
       context || {},
       (key) => {
         var _a, _b;
-        return (_b = (_a = getRunner()).injectValue) == null ? void 0 : _b.call(_a, key);
+        return (_b = (_a = getRunner()).injectValue) == null ? undefined : _b.call(_a, key);
       }
     );
     return createTest(function fn2(name, optionsOrFn, optionsOrTest) {
@@ -733,7 +747,7 @@ function formatTitle(template, items, idx) {
       (_, key) => {
         var _a, _b;
         return objDisplay(objectAttr(items[0], key), {
-          truncate: (_b = (_a = runner == null ? void 0 : runner.config) == null ? void 0 : _a.chaiConfig) == null ? void 0 : _b.truncateThreshold
+          truncate: (_b = (_a = runner == null ? undefined : runner.config) == null ? undefined : _a.chaiConfig) == null ? undefined : _b.truncateThreshold
         });
       }
     );
@@ -852,10 +866,10 @@ async function collectTests(specs, runner) {
   const config = runner.config;
   for (const spec of specs) {
     const filepath = typeof spec === "string" ? spec : spec.filepath;
-    const testLocations = typeof spec === "string" ? void 0 : spec.testLocations;
+    const testLocations = typeof spec === "string" ? undefined : spec.testLocations;
     const file = createFileTask(filepath, config.root, config.name, runner.pool);
     file.shuffle = config.sequence.shuffle;
-    (_a = runner.onCollectStart) == null ? void 0 : _a.call(runner, file);
+    (_a = runner.onCollectStart) == null ? undefined : _a.call(runner, file);
     clearCollectorContext(filepath, runner);
     try {
       const setupFiles = toArray(config.setupFiles);
@@ -897,7 +911,7 @@ async function collectTests(specs, runner) {
     calculateSuiteHash(file);
     file.tasks.forEach((task) => {
       var _a2;
-      if (((_a2 = task.suite) == null ? void 0 : _a2.id) === "") {
+      if (((_a2 = task.suite) == null ? undefined : _a2.id) === "") {
         delete task.suite;
       }
     });
@@ -927,18 +941,25 @@ function mergeHooks(baseHooks, hooks) {
 
 const now = globalThis.performance ? globalThis.performance.now.bind(globalThis.performance) : Date.now;
 const unixNow = Date.now;
-function updateSuiteHookState(suite, name, state, runner) {
-  var _a;
-  if (!suite.result) {
-    suite.result = { state: "run" };
+function updateSuiteHookState(task, name, state, runner) {
+  if (!task.result) {
+    task.result = { state: "run" };
   }
-  if (!((_a = suite.result) == null ? void 0 : _a.hooks)) {
-    suite.result.hooks = {};
+  if (!task.result.hooks) {
+    task.result.hooks = {};
   }
-  const suiteHooks = suite.result.hooks;
+  const suiteHooks = task.result.hooks;
   if (suiteHooks) {
     suiteHooks[name] = state;
-    updateTask(suite, runner);
+    let event = state === "run" ? "before-hook-start" : "before-hook-end";
+    if (name === "afterAll" || name === "afterEach") {
+      event = state === "run" ? "after-hook-start" : "after-hook-end";
+    }
+    updateTask(
+      event,
+      task,
+      runner
+    );
   }
 }
 function getSuiteHooks(suite, name, sequence) {
@@ -990,8 +1011,10 @@ async function callSuiteHook(suite, currentTask, name, runner, args) {
       ...await callSuiteHook(parentSuite, currentTask, name, runner, args)
     );
   }
-  updateSuiteHookState(currentTask, name, "run", runner);
   const hooks = getSuiteHooks(suite, name, sequence);
+  if (hooks.length > 0) {
+    updateSuiteHookState(currentTask, name, "run", runner);
+  }
   if (sequence === "parallel") {
     callbacks.push(
       ...await Promise.all(hooks.map((hook) => hook(...args)))
@@ -1001,7 +1024,9 @@ async function callSuiteHook(suite, currentTask, name, runner, args) {
       callbacks.push(await hook(...args));
     }
   }
-  updateSuiteHookState(currentTask, name, "pass", runner);
+  if (hooks.length > 0) {
+    updateSuiteHookState(currentTask, name, "pass", runner);
+  }
   if (name === "afterEach" && parentSuite) {
     callbacks.push(
       ...await callSuiteHook(parentSuite, currentTask, name, runner, args)
@@ -1010,9 +1035,11 @@ async function callSuiteHook(suite, currentTask, name, runner, args) {
   return callbacks;
 }
 const packs = /* @__PURE__ */ new Map();
+const eventsPacks = [];
 let updateTimer;
 let previousUpdate;
-function updateTask(task, runner) {
+function updateTask(event, task, runner) {
+  eventsPacks.push([task.id, event]);
   packs.set(task.id, [task.result, task.meta]);
   const { clearTimeout, setTimeout } = getSafeTimers();
   clearTimeout(updateTimer);
@@ -1029,7 +1056,8 @@ async function sendTasksUpdate(runner) {
     const taskPacks = Array.from(packs).map(([id, task]) => {
       return [id, task[0], task[1]];
     });
-    const p = (_a = runner.onTaskUpdate) == null ? void 0 : _a.call(runner, taskPacks);
+    const p = (_a = runner.onTaskUpdate) == null ? undefined : _a.call(runner, taskPacks, eventsPacks);
+    eventsPacks.length = 0;
     packs.clear();
     return p;
   }
@@ -1045,13 +1073,13 @@ async function callCleanupHooks(cleanups) {
   );
 }
 async function runTest(test, runner) {
-  var _a, _b, _c, _d, _e, _f, _g, _h;
-  await ((_a = runner.onBeforeRunTask) == null ? void 0 : _a.call(runner, test));
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i;
+  await ((_a = runner.onBeforeRunTask) == null ? undefined : _a.call(runner, test));
   if (test.mode !== "run" && test.mode !== "queued") {
     return;
   }
-  if (((_b = test.result) == null ? void 0 : _b.state) === "fail") {
-    updateTask(test, runner);
+  if (((_b = test.result) == null ? undefined : _b.state) === "fail") {
+    updateTask("test-failed-early", test, runner);
     return;
   }
   const start = now();
@@ -1060,7 +1088,7 @@ async function runTest(test, runner) {
     startTime: unixNow(),
     retryCount: 0
   };
-  updateTask(test, runner);
+  updateTask("test-prepare", test, runner);
   setCurrentTest(test);
   const suite = test.suite || test.file;
   const repeats = test.repeats ?? 0;
@@ -1106,15 +1134,15 @@ async function runTest(test, runner) {
       } catch (e) {
         failTask(test.result, e, runner.config.diffOptions);
       }
-      if (test.pending || ((_e = test.result) == null ? void 0 : _e.state) === "skip") {
+      if (((_e = test.result) == null ? undefined : _e.pending) || ((_f = test.result) == null ? undefined : _f.state) === "skip") {
         test.mode = "skip";
-        test.result = { state: "skip", note: (_f = test.result) == null ? void 0 : _f.note };
-        updateTask(test, runner);
-        setCurrentTest(void 0);
+        test.result = { state: "skip", note: (_g = test.result) == null ? undefined : _g.note, pending: true };
+        updateTask("test-finished", test, runner);
+        setCurrentTest(undefined);
         return;
       }
       try {
-        await ((_g = runner.onTaskFinished) == null ? void 0 : _g.call(runner, test));
+        await ((_h = runner.onTaskFinished) == null ? void 0 : _h.call(runner, test));
       } catch (e) {
         failTask(test.result, e, runner.config.diffOptions);
       }
@@ -1137,8 +1165,8 @@ async function runTest(test, runner) {
           runner.config.sequence.hooks
         );
       }
-      delete test.onFailed;
-      delete test.onFinished;
+      test.onFailed = undefined;
+      test.onFinished = undefined;
       if (test.result.state === "pass") {
         break;
       }
@@ -1146,7 +1174,7 @@ async function runTest(test, runner) {
         test.result.state = "run";
         test.result.retryCount = (test.result.retryCount ?? 0) + 1;
       }
-      updateTask(test, runner);
+      updateTask("test-retried", test, runner);
     }
   }
   if (test.fails) {
@@ -1156,18 +1184,19 @@ async function runTest(test, runner) {
       test.result.errors = [error];
     } else {
       test.result.state = "pass";
-      test.result.errors = void 0;
+      test.result.errors = undefined;
     }
   }
-  setCurrentTest(void 0);
+  setCurrentTest(undefined);
   test.result.duration = now() - start;
-  await ((_h = runner.onAfterRunTask) == null ? void 0 : _h.call(runner, test));
-  updateTask(test, runner);
+  await ((_i = runner.onAfterRunTask) == null ? undefined : _i.call(runner, test));
+  updateTask("test-finished", test, runner);
 }
 function failTask(result, err, diffOptions) {
   if (err instanceof PendingError) {
     result.state = "skip";
     result.note = err.note;
+    result.pending = true;
     return;
   }
   result.state = "fail";
@@ -1182,7 +1211,7 @@ function markTasksAsSkipped(suite, runner) {
   suite.tasks.forEach((t) => {
     t.mode = "skip";
     t.result = { ...t.result, state: "skip" };
-    updateTask(t, runner);
+    updateTask("test-finished", t, runner);
     if (t.type === "suite") {
       markTasksAsSkipped(t, runner);
     }
@@ -1190,23 +1219,26 @@ function markTasksAsSkipped(suite, runner) {
 }
 async function runSuite(suite, runner) {
   var _a, _b, _c, _d;
-  await ((_a = runner.onBeforeRunSuite) == null ? void 0 : _a.call(runner, suite));
-  if (((_b = suite.result) == null ? void 0 : _b.state) === "fail") {
+  await ((_a = runner.onBeforeRunSuite) == null ? undefined : _a.call(runner, suite));
+  if (((_b = suite.result) == null ? undefined : _b.state) === "fail") {
     markTasksAsSkipped(suite, runner);
-    updateTask(suite, runner);
+    updateTask("suite-failed-early", suite, runner);
     return;
   }
   const start = now();
+  const mode = suite.mode;
   suite.result = {
-    state: "run",
+    state: mode === "skip" || mode === "todo" ? mode : "run",
     startTime: unixNow()
   };
-  updateTask(suite, runner);
+  updateTask("suite-prepare", suite, runner);
   let beforeAllCleanups = [];
   if (suite.mode === "skip") {
     suite.result.state = "skip";
+    updateTask("suite-finished", suite, runner);
   } else if (suite.mode === "todo") {
     suite.result.state = "todo";
+    updateTask("suite-finished", suite, runner);
   } else {
     try {
       try {
@@ -1257,7 +1289,7 @@ async function runSuite(suite, runner) {
     if (suite.mode === "run" || suite.mode === "queued") {
       if (!runner.config.passWithNoTests && !hasTests(suite)) {
         suite.result.state = "fail";
-        if (!((_c = suite.result.errors) == null ? void 0 : _c.length)) {
+        if (!((_c = suite.result.errors) == null ? undefined : _c.length)) {
           const error = processError(
             new Error(`No test found in suite ${suite.name}`)
           );
@@ -1269,9 +1301,9 @@ async function runSuite(suite, runner) {
         suite.result.state = "pass";
       }
     }
-    updateTask(suite, runner);
     suite.result.duration = now() - start;
-    await ((_d = runner.onAfterRunSuite) == null ? void 0 : _d.call(runner, suite));
+    updateTask("suite-finished", suite, runner);
+    await ((_d = runner.onAfterRunSuite) == null ? undefined : _d.call(runner, suite));
   }
 }
 let limitMaxConcurrency;
@@ -1287,7 +1319,7 @@ async function runFiles(files, runner) {
   limitMaxConcurrency ?? (limitMaxConcurrency = limitConcurrency(runner.config.maxConcurrency));
   for (const file of files) {
     if (!file.tasks.length && !runner.config.passWithNoTests) {
-      if (!((_b = (_a = file.result) == null ? void 0 : _a.errors) == null ? void 0 : _b.length)) {
+      if (!((_b = (_a = file.result) == null ? undefined : _a.errors) == null ? undefined : _b.length)) {
         const error = processError(
           new Error(`No test suite found in file ${file.filepath}`)
         );
@@ -1303,21 +1335,21 @@ async function runFiles(files, runner) {
 async function startTests(specs, runner) {
   var _a, _b, _c, _d;
   const paths = specs.map((f) => typeof f === "string" ? f : f.filepath);
-  await ((_a = runner.onBeforeCollect) == null ? void 0 : _a.call(runner, paths));
+  await ((_a = runner.onBeforeCollect) == null ? undefined : _a.call(runner, paths));
   const files = await collectTests(specs, runner);
-  await ((_b = runner.onCollected) == null ? void 0 : _b.call(runner, files));
-  await ((_c = runner.onBeforeRunFiles) == null ? void 0 : _c.call(runner, files));
+  await ((_b = runner.onCollected) == null ? undefined : _b.call(runner, files));
+  await ((_c = runner.onBeforeRunFiles) == null ? undefined : _c.call(runner, files));
   await runFiles(files, runner);
-  await ((_d = runner.onAfterRunFiles) == null ? void 0 : _d.call(runner, files));
+  await ((_d = runner.onAfterRunFiles) == null ? undefined : _d.call(runner, files));
   await sendTasksUpdate(runner);
   return files;
 }
 async function publicCollect(specs, runner) {
   var _a, _b;
   const paths = specs.map((f) => typeof f === "string" ? f : f.filepath);
-  await ((_a = runner.onBeforeCollect) == null ? void 0 : _a.call(runner, paths));
+  await ((_a = runner.onBeforeCollect) == null ? undefined : _a.call(runner, paths));
   const files = await collectTests(specs, runner);
-  await ((_b = runner.onCollected) == null ? void 0 : _b.call(runner, files));
+  await ((_b = runner.onCollected) == null ? undefined : _b.call(runner, files));
   return files;
 }
 

package/dist/{tasks-B64RTJlW.d.ts → tasks-CUXfn9LM.d.ts}

@@ -94,10 +94,6 @@ interface TaskPopulated extends TaskBase {
      * File task. It's the root task of the file.
      */
     file: File;
-    /**
-     * Whether the task was skipped by calling `t.skip()`.
-     */
-    pending?: boolean;
     /**
      * Whether the task should succeed if it fails. If the task fails, it will be marked as passed.
      */
@@ -176,6 +172,17 @@ type TaskResultPack = [
      */
     meta: TaskMeta
 ];
+type TaskEventPack = [
+    /**
+     * Unique task identifier from `task.id`.
+     */
+    id: string,
+    /**
+     * The name of the event that triggered the update.
+     */
+    event: TaskUpdateEvent
+];
+type TaskUpdateEvent = 'test-failed-early' | 'suite-failed-early' | 'test-prepare' | 'test-finished' | 'test-retried' | 'suite-prepare' | 'suite-finished' | 'before-hook-start' | 'before-hook-end' | 'after-hook-start' | 'after-hook-end';
 interface Suite extends TaskBase {
     type: 'suite';
     /**
@@ -263,6 +270,10 @@ interface TestForFunction<ExtraContext> {
     <T>(cases: ReadonlyArray<T>): TestForFunctionReturn<T, TestContext & ExtraContext>;
     (strings: TemplateStringsArray, ...values: any[]): TestForFunctionReturn<any, TestContext & ExtraContext>;
 }
+interface SuiteForFunction {
+    <T>(cases: ReadonlyArray<T>): EachFunctionReturn<[T]>;
+    (...args: [TemplateStringsArray, ...any]): EachFunctionReturn<any[]>;
+}
 interface TestCollectorCallable<C = object> {
     /**
      * @deprecated Use options as the second argument instead
@@ -363,6 +374,7 @@ interface SuiteCollectorCallable<ExtraContext = object> {
 }
 type ChainableSuiteAPI<ExtraContext = object> = ChainableFunction<'concurrent' | 'sequential' | 'only' | 'skip' | 'todo' | 'shuffle', SuiteCollectorCallable<ExtraContext>, {
     each: TestEachFunction;
+    for: SuiteForFunction;
 }>;
 type SuiteAPI<ExtraContext = object> = ChainableSuiteAPI<ExtraContext> & {
     skipIf: (condition: any) => ChainableSuiteAPI<ExtraContext>;
@@ -469,4 +481,4 @@ interface TaskHook<HookListener> {
 type SequenceHooks = 'stack' | 'list' | 'parallel';
 type SequenceSetupFiles = 'list' | 'parallel';
 
-export { type AfterAllListener as A, type BeforeAllListener as B, type ChainableFunction as C, type DoneCallback as D, type ExtendedContext as E, type File as F, type TaskResultPack as G, type HookCleanupCallback as H, type InferFixturesTypes as I, type TaskState as J, type TestContext as K, type TestFunction as L, type TestOptions as M, type OnTestFailedHandler as O, type RunMode as R, type Suite as S, type Task as T, type Use as U, type Test as a, type BeforeEachListener as b, createChainable as c, type AfterEachListener as d, type TaskHook as e, type OnTestFinishedHandler as f, type Custom as g, type SuiteHooks as h, type SuiteAPI as i, type TestAPI as j, type SuiteCollector as k, type Fixture as l, type FixtureFn as m, type FixtureOptions as n, type Fixtures as o, type HookListener as p, type RuntimeContext as q, type SequenceHooks as r, type SequenceSetupFiles as s, type SuiteFactory as t, type TaskBase as u, type TaskContext as v, type TaskCustomOptions as w, type TaskMeta as x, type TaskPopulated as y, type TaskResult as z };
+export { type AfterAllListener as A, type BeforeAllListener as B, type ChainableFunction as C, type DoneCallback as D, type ExtendedContext as E, type File as F, type TaskPopulated as G, type HookCleanupCallback as H, type InferFixturesTypes as I, type TaskResult as J, type TaskResultPack as K, type TaskState as L, type TestContext as M, type TestFunction as N, type OnTestFailedHandler as O, type TestOptions as P, type RunMode as R, type Suite as S, type Task as T, type Use as U, type Test as a, type BeforeEachListener as b, createChainable as c, type AfterEachListener as d, type TaskHook as e, type OnTestFinishedHandler as f, type Custom as g, type SuiteHooks as h, type TaskUpdateEvent as i, type SuiteAPI as j, type TestAPI as k, type SuiteCollector as l, type Fixture as m, type FixtureFn as n, type FixtureOptions as o, type Fixtures as p, type HookListener as q, type RuntimeContext as r, type SequenceHooks as s, type SequenceSetupFiles as t, type SuiteFactory as u, type TaskBase as v, type TaskContext as w, type TaskCustomOptions as x, type TaskEventPack as y, type TaskMeta as z };

package/dist/types.d.ts

@@ -1,6 +1,6 @@
 import { DiffOptions } from '@vitest/utils/diff';
-import { r as SequenceHooks, s as SequenceSetupFiles, F as File, T as Task, a as Test, S as Suite, G as TaskResultPack, K as TestContext } from './tasks-B64RTJlW.js';
-export { A as AfterAllListener, d as AfterEachListener, B as BeforeAllListener, b as BeforeEachListener, g as Custom, j as CustomAPI, D as DoneCallback, E as ExtendedContext, l as Fixture, m as FixtureFn, n as FixtureOptions, o as Fixtures, H as HookCleanupCallback, p as HookListener, I as InferFixturesTypes, O as OnTestFailedHandler, f as OnTestFinishedHandler, R as RunMode, q as RuntimeContext, i as SuiteAPI, k as SuiteCollector, t as SuiteFactory, h as SuiteHooks, u as TaskBase, v as TaskContext, w as TaskCustomOptions, e as TaskHook, x as TaskMeta, y as TaskPopulated, z as TaskResult, J as TaskState, j as TestAPI, L as TestFunction, M as TestOptions, U as Use } from './tasks-B64RTJlW.js';
+import { s as SequenceHooks, t as SequenceSetupFiles, F as File, T as Task, a as Test, S as Suite, K as TaskResultPack, y as TaskEventPack, M as TestContext } from './tasks-CUXfn9LM.js';
+export { A as AfterAllListener, d as AfterEachListener, B as BeforeAllListener, b as BeforeEachListener, g as Custom, k as CustomAPI, D as DoneCallback, E as ExtendedContext, m as Fixture, n as FixtureFn, o as FixtureOptions, p as Fixtures, H as HookCleanupCallback, q as HookListener, I as InferFixturesTypes, O as OnTestFailedHandler, f as OnTestFinishedHandler, R as RunMode, r as RuntimeContext, j as SuiteAPI, l as SuiteCollector, u as SuiteFactory, h as SuiteHooks, v as TaskBase, w as TaskContext, x as TaskCustomOptions, e as TaskHook, z as TaskMeta, G as TaskPopulated, J as TaskResult, L as TaskState, i as TaskUpdateEvent, k as TestAPI, N as TestFunction, P as TestOptions, U as Use } from './tasks-CUXfn9LM.js';
 import '@vitest/utils';
 
 /**
@@ -108,7 +108,7 @@ interface VitestRunner {
     /**
      * Called, when a task is updated. The same as "onTaskUpdate" in a reporter, but this is running in the same thread as tests.
      */
-    onTaskUpdate?: (task: TaskResultPack[]) => Promise<void>;
+    onTaskUpdate?: (task: TaskResultPack[], events: TaskEventPack[]) => Promise<void>;
     /**
      * Called before running all tests in collected paths.
      */
@@ -142,4 +142,4 @@ interface VitestRunner {
     pool?: string;
 }
 
-export { type CancelReason, File, type FileSpecification, SequenceHooks, SequenceSetupFiles, Suite, Task, TaskResultPack, Test, TestContext, type VitestRunner, type VitestRunnerConfig, type VitestRunnerConstructor, type VitestRunnerImportSource };
+export { type CancelReason, File, type FileSpecification, SequenceHooks, SequenceSetupFiles, Suite, Task, TaskEventPack, TaskResultPack, Test, TestContext, type VitestRunner, type VitestRunnerConfig, type VitestRunnerConstructor, type VitestRunnerImportSource };

package/dist/utils.d.ts

@@ -1,5 +1,5 @@
-import { S as Suite, F as File, T as Task, a as Test } from './tasks-B64RTJlW.js';
-export { C as ChainableFunction, c as createChainable } from './tasks-B64RTJlW.js';
+import { S as Suite, F as File, T as Task, a as Test } from './tasks-CUXfn9LM.js';
+export { C as ChainableFunction, c as createChainable } from './tasks-CUXfn9LM.js';
 import { Arrayable } from '@vitest/utils';
 
 /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vitest/runner",
   "type": "module",
-  "version": "3.0.0-beta.4",
+  "version": "3.0.1",
   "description": "Vitest test runner",
   "license": "MIT",
   "funding": "https://opencollective.com/vitest",
@@ -38,8 +38,8 @@
     "dist"
   ],
   "dependencies": {
-    "pathe": "^2.0.0",
-    "@vitest/utils": "3.0.0-beta.4"
+    "pathe": "^2.0.1",
+    "@vitest/utils": "3.0.1"
   },
   "scripts": {
     "build": "rimraf dist && rollup -c",