feat(@angular/build): add reporter output file option for unit-test

The experimental `unit-test` builder now contains an additional option
named `outputFile` that supports configuring the output file for the reporter.
This option is currently only used by the `vitest` runner.
See https://vitest.dev/config/#outputfile

Usage example:

```
ng test --no-watch --reporter=json --output-file=results/unit-test.json
```

Author: cexbrayat

goldens/public-api/angular/build/index.api.md

@@ -223,6 +223,7 @@ export type UnitTestBuilderOptions = {
     debug?: boolean;
     exclude?: string[];
     include?: string[];
+    outputFile?: string;
     providersFile?: string;
     reporters?: string[];
     runner: Runner;

packages/angular/build/src/builders/unit-test/builder.ts

@@ -239,6 +239,7 @@ export async function* execute(
           name: 'base',
           include: [],
           reporters: normalizedOptions.reporters ?? ['default'],
+          outputFile: normalizedOptions.outputFile,
           watch: normalizedOptions.watch,
           coverage: generateCoverageOption(
             normalizedOptions.codeCoverage,

packages/angular/build/src/builders/unit-test/options.ts

@@ -33,7 +33,7 @@ export async function normalizeOptions(
   const buildTargetSpecifier = options.buildTarget ?? `::development`;
   const buildTarget = targetFromTargetString(buildTargetSpecifier, projectName, 'build');
 
-  const { tsConfig, runner, reporters, browsers } = options;
+  const { tsConfig, runner, reporters, outputFile, browsers } = options;
 
   return {
     // Project/workspace information
@@ -58,6 +58,7 @@ export async function normalizeOptions(
       : undefined,
     tsConfig,
     reporters,
+    outputFile,
     browsers,
     watch: options.watch ?? isTTY(),
     debug: options.debug ?? false,

packages/angular/build/src/builders/unit-test/schema.json

@@ -95,6 +95,10 @@
         "type": "string"
       }
     },
+    "outputFile": {
+      "type": "string",
+      "description": "The file to output the test report to. If not specified, the test runner will output to the console."
+    },
     "providersFile": {
       "type": "string",
       "description": "TypeScript file that exports an array of Angular providers to use during test execution. The array must be a default export.",

packages/angular/build/src/builders/unit-test/tests/options/reporter_and_output_file_spec.ts

@@ -0,0 +1,46 @@
+/**
+ * @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 { execute } from '../../index';
+import {
+  BASE_OPTIONS,
+  describeBuilder,
+  UNIT_TEST_BUILDER_INFO,
+  setupApplicationTarget,
+} from '../setup';
+
+describeBuilder(execute, UNIT_TEST_BUILDER_INFO, (harness) => {
+  describe('Options: "reporter" and "outputFile"', () => {
+    beforeEach(async () => {
+      setupApplicationTarget(harness);
+    });
+
+    it(`should output a JSON report`, async () => {
+      await harness.removeFile('src/app/app.component.spec.ts');
+      await harness.writeFiles({
+        'src/app/services/test.service.spec.ts': `
+          describe('TestService', () => {
+            it('should succeed', () => {
+              expect(true).toBe(true);
+            });
+          });`,
+      });
+
+      harness.useTarget('test', {
+        ...BASE_OPTIONS,
+        reporters: ['json'],
+        outputFile: 'test-report.json',
+      });
+
+      const { result } = await harness.executeOnce();
+      expect(result?.success).toBeTrue();
+      const reportContent = await harness.readFile('test-report.json');
+      expect(reportContent).toContain('TestService');
+    });
+  });
+});