test_runner: improve --test-name-pattern to allow matching single test

Try to match a test by name prefixed with all its ancestors
to ensure uniqueness of the name

Fixes: #46728
PR-URL: #51577
Reviewed-By: Moshe Atlow <moshe@atlow.co.il>
Reviewed-By: Chemi Atlow <chemi@atlow.co.il>
Reviewed-By: Benjamin Gruenbaum <benjamingr@gmail.com>

doc/api/test.md

@@ -267,6 +267,23 @@ allows regular expression flags to be used. In the previous example, starting
 Node.js with `--test-name-pattern="/test [4-5]/i"` would match `Test 4` and
 `Test 5` because the pattern is case-insensitive.
 
+To match a single test with a pattern, you can prefix it with all its ancestor
+test names separated by space, to ensure it is unique.
+For example, given the following test file:
+
+```js
+describe('test 1', (t) => {
+  it('some test');
+});
+
+describe('test 2', (t) => {
+  it('some test');
+});
+```
+
+Starting Node.js with `--test-name-pattern="test 1 some test"` would match
+only `some test` in `test 1`.
+
 Test name patterns do not change the set of files that the test runner executes.
 
 ## Extraneous asynchronous activity

lib/internal/test_runner/test.js

@@ -14,6 +14,7 @@ const {
   PromisePrototypeThen,
   PromiseResolve,
   SafePromisePrototypeFinally,
+  StringPrototypeTrim,
   ReflectApply,
   RegExpPrototypeExec,
   SafeMap,
@@ -362,8 +363,29 @@ class Test extends AsyncResource {
   }
 
   matchesTestNamePatterns() {
-    return ArrayPrototypeSome(testNamePatterns, (re) => RegExpPrototypeExec(re, this.name) !== null) ||
-      this.parent?.matchesTestNamePatterns();
+    const matchesByNameOrParent = ArrayPrototypeSome(testNamePatterns, (re) =>
+      RegExpPrototypeExec(re, this.name) !== null,
+    ) ||
+    this.parent?.matchesTestNamePatterns();
+
+    if (matchesByNameOrParent) return true;
+
+    const testNameWithAncestors = StringPrototypeTrim(this.getTestNameWithAncestors());
+    if (!testNameWithAncestors) return false;
+
+    return ArrayPrototypeSome(testNamePatterns, (re) => RegExpPrototypeExec(re, testNameWithAncestors) !== null);
+  }
+
+  /**
+   * Returns a name of the test prefixed by name of all its ancestors in ascending order, separated by a space
+   * Ex."grandparent parent test"
+   *
+   * It's needed to match a single test with non-unique name by pattern
+   */
+  getTestNameWithAncestors() {
+    if (!this.parent) return '';
+
+    return `${this.parent.getTestNameWithAncestors()} ${this.name}`;
   }
 
   hasConcurrency() {

test/fixtures/test-runner/output/name_pattern.js

@@ -1,4 +1,4 @@
-// Flags: --test-name-pattern=enabled --test-name-pattern=yes --test-name-pattern=/pattern/i
+// Flags: --test-name-pattern=enabled --test-name-pattern=yes --test-name-pattern=/pattern/i --test-name-pattern=/^DescribeForMatchWithAncestors\sNestedDescribeForMatchWithAncestors\sNestedTest$/
 'use strict';
 const common = require('../../../common');
 const {
@@ -65,3 +65,15 @@ describe('no', function() {
     it('yes', () => {});
   });
 });
+
+describe('DescribeForMatchWithAncestors', () => {
+  it('NestedTest', () => common.mustNotCall());
+
+  describe('NestedDescribeForMatchWithAncestors', () => {
+    it('NestedTest', common.mustCall());
+  });
+})
+
+describe('DescribeForMatchWithAncestors', () => {
+  it('NestedTest', () => common.mustNotCall());
+})

test/fixtures/test-runner/output/name_pattern.snapshot

@@ -171,12 +171,48 @@ ok 15 - no
   duration_ms: *
   type: 'suite'
   ...
-1..15
-# tests 21
-# suites 10
-# pass 13
+# Subtest: DescribeForMatchWithAncestors
+    # Subtest: NestedTest
+    ok 1 - NestedTest # SKIP test name does not match pattern
+      ---
+      duration_ms: *
+      ...
+    # Subtest: NestedDescribeForMatchWithAncestors
+        # Subtest: NestedTest
+        ok 1 - NestedTest
+          ---
+          duration_ms: *
+          ...
+        1..1
+    ok 2 - NestedDescribeForMatchWithAncestors
+      ---
+      duration_ms: *
+      type: 'suite'
+      ...
+    1..2
+ok 16 - DescribeForMatchWithAncestors
+  ---
+  duration_ms: *
+  type: 'suite'
+  ...
+# Subtest: DescribeForMatchWithAncestors
+    # Subtest: NestedTest
+    ok 1 - NestedTest # SKIP test name does not match pattern
+      ---
+      duration_ms: *
+      ...
+    1..1
+ok 17 - DescribeForMatchWithAncestors
+  ---
+  duration_ms: *
+  type: 'suite'
+  ...
+1..17
+# tests 24
+# suites 13
+# pass 14
 # fail 0
 # cancelled 0
-# skipped 8
+# skipped 10
 # todo 0
 # duration_ms *