From 2f5a65101a2d3ce9793a2924e42b81f4b5fdfeaa Mon Sep 17 00:00:00 2001
From: avivkeller <me@aviv.sh>
Date: Wed, 29 Jul 2026 14:17:04 -0700
Subject: [PATCH 1/2] test_runner: add support for --test-coverage-include-all

Signed-off-by: avivkeller <me@aviv.sh>
---
 doc/api/cli.md                                | 16 +++++
 doc/api/test.md                               |  7 ++
 doc/node.1                                    |  9 +++
 lib/internal/test_runner/coverage.js          | 50 ++++++++++++-
 lib/internal/test_runner/runner.js            |  3 +
 lib/internal/test_runner/utils.js             |  2 +
 src/node_options.cc                           |  7 ++
 src/node_options.h                            |  1 +
 .../coverage-include-all/covered.js           |  5 ++
 .../coverage-include-all/data.json            |  3 +
 .../coverage-include-all/index.test.js        |  9 +++
 .../coverage-include-all/nested/deep.js       |  5 ++
 .../node_modules/pkg/index.js                 |  5 ++
 .../coverage-include-all/untested.js          |  5 ++
 test/parallel/test-runner-coverage.js         | 70 +++++++++++++++++++
 15 files changed, 196 insertions(+), 1 deletion(-)
 create mode 100644 test/fixtures/test-runner/coverage-include-all/covered.js
 create mode 100644 test/fixtures/test-runner/coverage-include-all/data.json
 create mode 100644 test/fixtures/test-runner/coverage-include-all/index.test.js
 create mode 100644 test/fixtures/test-runner/coverage-include-all/nested/deep.js
 create mode 100644 test/fixtures/test-runner/coverage-include-all/node_modules/pkg/index.js
 create mode 100644 test/fixtures/test-runner/coverage-include-all/untested.js

diff --git a/doc/api/cli.md b/doc/api/cli.md
index 5d59844d4cbc72..241892524ef500 100644
--- a/doc/api/cli.md
+++ b/doc/api/cli.md
@@ -2857,6 +2857,21 @@ This option may be specified multiple times to include multiple glob patterns.
 If both `--test-coverage-exclude` and `--test-coverage-include` are provided,
 files must meet **both** criteria to be included in the coverage report.
 
+### `--test-coverage-include-all`
+
+<!-- YAML
+added: REPLACEME
+-->
+
+> Stability: 1 - Experimental
+
+Includes source files that were never loaded by the test run in the coverage
+report, where they are reported as having zero coverage.
+
+Candidate files are searched for in the current working directory, and are
+subject to the same `--test-coverage-include` and `--test-coverage-exclude`
+filtering as the rest of the report.
+
 ### `--test-coverage-lines=threshold`
 
 <!-- YAML
@@ -3901,6 +3916,7 @@ one is included in the list below.
 * `--test-coverage-exclude`
 * `--test-coverage-functions`
 * `--test-coverage-include`
+* `--test-coverage-include-all`
 * `--test-coverage-lines`
 * `--test-global-setup`
 * `--test-isolation`
diff --git a/doc/api/test.md b/doc/api/test.md
index cfbb350e15842a..d48e0e1f074ea4 100644
--- a/doc/api/test.md
+++ b/doc/api/test.md
@@ -1782,6 +1782,13 @@ changes:
     If both `coverageExcludeGlobs` and `coverageIncludeGlobs` are provided,
     files must meet **both** criteria to be included in the coverage report.
     **Default:** `undefined`.
+  * `coverageIncludeAll` {boolean} Includes source files that were never loaded by
+    the test run in the coverage report, where they are reported as having zero
+    coverage. Candidate files are searched for in `cwd`, and are subject to the
+    same `coverageIncludeGlobs` and `coverageExcludeGlobs` filtering as the rest
+    of the report. This property is only applicable when `coverage` was set to
+    `true`.
+    **Default:** `false`.
   * `lineCoverage` {number} Require a minimum percent of covered lines. If code
     coverage does not reach the threshold specified, the process will exit with code `1`.
     **Default:** `0`.
diff --git a/doc/node.1 b/doc/node.1
index cc51fde7661ac3..2d06a0fe67b49d 100644
--- a/doc/node.1
+++ b/doc/node.1
@@ -1400,6 +1400,13 @@ This option may be specified multiple times to include multiple glob patterns.
 If both \fB--test-coverage-exclude\fR and \fB--test-coverage-include\fR are provided,
 files must meet \fBboth\fR criteria to be included in the coverage report.
 .
+.It Fl -test-coverage-include-all
+Includes source files that were never loaded by the test run in the coverage
+report, where they are reported as having zero coverage.
+Candidate files are searched for in the current working directory, and are
+subject to the same \fB--test-coverage-include\fR and \fB--test-coverage-exclude\fR
+filtering as the rest of the report.
+.
 .It Fl -test-coverage-lines Ns = Ns Ar threshold
 Require a minimum percent of covered lines. If code coverage does not reach
 the threshold specified, the process will exit with code \fB1\fR.
@@ -2127,6 +2134,8 @@ one is included in the list below.
 .It
 \fB--test-coverage-include\fR
 .It
+\fB--test-coverage-include-all\fR
+.It
 \fB--test-coverage-lines\fR
 .It
 \fB--test-global-setup\fR
diff --git a/lib/internal/test_runner/coverage.js b/lib/internal/test_runner/coverage.js
index cdbece1eeae7c3..55151d64563fee 100644
--- a/lib/internal/test_runner/coverage.js
+++ b/lib/internal/test_runner/coverage.js
@@ -20,6 +20,7 @@ const {
 } = primordials;
 const {
   copyFileSync,
+  globSync,
   mkdirSync,
   mkdtempSync,
   opendirSync,
@@ -29,7 +30,7 @@ const {
 const { setupCoverageHooks } = require('internal/util');
 const { tmpdir } = require('os');
 const { join, resolve, relative } = require('path');
-const { fileURLToPath, URL } = require('internal/url');
+const { fileURLToPath, pathToFileURL, URL } = require('internal/url');
 const { kMappings, SourceMap } = require('internal/source_map/source_map');
 const {
   codes: {
@@ -48,6 +49,7 @@ const kLineSplitRegex = /(?<=\r?\n)/u;
 const kStatusRegex = /\/\* node:coverage (?<status>enable|disable) \*\//;
 const kTypeOnlyImportRegex = /^\s*import\s+type\b/u;
 const kTypeScriptSourceRegex = /\.(?:cts|mts|ts)$/u;
+const kSourceFileGlob = '**/*.{cjs,cts,js,mjs,mts,ts}';
 
 let stripTypeScriptTypesForCoverage;
 
@@ -407,6 +409,10 @@ class TestCoverage {
         this.mergeCoverage(result, this.mapCoverageWithSourceMap(coverage));
       }
 
+      if (this.options.coverageIncludeAll) {
+        this.#addUntestedFileCoverage(result);
+      }
+
       return ArrayFrom(result.values());
     } finally {
       if (dir) {
@@ -415,6 +421,48 @@ class TestCoverage {
     }
   }
 
+  #addUntestedFileCoverage(merged) {
+    const files = globSync(kSourceFileGlob, {
+      __proto__: null,
+      cwd: this.options.cwd,
+      // Skip node_modules/, since `shouldSkipFileCoverage` would skip it anyway
+      exclude: (name) => name === 'node_modules',
+    });
+
+    for (let i = 0; i < files.length; ++i) {
+      const url = pathToFileURL(resolve(this.options.cwd, files[i])).href;
+
+      if (merged.has(url) || this.shouldSkipFileCoverage(url)) {
+        continue;
+      }
+
+      this.markTypeScriptOnlyLines(url);
+      const lines = this.getLines(url);
+
+      if (!lines || lines.length === 0) {
+        continue;
+      }
+
+      const lastLine = lines[lines.length - 1];
+
+      merged.set(url, {
+        __proto__: null,
+        url,
+        functions: [{
+          __proto__: null,
+          functionName: '',
+          isBlockCoverage: false,
+          ranges: [{
+            __proto__: null,
+            startOffset: 0,
+            endOffset: lastLine.startOffset + lastLine.src.length,
+            count: 0,
+          }],
+        }],
+      });
+    }
+  }
+
 
   mapCoverageWithSourceMap(coverage) {
     const { result } = coverage;
diff --git a/lib/internal/test_runner/runner.js b/lib/internal/test_runner/runner.js
index 3bfe719ce5be76..4bfce346a5929c 100644
--- a/lib/internal/test_runner/runner.js
+++ b/lib/internal/test_runner/runner.js
@@ -723,6 +723,7 @@ function run(options = kEmptyObject) {
     only,
     globPatterns,
     coverage = false,
+    coverageIncludeAll = false,
     lineCoverage = 0,
     branchCoverage = 0,
     functionCoverage = 0,
@@ -882,6 +883,7 @@ function run(options = kEmptyObject) {
 
   validateOneOf(isolation, 'options.isolation', ['process', 'none']);
   validateBoolean(coverage, 'options.coverage');
+  validateBoolean(coverageIncludeAll, 'options.coverageIncludeAll');
   if (coverageExcludeGlobs != null) {
     if (!ArrayIsArray(coverageExcludeGlobs)) {
       coverageExcludeGlobs = [coverageExcludeGlobs];
@@ -923,6 +925,7 @@ function run(options = kEmptyObject) {
     ...parseCommandLine(),
     setup,  // This line can be removed when parseCommandLine() is removed here.
     coverage,
+    coverageIncludeAll,
     coverageExcludeGlobs,
     coverageIncludeGlobs,
     rerunFailuresFilePath,
diff --git a/lib/internal/test_runner/utils.js b/lib/internal/test_runner/utils.js
index 9937d9592a2967..3590d3ef79b45c 100644
--- a/lib/internal/test_runner/utils.js
+++ b/lib/internal/test_runner/utils.js
@@ -245,6 +245,7 @@ function parseCommandLine() {
 
   const isTestRunner = getOptionValue('--test');
   const coverage = getOptionValue('--experimental-test-coverage');
+  const coverageIncludeAll = getOptionValue('--test-coverage-include-all');
   const forceExit = getOptionValue('--test-force-exit');
   const sourceMaps = getOptionValue('--enable-source-maps');
   const updateSnapshots = getOptionValue('--test-update-snapshots');
@@ -415,6 +416,7 @@ function parseCommandLine() {
     isTestRunner,
     concurrency,
     coverage,
+    coverageIncludeAll,
     coverageExcludeGlobs,
     coverageIncludeGlobs,
     destinations,
diff --git a/src/node_options.cc b/src/node_options.cc
index b9d3dd56092e35..383522863bb817 100644
--- a/src/node_options.cc
+++ b/src/node_options.cc
@@ -1029,6 +1029,13 @@ EnvironmentOptionsParser::EnvironmentOptionsParser() {
             &EnvironmentOptions::coverage_include_pattern,
             kAllowedInEnvvar,
             OptionNamespaces::kTestRunnerNamespace);
+  AddOption("--test-coverage-include-all",
+            "include source files that were never loaded in the coverage "
+            "report",
+            &EnvironmentOptions::coverage_include_all,
+            kAllowedInEnvvar,
+            false,
+            OptionNamespaces::kTestRunnerNamespace);
   AddOption("--test-coverage-exclude",
             "exclude files from coverage report that match this glob pattern",
             &EnvironmentOptions::coverage_exclude_pattern,
diff --git a/src/node_options.h b/src/node_options.h
index 7d9ff9e5147d18..fc758f2444aa0f 100644
--- a/src/node_options.h
+++ b/src/node_options.h
@@ -221,6 +221,7 @@ class EnvironmentOptions : public Options {
   std::vector<std::string> test_skip_pattern;
   std::vector<std::string> experimental_test_tag_filter;
   std::vector<std::string> coverage_include_pattern;
+  bool coverage_include_all = false;
   std::vector<std::string> coverage_exclude_pattern;
   bool throw_deprecation = false;
   bool trace_deprecation = false;
diff --git a/test/fixtures/test-runner/coverage-include-all/covered.js b/test/fixtures/test-runner/coverage-include-all/covered.js
new file mode 100644
index 00000000000000..5779d9f9747f18
--- /dev/null
+++ b/test/fixtures/test-runner/coverage-include-all/covered.js
@@ -0,0 +1,5 @@
+'use strict';
+
+module.exports = function covered() {
+  return 'covered';
+};
diff --git a/test/fixtures/test-runner/coverage-include-all/data.json b/test/fixtures/test-runner/coverage-include-all/data.json
new file mode 100644
index 00000000000000..76af629f8ff552
--- /dev/null
+++ b/test/fixtures/test-runner/coverage-include-all/data.json
@@ -0,0 +1,3 @@
+{
+  "not": "a source file"
+}
diff --git a/test/fixtures/test-runner/coverage-include-all/index.test.js b/test/fixtures/test-runner/coverage-include-all/index.test.js
new file mode 100644
index 00000000000000..48d7f040831ca7
--- /dev/null
+++ b/test/fixtures/test-runner/coverage-include-all/index.test.js
@@ -0,0 +1,9 @@
+'use strict';
+
+const assert = require('node:assert');
+const test = require('node:test');
+const covered = require('./covered');
+
+test('covered source is executed', () => {
+  assert.strictEqual(covered(), 'covered');
+});
diff --git a/test/fixtures/test-runner/coverage-include-all/nested/deep.js b/test/fixtures/test-runner/coverage-include-all/nested/deep.js
new file mode 100644
index 00000000000000..26a37f0c97b263
--- /dev/null
+++ b/test/fixtures/test-runner/coverage-include-all/nested/deep.js
@@ -0,0 +1,5 @@
+'use strict';
+
+module.exports = function deep() {
+  return 'deep';
+};
diff --git a/test/fixtures/test-runner/coverage-include-all/node_modules/pkg/index.js b/test/fixtures/test-runner/coverage-include-all/node_modules/pkg/index.js
new file mode 100644
index 00000000000000..4791b062ab2c30
--- /dev/null
+++ b/test/fixtures/test-runner/coverage-include-all/node_modules/pkg/index.js
@@ -0,0 +1,5 @@
+'use strict';
+
+module.exports = function fromNodeModules() {
+  return 'from node_modules';
+};
diff --git a/test/fixtures/test-runner/coverage-include-all/untested.js b/test/fixtures/test-runner/coverage-include-all/untested.js
new file mode 100644
index 00000000000000..969d9d1a1deaf7
--- /dev/null
+++ b/test/fixtures/test-runner/coverage-include-all/untested.js
@@ -0,0 +1,5 @@
+'use strict';
+
+module.exports = function untested() {
+  return 'untested';
+};
diff --git a/test/parallel/test-runner-coverage.js b/test/parallel/test-runner-coverage.js
index 542078c93d5e45..bc65221a45f8ad 100644
--- a/test/parallel/test-runner-coverage.js
+++ b/test/parallel/test-runner-coverage.js
@@ -528,6 +528,76 @@ test('coverage with included and excluded files', skipIfNoInspector, () => {
   assert(!findCoverageFileForPid(result.pid));
 });
 
+test('coverage does not include untested files by default', skipIfNoInspector, () => {
+  const fixtureDir = fixtures.path('test-runner', 'coverage-include-all');
+  const fixture = fixtures.path('test-runner', 'coverage-include-all', 'index.test.js');
+  const args = [
+    '--test', '--experimental-test-coverage', '--test-coverage-exclude=**/*.test.js',
+    '--test-reporter', 'tap', fixture,
+  ];
+  const result = spawnSync(process.execPath, args, { cwd: fixtureDir });
+  const report = [
+    '# start of coverage report',
+    '# -----------------------------------------------------------',
+    '# file       | line % | branch % | funcs % | uncovered lines',
+    '# -----------------------------------------------------------',
+    '# covered.js | 100.00 |   100.00 |  100.00 | ',
+    '# -----------------------------------------------------------',
+    '# all files  | 100.00 |   100.00 |  100.00 | ',
+    '# -----------------------------------------------------------',
+    '# end of coverage report',
+  ].join('\n');
+
+  assertIncludesReport(result, report);
+  assert.strictEqual(result.status, 0);
+  assert(!findCoverageFileForPid(result.pid));
+});
+
+test('coverage includes untested files', skipIfNoInspector, () => {
+  const fixtureDir = fixtures.path('test-runner', 'coverage-include-all');
+  const fixture = fixtures.path('test-runner', 'coverage-include-all', 'index.test.js');
+  const args = [
+    '--test', '--experimental-test-coverage', '--test-coverage-include-all',
+    '--test-coverage-exclude=**/*.test.js', '--test-reporter', 'tap', fixture,
+  ];
+  const result = spawnSync(process.execPath, args, { cwd: fixtureDir });
+
+  const report = [
+    '# start of coverage report',
+    '# -------------------------------------------------------------',
+    '# file         | line % | branch % | funcs % | uncovered lines',
+    '# -------------------------------------------------------------',
+    '# covered.js   | 100.00 |   100.00 |  100.00 | ',
+    '# nested       |        |          |         | ',
+    '#  deep.js     |   0.00 |   100.00 |  100.00 | 1-5',
+    '# untested.js  |   0.00 |   100.00 |  100.00 | 1-5',
+    '# -------------------------------------------------------------',
+    '# all files    |  33.33 |   100.00 |  100.00 | ',
+    '# -------------------------------------------------------------',
+    '# end of coverage report',
+  ].join('\n');
+
+  assertIncludesReport(result, report);
+  assert.strictEqual(result.status, 0);
+  assert(!findCoverageFileForPid(result.pid));
+});
+
+test('untested files honor coverage include and exclude globs', skipIfNoInspector, () => {
+  const fixtureDir = fixtures.path('test-runner', 'coverage-include-all');
+  const fixture = fixtures.path('test-runner', 'coverage-include-all', 'index.test.js');
+  const args = [
+    '--test', '--experimental-test-coverage', '--test-coverage-include-all',
+    '--test-coverage-exclude=nested/**', '--test-reporter', 'tap', fixture,
+  ];
+  const result = spawnSync(process.execPath, args, { cwd: fixtureDir });
+  const stdout = result.stdout.toString();
+
+  assert.strictEqual(result.status, 0);
+  assert.match(stdout, /^# untested\.js/m);
+  assert.doesNotMatch(stdout, /deep\.js/);
+  assert(!findCoverageFileForPid(result.pid));
+});
+
 test('correctly prints the coverage report of files contained in parent directories', skipIfNoInspector, () => {
   let report = [
     '# start of coverage report',

From 8a951bb6a90b12d64ee1c3148cf2f0e5f9f441dd Mon Sep 17 00:00:00 2001
From: Aviv Keller <me@aviv.sh>
Date: Wed, 29 Jul 2026 15:16:07 -0700
Subject: [PATCH 2/2] Apply suggestions from code review

Co-authored-by: Aviv Keller <me@aviv.sh>
---
 doc/api/cli.md | 2 +-
 doc/node.1     | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/doc/api/cli.md b/doc/api/cli.md
index 241892524ef500..a4c93fdc301695 100644
--- a/doc/api/cli.md
+++ b/doc/api/cli.md
@@ -3915,8 +3915,8 @@ one is included in the list below.
 * `--test-coverage-branches`
 * `--test-coverage-exclude`
 * `--test-coverage-functions`
-* `--test-coverage-include`
 * `--test-coverage-include-all`
+* `--test-coverage-include`
 * `--test-coverage-lines`
 * `--test-global-setup`
 * `--test-isolation`
diff --git a/doc/node.1 b/doc/node.1
index 2d06a0fe67b49d..918d018f6b0402 100644
--- a/doc/node.1
+++ b/doc/node.1
@@ -2132,10 +2132,10 @@ one is included in the list below.
 .It
 \fB--test-coverage-functions\fR
 .It
-\fB--test-coverage-include\fR
-.It
 \fB--test-coverage-include-all\fR
 .It
+\fB--test-coverage-include\fR
+.It
 \fB--test-coverage-lines\fR
 .It
 \fB--test-global-setup\fR