From 5d183fc3c58ef1fbb77e026fdfd40c5ab125af20 Mon Sep 17 00:00:00 2001
From: sangwook <rewq5991@gmail.com>
Date: Sat, 7 Nov 2026 19:33:06 +0900
Subject: [PATCH 1/3] test_runner: add tags and workerId to SuiteContext

TestContext exposes tags and workerId, but SuiteContext does not, so a
describe() callback cannot read the suite's tags, including the ones
inherited from ancestor suites. Expose both on SuiteContext as well.

Signed-off-by: sangwook <rewq5991@gmail.com>
---
 doc/api/test.md                               | 26 +++++++++++++++++++
 lib/internal/test_runner/test.js              |  9 +++++++
 .../fixtures/test-runner/worker-id/test-1.mjs |  8 +++++-
 .../parallel/test-runner-tags-inheritance.mjs |  8 ++++++
 4 files changed, 50 insertions(+), 1 deletion(-)

diff --git a/doc/api/test.md b/doc/api/test.md
index b80bdb372dc2..32b0c748fdd1 100644
--- a/doc/api/test.md
+++ b/doc/api/test.md
@@ -5141,6 +5141,32 @@ The attempt number of the suite. This value is zero-based, so the first attempt
 the second attempt is `1`, and so on. This property is useful in conjunction with the
 `--test-rerun-failures` option to determine the attempt number of the current run.
 
+### `context.tags`
+
+<!-- YAML
+added: REPLACEME
+-->
+
+> Stability: 1.0 - Early development
+
+* Type: {string\[]}
+
+A frozen array of the suite's flattened lowercased tags, in declaration
+order, including any tags inherited from ancestor suites. Empty when the
+suite has no tags. See [Test tags][].
+
+### `context.workerId`
+
+<!-- YAML
+added: REPLACEME
+-->
+
+* Type: {number|undefined}
+
+The unique identifier of the worker running the current test file. This value
+is derived from the `NODE_TEST_WORKER_ID` environment variable, and is
+`undefined` when not running in a test context.
+
 ### `context.diagnostic(message)`
 
 <!-- YAML
diff --git a/lib/internal/test_runner/test.js b/lib/internal/test_runner/test.js
index 1b0956e4253c..b0db6c3bc7ed 100644
--- a/lib/internal/test_runner/test.js
+++ b/lib/internal/test_runner/test.js
@@ -536,6 +536,15 @@ class SuiteContext {
     return this.#suite.attempt ?? 0;
   }
 
+  get tags() {
+    return this.#suite.tags;
+  }
+
+  get workerId() {
+    const envWorkerId = process.env.NODE_TEST_WORKER_ID;
+    return Number(envWorkerId) || undefined;
+  }
+
   diagnostic(message) {
     this.#suite.diagnostic(message);
   }
diff --git a/test/fixtures/test-runner/worker-id/test-1.mjs b/test/fixtures/test-runner/worker-id/test-1.mjs
index 7e6f40f2b18c..1458e2f45eaf 100644
--- a/test/fixtures/test-runner/worker-id/test-1.mjs
+++ b/test/fixtures/test-runner/worker-id/test-1.mjs
@@ -1,4 +1,4 @@
-import { test } from 'node:test';
+import { describe, test } from 'node:test';
 
 test('worker ID is available as environment variable', (t) => {
 	const workerId = process.env.NODE_TEST_WORKER_ID;
@@ -24,3 +24,9 @@ test('worker ID is available via context', (t) => {
 		throw new Error(`context.workerId (${workerId}) should match NODE_TEST_WORKER_ID (${envWorkerId})`);
 	}
 });
+
+describe('worker ID is available via suite context', (s) => {
+	if (s.workerId !== Number(process.env.NODE_TEST_WORKER_ID)) {
+		throw new Error(`suite context.workerId (${s.workerId}) should match NODE_TEST_WORKER_ID (${process.env.NODE_TEST_WORKER_ID})`);
+	}
+});
diff --git a/test/parallel/test-runner-tags-inheritance.mjs b/test/parallel/test-runner-tags-inheritance.mjs
index 0285ad97b678..2e73a821b92e 100644
--- a/test/parallel/test-runner-tags-inheritance.mjs
+++ b/test/parallel/test-runner-tags-inheritance.mjs
@@ -46,6 +46,14 @@ test('multi-level nesting flattens by union', () => {
   });
 });
 
+test('suite context exposes inherited tags', () => {
+  describe('outer', { tags: ['a'] }, () => {
+    describe('mid', { tags: ['b'] }, (s) => {
+      assert.deepStrictEqual(s.tags, ['a', 'b']);
+    });
+  });
+});
+
 test('child without own tags inherits parent set unchanged', () => {
   describe('outer', { tags: ['db', 'fast'] }, () => {
     it('child', (t) => {

From 7d2ed69033c5fa8b6edc165c8f291db5583a2567 Mon Sep 17 00:00:00 2001
From: sangwook <rewq5991@gmail.com>
Date: Tue, 10 Nov 2026 07:21:31 +0900
Subject: [PATCH 2/3] test: check child tags do not override SuiteContext tags

Signed-off-by: sangwook <rewq5991@gmail.com>
---
 test/parallel/test-runner-tags-inheritance.mjs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/test/parallel/test-runner-tags-inheritance.mjs b/test/parallel/test-runner-tags-inheritance.mjs
index 2e73a821b92e..83998eb45626 100644
--- a/test/parallel/test-runner-tags-inheritance.mjs
+++ b/test/parallel/test-runner-tags-inheritance.mjs
@@ -49,6 +49,9 @@ test('multi-level nesting flattens by union', () => {
 test('suite context exposes inherited tags', () => {
   describe('outer', { tags: ['a'] }, () => {
     describe('mid', { tags: ['b'] }, (s) => {
+      it('child tags do not override suite tags', { tags: ['c'] }, (t) => {
+        assert.deepStrictEqual(t.tags, ['a', 'b', 'c']);
+      });
       assert.deepStrictEqual(s.tags, ['a', 'b']);
     });
   });

From 6679c913c67c90c1daf3dd0477598c8480fcc9f5 Mon Sep 17 00:00:00 2001
From: sangwook <rewq5991@gmail.com>
Date: Tue, 10 Nov 2026 20:50:32 +0900
Subject: [PATCH 3/3] test: check suite tags inside the child test

Signed-off-by: sangwook <rewq5991@gmail.com>
---
 test/parallel/test-runner-tags-inheritance.mjs | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/test/parallel/test-runner-tags-inheritance.mjs b/test/parallel/test-runner-tags-inheritance.mjs
index 83998eb45626..703e4021606d 100644
--- a/test/parallel/test-runner-tags-inheritance.mjs
+++ b/test/parallel/test-runner-tags-inheritance.mjs
@@ -49,14 +49,20 @@ test('multi-level nesting flattens by union', () => {
 test('suite context exposes inherited tags', () => {
   describe('outer', { tags: ['a'] }, () => {
     describe('mid', { tags: ['b'] }, (s) => {
-      it('child tags do not override suite tags', { tags: ['c'] }, (t) => {
-        assert.deepStrictEqual(t.tags, ['a', 'b', 'c']);
-      });
       assert.deepStrictEqual(s.tags, ['a', 'b']);
     });
   });
 });
 
+test('child tags do not leak into the suite context', () => {
+  describe('suite', { tags: ['a'] }, (s) => {
+    it('child', { tags: ['b'] }, (t) => {
+      assert.deepStrictEqual(t.tags, ['a', 'b']);
+      assert.deepStrictEqual(s.tags, ['a']);
+    });
+  });
+});
+
 test('child without own tags inherits parent set unchanged', () => {
   describe('outer', { tags: ['db', 'fast'] }, () => {
     it('child', (t) => {