test: test runner run plan

PR-URL: #57304
Reviewed-By: Colin Ihrig <cjihrig@gmail.com>
Reviewed-By: Moshe Atlow <moshe@atlow.co.il>

Author: pmarchini

test/fixtures/test-runner/plan/less.mjs

@@ -0,0 +1,7 @@
+importtestfrom'node:test';
+
+test('less assertions than planned',(t)=>{
+t.plan(2);
+t.assert.ok(true,'only one assertion');
+// Missing second assertion
+});

test/fixtures/test-runner/plan/match.mjs

@@ -0,0 +1,7 @@
+importtestfrom'node:test';
+
+test('matching assertions',(t)=>{
+t.plan(2);
+t.assert.ok(true,'first assertion');
+t.assert.ok(true,'second assertion');
+});

test/fixtures/test-runner/plan/more.mjs

@@ -0,0 +1,7 @@
+importtestfrom'node:test';
+
+test('more assertions than planned',(t)=>{
+t.plan(1);
+t.assert.ok(true,'first assertion');
+t.assert.ok(true,'extra assertion');// This should cause failure
+});

test/fixtures/test-runner/plan/nested-subtests.mjs

@@ -0,0 +1,14 @@
+importtestfrom'node:test';
+
+test('deeply nested tests',async(t)=>{
+t.plan(1);
+
+awaitt.test('level 1',async(t)=>{
+t.plan(1);
+
+awaitt.test('level 2',(t)=>{
+t.plan(1);
+t.assert.ok(true,'deepest assertion');
+});
+});
+});

test/fixtures/test-runner/plan/plan-via-options.mjs

@@ -0,0 +1,9 @@
+importtestfrom'node:test';
+
+test('failing planning by options',{plan: 1},()=>{
+// Should fail - no assertions
+});
+
+test('passing planning by options',{plan: 1},(t)=>{
+t.assert.ok(true);
+});

test/fixtures/test-runner/plan/streaming.mjs

@@ -0,0 +1,20 @@
+importtestfrom'node:test';
+import{Readable}from'node:stream';
+
+test('planning with streams',(t,done)=>{
+function*generate(){
+yield'a';
+yield'b';
+yield'c';
+}
+constexpected=['a','b','c'];
+t.plan(expected.length);
+conststream=Readable.from(generate());
+stream.on('data',(chunk)=>{
+t.assert.strictEqual(chunk,expected.shift());
+});
+
+stream.on('end',()=>{
+done();
+});
+});

test/fixtures/test-runner/plan/subtest.mjs

@@ -0,0 +1,9 @@
+importtestfrom'node:test';
+
+test('parent test',async(t)=>{
+t.plan(1);
+awaitt.test('child test',(t)=>{
+t.plan(1);
+t.assert.ok(true,'child assertion');
+});
+});

test/fixtures/test-runner/plan/timeout-basic.mjs

@@ -0,0 +1,15 @@
+importtestfrom'node:test';
+
+test('planning with wait should PASS within timeout',async(t)=>{
+t.plan(1,{wait: 5000});
+setTimeout(()=>{
+t.assert.ok(true);
+},250);
+});
+
+test('planning with wait should FAIL within timeout',async(t)=>{
+t.plan(1,{wait: 5000});
+setTimeout(()=>{
+t.assert.ok(false);
+},250);
+});

test/fixtures/test-runner/plan/timeout-expired.mjs

@@ -0,0 +1,8 @@
+importtestfrom'node:test';
+
+test('planning should FAIL when wait time expires before plan is met',(t)=>{
+t.plan(2,{wait: 500});
+setTimeout(()=>{
+t.assert.ok(true);
+},30_000).unref();
+});

test/fixtures/test-runner/plan/timeout-wait-false.mjs

@@ -0,0 +1,11 @@
+importtestfrom'node:test';
+
+test('should not wait for assertions and fail immediately',async(t)=>{
+t.plan(1,{wait: false});
+
+// Set up an async operation that won't complete before the test finishes
+// Since wait:false, the test should fail immediately without waiting
+setTimeout(()=>{
+t.assert.ok(true);
+},1000).unref();
+});