test: update startCLI to set --port=0 by default

dario-piotrowicz · dario-piotrowicz · commit bee555ad971e · 2025-07-13T02:09:34.000+01:00
update the `startCLI` debugging testing utility to set by default
the port to use to `0` (i.e. a random port)
diff --git a/test/common/debugger.js b/test/common/debugger.js
@@ -20,10 +20,14 @@ function isPreBreak(output) {
   return /Break on start/.test(output) && /1 \(function \(exports/.test(output);
 }
 
-function startCLI(args, flags = [], spawnOpts = {}) {
+function startCLI(args, flags = [], spawnOpts = {}, opts = { randomPort: true }) {
   let stderrOutput = '';
-  const child =
-    spawn(process.execPath, [...flags, 'inspect', ...args], spawnOpts);
+  const child = spawn(process.execPath, [
+    ...flags,
+    'inspect',
+    ...(opts.randomPort !== false ? ['--port=0'] : []),
+    ...args,
+  ], spawnOpts);
 
   const outputBuffer = [];
   function bufferOutput(chunk) {
diff --git a/test/parallel/test-debugger-address.mjs b/test/parallel/test-debugger-address.mjs
@@ -55,7 +55,7 @@ function launchTarget(...args) {
   try {
     const { childProc, host, port } = await launchTarget('--inspect=0', script);
     target = childProc;
-    cli = startCLI([`${host || '127.0.0.1'}:${port}`]);
+    cli = startCLI([`${host || '127.0.0.1'}:${port}`], [], {}, { randomPort: false });
     await cli.waitForPrompt();
     await cli.command('sb("alive.js", 3)');
     await cli.waitFor(/break/);
diff --git a/test/parallel/test-debugger-auto-resume.mjs b/test/parallel/test-debugger-auto-resume.mjs
@@ -21,9 +21,7 @@ addLibraryPath(process.env);
   };
   env.NODE_INSPECT_RESUME_ON_START = '1';
 
-  const cli = startCLI(['--port=0', script], [], {
-    env,
-  });
+  const cli = startCLI([script], [], { env });
 
   await cli.waitForInitialBreak();
   deepStrictEqual(cli.breakInfo, {
diff --git a/test/parallel/test-debugger-backtrace.js b/test/parallel/test-debugger-backtrace.js
@@ -13,7 +13,7 @@ const path = require('path');
 {
   const scriptFullPath = fixtures.path('debugger', 'backtrace.js');
   const script = path.relative(process.cwd(), scriptFullPath);
-  const cli = startCLI(['--port=0', script]);
+  const cli = startCLI([script]);
 
   async function runTest() {
     try {
diff --git a/test/parallel/test-debugger-break.js b/test/parallel/test-debugger-break.js
@@ -11,7 +11,7 @@ const path = require('path');
 
 const scriptFullPath = fixtures.path('debugger', 'break.js');
 const script = path.relative(process.cwd(), scriptFullPath);
-const cli = startCLI(['--port=0', script]);
+const cli = startCLI([script]);
 
 (async () => {
   await cli.waitForInitialBreak();
diff --git a/test/parallel/test-debugger-breakpoint-exists.js b/test/parallel/test-debugger-breakpoint-exists.js
@@ -9,7 +9,7 @@ const startCLI = require('../common/debugger');
 
 // Test for "Breakpoint at specified location already exists" error.
 const script = fixtures.path('debugger', 'three-lines.js');
-const cli = startCLI(['--port=0', script]);
+const cli = startCLI([script]);
 
 (async () => {
   try {
diff --git a/test/parallel/test-debugger-clear-breakpoints.js b/test/parallel/test-debugger-clear-breakpoints.js
@@ -13,7 +13,7 @@ const path = require('path');
 {
   const scriptFullPath = fixtures.path('debugger', 'break.js');
   const script = path.relative(process.cwd(), scriptFullPath);
-  const cli = startCLI(['--port=0', script]);
+  const cli = startCLI([script]);
 
   function onFatal(error) {
     cli.quit();
diff --git a/test/parallel/test-debugger-exceptions.js b/test/parallel/test-debugger-exceptions.js
@@ -13,7 +13,7 @@ const path = require('path');
 {
   const scriptFullPath = fixtures.path('debugger', 'exceptions.js');
   const script = path.relative(process.cwd(), scriptFullPath);
-  const cli = startCLI(['--port=0', script]);
+  const cli = startCLI([script]);
 
   (async () => {
     try {
diff --git a/test/parallel/test-debugger-exec-scope.mjs b/test/parallel/test-debugger-exec-scope.mjs
@@ -7,7 +7,7 @@ import startCLI from '../common/debugger.js';
 
 import assert from 'assert';
 
-const cli = startCLI(['--port=0', path('debugger/backtrace.js')]);
+const cli = startCLI([path('debugger/backtrace.js')]);
 
 try {
   await cli.waitForInitialBreak();
diff --git a/test/parallel/test-debugger-exec.js b/test/parallel/test-debugger-exec.js
@@ -8,7 +8,7 @@ const startCLI = require('../common/debugger');
 
 const assert = require('assert');
 
-const cli = startCLI(['--port=0', fixtures.path('debugger/alive.js')]);
+const cli = startCLI([fixtures.path('debugger/alive.js')]);
 
 async function waitInitialBreak() {
   try {
diff --git a/test/parallel/test-debugger-extract-function-name.mjs b/test/parallel/test-debugger-extract-function-name.mjs
@@ -7,7 +7,7 @@ import startCLI from '../common/debugger.js';
 
 import assert from 'assert';
 
-const cli = startCLI(['--port=0', path('debugger', 'three-lines.js')]);
+const cli = startCLI([path('debugger', 'three-lines.js')]);
 
 try {
   await cli.waitForInitialBreak();
diff --git a/test/parallel/test-debugger-heap-profiler.js b/test/parallel/test-debugger-heap-profiler.js
@@ -16,7 +16,7 @@ const filename = tmpdir.resolve('node.heapsnapshot');
 // Heap profiler take snapshot.
 {
   const opts = { cwd: tmpdir.path };
-  const cli = startCLI(['--port=0', fixtures.path('debugger/empty.js')], [], opts);
+  const cli = startCLI([fixtures.path('debugger/empty.js')], [], opts);
 
   async function waitInitialBreak() {
     try {
diff --git a/test/parallel/test-debugger-help.mjs b/test/parallel/test-debugger-help.mjs
@@ -7,7 +7,7 @@ import startCLI from '../common/debugger.js';
 
 import assert from 'assert';
 
-const cli = startCLI(['--port=0', path('debugger', 'empty.js')]);
+const cli = startCLI([path('debugger', 'empty.js')]);
 
 try {
   await cli.waitForInitialBreak();
diff --git a/test/parallel/test-debugger-invalid-json.mjs b/test/parallel/test-debugger-invalid-json.mjs
@@ -17,7 +17,7 @@ const host = '127.0.0.1';
 
   server.listen(0, mustCall(async () => {
     const port = server.address().port;
-    const cli = startCLI([`${host}:${port}`]);
+    const cli = startCLI([`${host}:${port}`], [], {}, { randomPort: false });
     try {
       const code = await cli.quit();
       assert.strictEqual(code, 1);
@@ -35,7 +35,7 @@ const host = '127.0.0.1';
 
   server.listen(0, host, mustCall(async () => {
     const port = server.address().port;
-    const cli = startCLI([`${host}:${port}`]);
+    const cli = startCLI([`${host}:${port}`], [], {}, { randomPort: false });
     try {
       const code = await cli.quit();
       assert.strictEqual(code, 1);
diff --git a/test/parallel/test-debugger-list.js b/test/parallel/test-debugger-list.js
@@ -8,7 +8,7 @@ const startCLI = require('../common/debugger');
 
 const assert = require('assert');
 
-const cli = startCLI(['--port=0', fixtures.path('debugger/three-lines.js')]);
+const cli = startCLI([fixtures.path('debugger/three-lines.js')]);
 
 (async () => {
   await cli.waitForInitialBreak();
diff --git a/test/parallel/test-debugger-low-level.js b/test/parallel/test-debugger-low-level.js
@@ -9,7 +9,7 @@ const assert = require('assert');
 
 // Debugger agent direct access.
 {
-  const cli = startCLI(['--port=0', fixtures.path('debugger/three-lines.js')]);
+  const cli = startCLI([fixtures.path('debugger/three-lines.js')]);
   const scriptPattern = /^\* (\d+): \S+debugger(?:\/|\\)three-lines\.js/m;
 
   async function testDebuggerLowLevel() {
diff --git a/test/parallel/test-debugger-object-type-remote-object.js b/test/parallel/test-debugger-object-type-remote-object.js
@@ -8,7 +8,7 @@ const startCLI = require('../common/debugger');
 
 const assert = require('assert');
 
-const cli = startCLI(['--port=0', fixtures.path('debugger/empty.js')]);
+const cli = startCLI([fixtures.path('debugger/empty.js')]);
 
 (async () => {
   await cli.waitForInitialBreak();
diff --git a/test/parallel/test-debugger-preserve-breaks.js b/test/parallel/test-debugger-preserve-breaks.js
@@ -14,7 +14,7 @@ const script = path.relative(process.cwd(), scriptFullPath);
 
 // Run after quit.
 const runTest = async () => {
-  const cli = startCLI(['--port=0', script]);
+  const cli = startCLI([script]);
   try {
     await cli.waitForInitialBreak();
     await cli.waitForPrompt();
diff --git a/test/parallel/test-debugger-profile-command.js b/test/parallel/test-debugger-profile-command.js
@@ -10,7 +10,7 @@ const assert = require('assert');
 const fs = require('fs');
 const path = require('path');
 
-const cli = startCLI(['--port=0', fixtures.path('debugger/empty.js')]);
+const cli = startCLI([fixtures.path('debugger/empty.js')]);
 
 const rootDir = path.resolve(__dirname, '..', '..');
 
diff --git a/test/parallel/test-debugger-profile.js b/test/parallel/test-debugger-profile.js
@@ -14,7 +14,7 @@ function delay(ms) {
 
 // Profiles.
 {
-  const cli = startCLI(['--port=0', fixtures.path('debugger/empty.js')], [], {
+  const cli = startCLI([fixtures.path('debugger/empty.js')], [], {
     env: {
       ...process.env,
       // When this test is run with NODE_V8_COVERAGE, it clobbers the inspector
diff --git a/test/parallel/test-debugger-random-port-with-inspect-port.js b/test/parallel/test-debugger-random-port-with-inspect-port.js
@@ -10,7 +10,7 @@ const assert = require('assert');
 // Random port with --inspect-port=0.
 const script = fixtures.path('debugger', 'three-lines.js');
 
-const cli = startCLI(['--inspect-port=0', script]);
+const cli = startCLI([script]);
 
 (async () => {
   await cli.waitForInitialBreak();
diff --git a/test/parallel/test-debugger-random-port.js b/test/parallel/test-debugger-random-port.js
@@ -12,7 +12,7 @@ const assert = require('assert');
 {
   const script = fixtures.path('debugger', 'three-lines.js');
 
-  const cli = startCLI(['--port=0', script]);
+  const cli = startCLI([script]);
 
   cli.waitForInitialBreak()
     .then(() => cli.waitForPrompt())
diff --git a/test/parallel/test-debugger-restart-message.js b/test/parallel/test-debugger-restart-message.js
@@ -14,7 +14,7 @@ const startCLI = require('../common/debugger');
 // Using `restart` should result in only one "Connect/For help" message.
 {
   const script = fixtures.path('debugger', 'three-lines.js');
-  const cli = startCLI(['--port=0', script]);
+  const cli = startCLI([script]);
 
   const listeningRegExp = /Debugger listening on/g;
 
diff --git a/test/parallel/test-debugger-run-after-quit-restart.js b/test/parallel/test-debugger-run-after-quit-restart.js
@@ -13,7 +13,7 @@ const path = require('path');
 {
   const scriptFullPath = fixtures.path('debugger', 'three-lines.js');
   const script = path.relative(process.cwd(), scriptFullPath);
-  const cli = startCLI(['--port=0', script]);
+  const cli = startCLI([script]);
 
   function onFatal(error) {
     cli.quit();
diff --git a/test/parallel/test-debugger-sb-before-load.js b/test/parallel/test-debugger-sb-before-load.js
@@ -17,7 +17,7 @@ const script = path.relative(process.cwd(), scriptFullPath);
 const otherScriptFullPath = fixtures.path('debugger', 'cjs', 'other.js');
 const otherScript = path.relative(process.cwd(), otherScriptFullPath);
 
-const cli = startCLI(['--port=0', script]);
+const cli = startCLI([script]);
 
 (async () => {
   await cli.waitForInitialBreak();
diff --git a/test/parallel/test-debugger-scripts.js b/test/parallel/test-debugger-scripts.js
@@ -11,7 +11,7 @@ const assert = require('assert');
 // List scripts.
 {
   const script = fixtures.path('debugger', 'three-lines.js');
-  const cli = startCLI(['--port=0', script]);
+  const cli = startCLI([script]);
 
   (async () => {
     try {
diff --git a/test/parallel/test-debugger-set-context-line-number.mjs b/test/parallel/test-debugger-set-context-line-number.mjs
@@ -7,7 +7,7 @@ import startCLI from '../common/debugger.js';
 import assert from 'assert';
 
 const script = path('debugger', 'twenty-lines.js');
-const cli = startCLI(['--port=0', script]);
+const cli = startCLI([script]);
 
 function onFatal(error) {
   cli.quit();
diff --git a/test/parallel/test-debugger-unavailable-port.js b/test/parallel/test-debugger-unavailable-port.js
@@ -19,7 +19,7 @@ const { createServer } = require('net');
 
   try {
     const script = fixtures.path('debugger', 'three-lines.js');
-    const cli = startCLI([`--port=${port}`, script]);
+    const cli = startCLI([`--port=${port}`, script], [], {}, { randomPort: false });
     const code = await cli.quit();
 
     assert.doesNotMatch(
diff --git a/test/parallel/test-debugger-use-strict.js b/test/parallel/test-debugger-use-strict.js
@@ -11,7 +11,7 @@ const assert = require('assert');
 // Test for files that start with strict directive.
 {
   const script = fixtures.path('debugger', 'use-strict.js');
-  const cli = startCLI(['--port=0', script]);
+  const cli = startCLI([script]);
 
   function onFatal(error) {
     cli.quit();
diff --git a/test/parallel/test-debugger-watch-validation.js b/test/parallel/test-debugger-watch-validation.js
@@ -8,7 +8,7 @@ const startCLI = require('../common/debugger');
 
 const assert = require('assert');
 
-const cli = startCLI(['--port=0', fixtures.path('debugger/break.js')]);
+const cli = startCLI([fixtures.path('debugger/break.js')]);
 
 (async () => {
   await cli.waitForInitialBreak();
diff --git a/test/parallel/test-debugger-watchers.mjs b/test/parallel/test-debugger-watchers.mjs
@@ -7,7 +7,7 @@ import startCLI from '../common/debugger.js';
 import assert from 'assert';
 
 const script = path('debugger', 'break.js');
-const cli = startCLI(['--port=0', script]);
+const cli = startCLI([script]);
 
 function onFatal(error) {
   cli.quit();
diff --git a/test/sequential/test-debugger-custom-port.js b/test/sequential/test-debugger-custom-port.js
@@ -11,7 +11,7 @@ const assert = require('assert');
 // Custom port.
 const script = fixtures.path('debugger', 'three-lines.js');
 
-const cli = startCLI([`--port=${common.PORT}`, script]);
+const cli = startCLI([`--port=${common.PORT}`, script], [], {}, { randomPort: false });
 (async function() {
   try {
     await cli.waitForInitialBreak();
diff --git a/test/sequential/test-debugger-invalid-args.js b/test/sequential/test-debugger-invalid-args.js
@@ -9,15 +9,15 @@ const assert = require('assert');
 
 // Launch CLI w/o args.
 (async () => {
-  const cli = startCLI([]);
+  const cli = startCLI([], [], {}, { randomPort: false });
   const code = await cli.quit();
   assert.strictEqual(code, 9);
   assert.match(cli.output, /^Usage:/, 'Prints usage info');
 })().then(common.mustCall());
 
 // Launch w/ invalid host:port.
 (async () => {
-  const cli = startCLI([`localhost:${common.PORT}`]);
+  const cli = startCLI([`localhost:${common.PORT}`], [], {}, { randomPort: false });
   const code = await cli.quit();
   assert.match(
     cli.output,
diff --git a/test/sequential/test-debugger-launch.mjs b/test/sequential/test-debugger-launch.mjs
@@ -8,7 +8,7 @@ import startCLI from '../common/debugger.js';
 import assert from 'assert';
 
 const script = path('debugger', 'three-lines.js');
-const cli = startCLI([script]);
+const cli = startCLI([script], [], {}, { randomPort: false });
 try {
   await cli.waitForInitialBreak();
   await cli.waitForPrompt();
diff --git a/test/sequential/test-debugger-pid.js b/test/sequential/test-debugger-pid.js
@@ -13,7 +13,7 @@ const script = fixtures.path('debugger', 'alive.js');
 
 const runTest = async () => {
   const target = spawn(process.execPath, [script]);
-  const cli = startCLI(['-p', `${target.pid}`]);
+  const cli = startCLI(['-p', `${target.pid}`], [], {}, { randomPort: false });
 
   try {
     await cli.waitForPrompt();

Original file line number	Diff line number	Diff line change
`@@ -13,7 +13,7 @@ const path = require('path');`
`13`	`13`	`{`
`14`	`14`	`const scriptFullPath = fixtures.path('debugger', 'backtrace.js');`
`15`	`15`	`const script = path.relative(process.cwd(), scriptFullPath);`
`16`		`- const cli = startCLI(['--port=0', script]);`
	`16`	`+ const cli = startCLI([script]);`
`17`	`17`
`18`	`18`	`async function runTest() {`
`19`	`19`	`try {`