test_runner: improve --test-timeout to be per test

Previously `--test-timeout` is set on per test execution, this is
obviously a bug as per test execution is hard to be expected, this patch
addresses the issue by setting `timeout` from per execution to per test.

This patch also fixes a minor issue that `--test-timeout` is not being
respected when running without `--test`.

Author: Jake Yuesong Li

lib/internal/test_runner/harness.js

@@ -272,6 +272,7 @@ function lazyBootstrapRoot() {
     };
     const globalOptions = parseCommandLine();
     globalOptions.cwd = process.cwd();
+    globalOptions.timeout = Infinity;
     createTestTree(rootTestOptions, globalOptions);
     globalRoot.reporter.on('test:summary', (data) => {
       if (!data.success) {

lib/internal/test_runner/test.js

@@ -788,6 +788,8 @@ class Test extends AsyncResource {
   }
 
   createSubtest(Factory, name, options, fn, overrides) {
+    const timeoutPerTest = this.config.timeoutPerTest;
+
     if (typeof name === 'function') {
       fn = name;
     } else if (name !== null && typeof name === 'object') {
@@ -797,8 +799,18 @@ class Test extends AsyncResource {
       fn = options;
     }
 
+    if (options !== null && typeof options === 'object') {
+      if (this.childNumber > 0 && options.timeout === undefined && timeoutPerTest !== Infinity) {
+        options.timeout = timeoutPerTest;
+      }
+    }
+
     if (options === null || typeof options !== 'object') {
-      options = kEmptyObject;
+      if (this.childNumber > 0 && timeoutPerTest !== Infinity) {
+        options = { __proto__: null, timeout: timeoutPerTest };
+      } else {
+        options = kEmptyObject;
+      }
     }
 
     let parent = this;

lib/internal/test_runner/utils.js

@@ -211,7 +211,7 @@ function parseCommandLine() {
   let shard;
   let testNamePatterns = mapPatternFlagToRegExArray('--test-name-pattern');
   let testSkipPatterns = mapPatternFlagToRegExArray('--test-skip-pattern');
-  let timeout;
+  let timeoutPerTest;
 
   if (isChildProcessV8) {
     kBuiltinReporters.set('v8-serializer', 'internal/test_runner/reporter/v8-serializer');
@@ -242,7 +242,7 @@ function parseCommandLine() {
 
   if (isTestRunner) {
     isolation = getOptionValue('--test-isolation');
-    timeout = getOptionValue('--test-timeout') || Infinity;
+    timeoutPerTest = getOptionValue('--test-timeout') || Infinity;
 
     if (isolation === 'none') {
       concurrency = 1;
@@ -271,7 +271,7 @@ function parseCommandLine() {
       };
     }
   } else {
-    timeout = Infinity;
+    timeoutPerTest = getOptionValue('--test-timeout') || Infinity;
     concurrency = 1;
     const testNamePatternFlag = getOptionValue('--test-name-pattern');
     only = getOptionValue('--test-only');
@@ -334,7 +334,7 @@ function parseCommandLine() {
     sourceMaps,
     testNamePatterns,
     testSkipPatterns,
-    timeout,
+    timeoutPerTest,
     updateSnapshots,
     watch,
   };

test/fixtures/test-runner/output/test-timeout-flag.js

@@ -0,0 +1,16 @@
+// Flags: --test-timeout=500
+'use strict';
+const { describe, test } = require('node:test');
+const { setTimeout } = require('node:timers/promises');
+
+describe('--test-timeout is set to 500ms', () => {
+  test('test 1 must fail due to testTimeoutFailure with error test timed out after 500ms', async () => {
+      await setTimeout(1000);
+  })
+  test('test 2  must fail due to testTimeoutFailure with error test timed out after 600ms', {timeout: 600}, async () => {
+      await setTimeout(1000);
+  })
+  test('test 3 must pass', async () => {
+        await setTimeout(10);
+  })
+})

test/fixtures/test-runner/output/test-timeout-flag.snapshot

@@ -0,0 +1,49 @@
+TAP version 13
+# Subtest: --test-timeout is set to 500ms
+    # Subtest: test 1 must fail due to testTimeoutFailure with error test timed out after 500ms
+    not ok 1 - test 1 must fail due to testTimeoutFailure with error test timed out after 500ms
+      ---
+      duration_ms: *
+      type: 'test'
+      location: '/test/fixtures/test-runner/output/test-timeout-flag.js:(LINE):3'
+      failureType: 'testTimeoutFailure'
+      error: 'test timed out after 500ms'
+      code: 'ERR_TEST_FAILURE'
+      stack: |-
+        async Promise.all (index 0)
+      ...
+    # Subtest: test 2  must fail due to testTimeoutFailure with error test timed out after 600ms
+    not ok 2 - test 2  must fail due to testTimeoutFailure with error test timed out after 600ms
+      ---
+      duration_ms: *
+      type: 'test'
+      location: '/test/fixtures/test-runner/output/test-timeout-flag.js:(LINE):3'
+      failureType: 'testTimeoutFailure'
+      error: 'test timed out after 600ms'
+      code: 'ERR_TEST_FAILURE'
+      ...
+    # Subtest: test 3 must pass
+    ok 3 - test 3 must pass
+      ---
+      duration_ms: *
+      type: 'test'
+      ...
+    1..3
+not ok 1 - --test-timeout is set to 500ms
+  ---
+  duration_ms: *
+  type: 'suite'
+  location: '/test/fixtures/test-runner/output/test-timeout-flag.js:(LINE):1'
+  failureType: 'subtestsFailed'
+  error: '2 subtests failed'
+  code: 'ERR_TEST_FAILURE'
+  ...
+1..1
+# tests 3
+# suites 1
+# pass 1
+# fail 0
+# cancelled 2
+# skipped 0
+# todo 0
+# duration_ms *

test/parallel/test-runner-cli-timeout.js

@@ -10,19 +10,19 @@ const env = { ...process.env, 'NODE_DEBUG': 'test_runner' };
 test('default timeout -- Infinity', async () => {
   const args = ['--test'];
   const cp = spawnSync(process.execPath, args, { cwd, env });
-  assert.match(cp.stderr.toString(), /timeout: Infinity,/);
+  assert.match(cp.stderr.toString(), /timeoutPerTest: Infinity/);
 });
 
 test('timeout of 10ms', async () => {
   const args = ['--test', '--test-timeout', 10];
   const cp = spawnSync(process.execPath, args, { cwd, env });
-  assert.match(cp.stderr.toString(), /timeout: 10,/);
+  assert.match(cp.stderr.toString(), /timeoutPerTest: 10/);
 });
 
 test('isolation=none uses the --test-timeout flag', async () => {
   const args = [
     '--test', '--test-isolation=none', '--test-timeout=10',
   ];
   const cp = spawnSync(process.execPath, args, { cwd, env });
-  assert.match(cp.stderr.toString(), /timeout: 10,/);
+  assert.match(cp.stderr.toString(), /timeoutPerTest: 10/);
 });

test/parallel/test-runner-output.mjs

@@ -132,6 +132,15 @@ const tests = [
     name: 'test-runner/output/timeout_in_before_each_should_not_affect_further_tests.js',
     flags: ['--test-reporter=tap'],
   },
+  {
+    name: 'test-runner/output/test-timeout-flag.js',
+    flags: ['--test-reporter=tap'],
+  },
+  // --test-timeout should work with or without --test flag
+  {
+    name: 'test-runner/output/test-timeout-flag.js',
+    flags: ['--test-reporter=tap', '--test'],
+  },
   {
     name: 'test-runner/output/hooks-with-no-global-test.js',
     flags: ['--test-reporter=tap'],