Function runTest

packages/runner/src/run.ts:584–785

(test: Test, runner: VitestRunner)

}

export async function runTest(test: Test, runner: VitestRunner): Promise<void> {
  await runner.onBeforeRunTask?.(test)

  if (test.mode !== 'run' && test.mode !== 'queued') {
    updateTask('test-prepare', test, runner)
    updateTask('test-finished', test, runner)
    return
  }

  if (test.result?.state === 'fail') {
    // should not be possible to get here, I think this is just copy pasted from suite
    // TODO: maybe someone fails tests in `beforeAll` hooks?
    // https://github.com/vitest-dev/vitest/pull/7069
    updateTask('test-failed-early', test, runner)
    return
  }

  const start = now()

  test.result = {
    state: 'run',
    startTime: unixNow(),
    retryCount: 0,
  }
  updateTask('test-prepare', test, runner)

  const cleanupRunningTest = addRunningTest(test)
  setCurrentTest(test)

  const suite = test.suite || test.file
  const $ = runner.trace!

  const repeats = test.repeats ?? 0
  for (let repeatCount = 0; repeatCount <= repeats; repeatCount++) {
    const retry = getRetryCount(test.retry)
    for (let retryCount = 0; retryCount <= retry; retryCount++) {
      let beforeEachCleanups: unknown[] = []
      // fixtureCheckpoint is passed by callAroundEachHooks - it represents the count
      // of fixture cleanup functions AFTER all aroundEach fixtures have been resolved
      // but BEFORE the test runs. This allows us to clean up only fixtures created
      // inside runTest while preserving aroundEach fixtures for teardown.
      await callAroundEachHooks(suite, test, async (fixtureCheckpoint) => {
        try {
          await runner.onBeforeTryTask?.(test, {
            retry: retryCount,
            repeats: repeatCount,
          })

          test.result!.repeatCount = repeatCount

          beforeEachCleanups = await $('test.beforeEach', () => callSuiteHook(
            suite,
            test,
            'beforeEach',
            runner,
            [test.context, suite],
          ))