Method run

lib/codecept.js:268–333

* Run a specific test or all loaded tests. * * @param {string} [test] * @returns {Promise }

(test)

   * @returns {Promise<void>}
   */
  async run(test) {
    await container.started()

    // Check TypeScript loader configuration before running tests
    const tsValidation = validateTypeScriptSetup(this.testFiles, this.requiringModules || [])
    if (tsValidation.hasError) {
      output.error(tsValidation.message)
      process.exit(1)
    }

    // Show warning if ts-node/esm is being used
    const tsWarning = getTSNodeESMWarning(this.requiringModules || [])
    if (tsWarning) {
      output.print(output.colors.yellow(tsWarning))
    }

    // Ensure translations are loaded for Gherkin features
    try {
      const { loadTranslations } = await import('./mocha/gherkin.js')
      await loadTranslations()
    } catch (e) {
      // Ignore if gherkin module not available
    }

    // Sort test files alphabetically for consistent execution order,
    // but skip sorting when --shuffle is active so the randomised order is preserved.
    if (!this.opts.shuffle) {
      this.testFiles.sort()
    }

    return new Promise((resolve, reject) => {
      const mocha = container.mocha()
      mocha.files = this.testFiles

      if (test) {
        if (!fsPath.isAbsolute(test)) {
          test = fsPath.join(store.codeceptDir, test)
        }
        const testBasename = fsPath.basename(test, '.js')
        const testFeatureBasename = fsPath.basename(test, '.feature')
        mocha.files = mocha.files.filter(t => {
          return fsPath.basename(t, '.js') === testBasename || fsPath.basename(t, '.feature') === testFeatureBasename || t === test
        })
      }

      const done = async (failures) => {
        event.emit(event.all.result, container.result())
        event.emit(event.all.after, this)
        // Wait for any recorder tasks added by event.all.after handlers
        await recorder.promise()
        // Set exit code based on test failures
        if (failures) {
          process.exitCode = 1
        }
        resolve()
      }

      try {