executor.ts

/**
 * @license
 * Copyright Google LLC All Rights Reserved.
 *
 * Use of this source code is governed by an MIT-style license that can be
 * found in the LICENSE file at https://angular.dev/license
 */

import type { BuilderContext, BuilderOutput } from '@angular-devkit/architect';
import type { ApplicationBuilderInternalOptions } from '../../../application/options';
import type { KarmaBuilderOptions } from '../../../karma';
import { NormalizedUnitTestBuilderOptions } from '../../options';
import type { TestExecutor } from '../api';

export class KarmaExecutor implements TestExecutor {
  constructor(
    private context: BuilderContext,
    private options: NormalizedUnitTestBuilderOptions,
  ) {}

  async *execute(): AsyncIterable<BuilderOutput> {
    const { context, options: unitTestOptions } = this;

    if (unitTestOptions.debug) {
      context.logger.warn(
        'The "karma" test runner does not support the "debug" option. The option will be ignored.',
      );
    }

    if (unitTestOptions.setupFiles.length) {
      context.logger.warn(
        'The "karma" test runner does not support the "setupFiles" option. The option will be ignored.',
      );
    }

    const buildTargetOptions = (await context.validateOptions(
      await context.getTargetOptions(unitTestOptions.buildTarget),
      await context.getBuilderNameForTarget(unitTestOptions.buildTarget),
    )) as unknown as ApplicationBuilderInternalOptions;

    const karmaOptions: KarmaBuilderOptions = {
      tsConfig: unitTestOptions.tsConfig,
      polyfills: buildTargetOptions.polyfills,
      assets: buildTargetOptions.assets,
      scripts: buildTargetOptions.scripts,
      styles: buildTargetOptions.styles,
      inlineStyleLanguage: buildTargetOptions.inlineStyleLanguage,
      stylePreprocessorOptions: buildTargetOptions.stylePreprocessorOptions,
      externalDependencies: buildTargetOptions.externalDependencies,
      loader: buildTargetOptions.loader,
      define: buildTargetOptions.define,
      include: unitTestOptions.include,
      exclude: unitTestOptions.exclude,
      sourceMap: buildTargetOptions.sourceMap,
      progress: buildTargetOptions.progress,
      watch: unitTestOptions.watch,
      poll: buildTargetOptions.poll,
      preserveSymlinks: buildTargetOptions.preserveSymlinks,
      browsers: unitTestOptions.browsers?.join(','),
      codeCoverage: !!unitTestOptions.codeCoverage,
      codeCoverageExclude: unitTestOptions.codeCoverage?.exclude,
      fileReplacements: buildTargetOptions.fileReplacements,
      reporters: unitTestOptions.reporters,
      webWorkerTsConfig: buildTargetOptions.webWorkerTsConfig,
      aot: buildTargetOptions.aot,
    };

    const { execute } = await import('../../../karma');

    yield* execute(karmaOptions, context);
  }

  async [Symbol.asyncDispose](): Promise<void> {
    // The Karma builder handles its own teardown
  }
}