Method stop

packages/vitest/src/node/pools/poolRunner.ts:246–333

(options?: StopOptions)

  }

  async stop(options?: StopOptions): Promise<void> {
    // Wait for any ongoing operation to complete
    if (this._operationLock) {
      await this._operationLock
    }

    if (this._state === RunnerState.STOPPED || this._state === RunnerState.STOPPING) {
      return
    }

    this._otel?.span.setAttribute('vitest.worker.files', this._otel.files)

    if (this._state === RunnerState.IDLE) {
      this._otel?.span.end()
      this._state = RunnerState.STOPPED
      return
    }

    // Create operation lock to prevent concurrent start/stop
    this._operationLock = createDefer()

    try {
      this._state = RunnerState.STOPPING

      // Remove exit listener early to avoid "unexpected exit" errors during shutdown
      this.worker.off('exit', this.emitUnexpectedExit)

      const stopSpan = this.startTracesSpan('vitest.worker.stop')
      await this.withTimeout(
        new Promise<void>((resolve) => {
          const onStop = (response: WorkerResponse) => {
            if (response.type === 'stopped') {
              if (response.error) {
                stopSpan.recordException(response.error as Error)
                this.project.vitest.state.catchError(
                  response.error,
                  'Teardown Error',
                )
              }

              resolve()
              this.off('message', onStop)
            }
          }

          // Don't wait for graceful exit's response when force exiting
          if (options?.force) {
            return onStop({ type: 'stopped', __vitest_worker_response__: true })
          }

          this.on('message', onStop)
          this.postMessage({
            type: 'stop',
            __vitest_worker_request__: true,
            otelCarrier: this.getOTELCarrier(),
          })
        }),
        STOP_TIMEOUT,