tape-six 1.7.3 → 1.7.5

package/README.md

@@ -420,6 +420,8 @@ Test output can be controlled by flags. See [Supported flags](https://github.com
 
 The most recent releases:
 
+- 1.7.5 _Refactored CLI runners, added `--info` option, renamed `dontCaptureConsole` to `noConsoleCapture`._
+- 1.7.4 _Bug fixes: uncaught exception handling, `StopTest` suppression in parallel runners._
 - 1.7.3 _Bug fixes in reporters, runners, and assertions. Documentation corrections and improvements._
 - 1.7.2 _Minor internal refactoring and fixes._
 - 1.7.1 _Added AI support, added timeout to start test runners, fixed some bugs in the sequential test runner._

package/TESTING.md

@@ -464,6 +464,7 @@ deno run -A tests/test-example.js     # Deno
 npx tape6 --flags FO                  # parallel (worker threads)
 npx tape6-seq --flags FO              # sequential (in-process, no workers)
 npx tape6 --par 4 --flags FO          # limit to 4 workers
+npx tape6 --info --flags FO           # show config and exit without running tests
 ```
 
 **`tape6` vs `tape6-seq`**: The default `tape6` runner spawns worker threads to run test files in parallel — faster, but each file runs in its own isolated context. `tape6-seq` runs all test files sequentially in a single process — slower, but useful for debugging, for tests that share state, or when worker threads are unavailable.

package/bin/tape6-bun.js

@@ -2,24 +2,14 @@
 
 import {fileURLToPath} from 'node:url';
 
-import {
-  resolveTests,
-  resolvePatterns,
-  getReporterFileName,
-  getReporterType
-} from '../src/utils/config.js';
+import {getOptions, initFiles, initReporter, showInfo} from '../src/utils/config.js';
 
 import {getReporter, setReporter} from '../src/test.js';
 import {selectTimer} from '../src/utils/timer.js';
 
 import TestWorker from '../src/runners/bun/TestWorker.js';
 
-const options = {},
-  rootFolder = Bun.cwd;
-
-let flags = '',
-  parallel = '',
-  files = [];
+const rootFolder = Bun.cwd;
 
 const showSelf = () => {
   const self = new URL(import.meta.url);
@@ -31,100 +21,35 @@ const showSelf = () => {
   process.exit(0);
 };
 
-const config = () => {
-  if (Bun.argv.includes('--self')) showSelf();
-
-  const optionNames = {
-    f: 'failureOnly',
-    t: 'showTime',
-    b: 'showBanner',
-    d: 'showData',
-    o: 'failOnce',
-    n: 'showAssertNumber',
-    m: 'monochrome',
-    c: 'dontCaptureConsole',
-    h: 'hideStreams'
-  };
-
-  let parIsSet = false;
-
-  for (let i = 2; i < Bun.argv.length; ++i) {
-    const arg = Bun.argv[i];
-    if (arg == '-f' || arg == '--flags') {
-      if (++i < Bun.argv.length) {
-        flags += Bun.argv[i];
-      }
-      continue;
-    }
-    if (arg == '-p' || arg == '--par') {
-      if (++i < Bun.argv.length) {
-        parallel = Bun.argv[i];
-        parIsSet = true;
-        if (!parallel || isNaN(parallel)) {
-          parallel = '';
-          parIsSet = false;
-        }
-      }
-      continue;
-    }
-    files.push(arg);
-  }
+const main = async () => {
+  const currentOptions = getOptions({
+    '--self': showSelf,
+    '--info': {isValueRequired: false}
+  });
 
-  flags = (Bun.env.TAPE6_FLAGS || '') + flags;
-  for (let i = 0; i < flags.length; ++i) {
-    const option = flags[i].toLowerCase(),
-      name = optionNames[option];
-    if (typeof name == 'string') options[name] = option !== flags[i];
-  }
-  options.flags = flags;
+  const [files] = await Promise.all([
+    initFiles(currentOptions.files, rootFolder),
+    initReporter(getReporter, setReporter, currentOptions.flags),
+    selectTimer()
+  ]);
 
-  if (!parIsSet) {
-    parallel = Bun.env.TAPE6_PAR || parallel;
-  }
-  if (parallel) {
-    parallel = Math.max(0, +parallel);
-    if (parallel === Infinity) parallel = 0;
-  } else {
-    parallel = 0;
-  }
-  if (!parallel) parallel = globalThis.navigator?.hardwareConcurrency || 1;
-};
+  process.on('uncaughtException', (error, origin) => {
+    console.error('UNHANDLED ERROR:', origin, error);
+    process.exit(1);
+  });
 
-const init = async () => {
-  const currentReporter = getReporter();
-  if (!currentReporter) {
-    const reporterType = getReporterType(),
-      reporterFile = getReporterFileName(reporterType),
-      CustomReporter = (await import('../src/reporters/' + reporterFile)).default,
-      hasColors = !(
-        options.monochrome ||
-        Bun.env.NO_COLOR ||
-        Bun.env.NODE_DISABLE_COLORS ||
-        Bun.env.FORCE_COLOR === '0'
-      ),
-      customOptions = reporterType === 'tap' ? {useJson: true, hasColors} : {...options, hasColors},
-      customReporter = new CustomReporter(customOptions);
-    setReporter(customReporter);
+  if (currentOptions.optionFlags['--info'] === '') {
+    showInfo(currentOptions, files);
+    process.exit(0);
   }
 
-  if (files.length) {
-    files = await resolvePatterns(rootFolder, files);
-  } else {
-    files = await resolveTests(rootFolder, 'bun');
+  if (!files.length) {
+    console.log('No files found.');
+    process.exit(1);
   }
-};
-
-const main = async () => {
-  config();
-  await init();
-  await selectTimer();
-
-  process.on('uncaughtException', (error, origin) =>
-    console.error('UNHANDLED ERROR:', origin, error)
-  );
 
   const reporter = getReporter(),
-    worker = new TestWorker(reporter, parallel, options);
+    worker = new TestWorker(reporter, currentOptions.parallel, currentOptions.flags);
 
   reporter.report({type: 'test', test: 0});
 

package/bin/tape6-deno.js

@@ -2,24 +2,14 @@
 
 import {fileURLToPath} from 'node:url';
 
-import {
-  resolveTests,
-  resolvePatterns,
-  getReporterFileName,
-  getReporterType
-} from '../src/utils/config.js';
+import {getOptions, initFiles, initReporter, showInfo} from '../src/utils/config.js';
 
 import {getReporter, setReporter} from '../src/test.js';
 import {selectTimer} from '../src/utils/timer.js';
 
 import TestWorker from '../src/runners/deno/TestWorker.js';
 
-const options = {},
-  rootFolder = Deno.cwd();
-
-let flags = '',
-  parallel = '',
-  files = [];
+const rootFolder = Deno.cwd();
 
 const showSelf = () => {
   const self = new URL(import.meta.url);
@@ -31,101 +21,35 @@ const showSelf = () => {
   Deno.exit(0);
 };
 
-const config = () => {
-  if (Deno.args.includes('--self')) showSelf();
-
-  const optionNames = {
-    f: 'failureOnly',
-    t: 'showTime',
-    b: 'showBanner',
-    d: 'showData',
-    o: 'failOnce',
-    n: 'showAssertNumber',
-    m: 'monochrome',
-    c: 'dontCaptureConsole',
-    h: 'hideStreams'
-  };
-
-  let parIsSet = false;
-
-  for (let i = 0; i < Deno.args.length; ++i) {
-    const arg = Deno.args[i];
-    if (arg == '-f' || arg == '--flags') {
-      if (++i < Deno.args.length) {
-        flags += Deno.args[i];
-      }
-      continue;
-    }
-    if (arg == '-p' || arg == '--par') {
-      if (++i < Deno.args.length) {
-        parallel = Deno.args[i];
-        parIsSet = true;
-        if (!parallel || isNaN(parallel)) {
-          parallel = '';
-          parIsSet = false;
-        }
-      }
-      continue;
-    }
-    files.push(arg);
-  }
-
-  flags = (Deno.env.get('TAPE6_FLAGS') || '') + flags;
-  for (let i = 0; i < flags.length; ++i) {
-    const option = flags[i].toLowerCase(),
-      name = optionNames[option];
-    if (typeof name == 'string') options[name] = option !== flags[i];
-  }
-  options.flags = flags;
-
-  if (!parIsSet) {
-    parallel = Deno.env.get('TAPE6_PAR') || parallel;
-  }
-  if (parallel) {
-    parallel = Math.max(0, +parallel);
-    if (parallel === Infinity) parallel = 0;
-  } else {
-    parallel = 0;
-  }
-  if (!parallel) parallel = globalThis.navigator?.hardwareConcurrency || 1;
-};
-
-const init = async () => {
-  const currentReporter = getReporter();
-  if (!currentReporter) {
-    const reporterType = getReporterType(),
-      reporterFile = getReporterFileName(reporterType),
-      CustomReporter = (await import('../src/reporters/' + reporterFile)).default,
-      hasColors = !(
-        options.monochrome ||
-        Deno.env.get('NO_COLOR') ||
-        Deno.env.get('NODE_DISABLE_COLORS') ||
-        Deno.env.get('FORCE_COLOR') === '0'
-      ),
-      customOptions = reporterType === 'tap' ? {useJson: true, hasColors} : {...options, hasColors},
-      customReporter = new CustomReporter(customOptions);
-    setReporter(customReporter);
-  }
-
-  if (files.length) {
-    files = await resolvePatterns(rootFolder, files);
-  } else {
-    files = await resolveTests(rootFolder, 'deno');
-  }
-};
-
 const main = async () => {
-  config();
-  await init();
-  await selectTimer();
+  const currentOptions = getOptions({
+    '--self': showSelf,
+    '--info': {isValueRequired: false}
+  });
+
+  const [files] = await Promise.all([
+    initFiles(currentOptions.files, rootFolder),
+    initReporter(getReporter, setReporter, currentOptions.flags),
+    selectTimer()
+  ]);
 
   addEventListener('error', event => {
     console.log('UNHANDLED ERROR:', event.message);
     event.preventDefault();
   });
 
+  if (currentOptions.optionFlags['--info'] === '') {
+    showInfo(currentOptions, files);
+    Deno.exit(0);
+  }
+
+  if (!files.length) {
+    console.log('No files found.');
+    Deno.exit(1);
+  }
+
   const reporter = getReporter(),
-    worker = new TestWorker(reporter, parallel, options);
+    worker = new TestWorker(reporter, currentOptions.parallel, currentOptions.flags);
 
   reporter.report({type: 'test', test: 0});
 

package/bin/tape6-node.js

@@ -1,27 +1,16 @@
 #!/usr/bin/env node
 
 import process from 'node:process';
-import os from 'node:os';
 import {fileURLToPath} from 'node:url';
 
-import {
-  resolveTests,
-  resolvePatterns,
-  getReporterFileName,
-  getReporterType
-} from '../src/utils/config.js';
+import {getOptions, initFiles, initReporter, showInfo} from '../src/utils/config.js';
 
 import {getReporter, setReporter} from '../src/test.js';
 import {selectTimer} from '../src/utils/timer.js';
 
 import TestWorker from '../src/runners/node/TestWorker.js';
 
-const options = {},
-  rootFolder = process.cwd();
-
-let flags = '',
-  parallel = '',
-  files = [];
+const rootFolder = process.cwd();
 
 const showSelf = () => {
   const self = new URL(import.meta.url);
@@ -33,108 +22,27 @@ const showSelf = () => {
   process.exit(0);
 };
 
-const config = () => {
-  if (process.argv.includes('--self')) showSelf();
-
-  const optionNames = {
-    f: 'failureOnly',
-    t: 'showTime',
-    b: 'showBanner',
-    d: 'showData',
-    o: 'failOnce',
-    n: 'showAssertNumber',
-    m: 'monochrome',
-    c: 'dontCaptureConsole',
-    h: 'hideStreams'
-  };
-
-  let parIsSet = false;
-
-  for (let i = 2; i < process.argv.length; ++i) {
-    const arg = process.argv[i];
-    if (arg == '-f' || arg == '--flags') {
-      if (++i < process.argv.length) {
-        flags += process.argv[i];
-      }
-      continue;
-    }
-    if (arg == '-p' || arg == '--par') {
-      if (++i < process.argv.length) {
-        parallel = process.argv[i];
-        parIsSet = true;
-        if (!parallel || isNaN(parallel)) {
-          parallel = '';
-          parIsSet = false;
-        }
-      }
-      continue;
-    }
-    files.push(arg);
-  }
+const main = async () => {
+  const currentOptions = getOptions({
+    '--self': showSelf,
+    '--info': {isValueRequired: false}
+  });
 
-  flags = (process.env.TAPE6_FLAGS || '') + flags;
-  for (let i = 0; i < flags.length; ++i) {
-    const option = flags[i].toLowerCase(),
-      name = optionNames[option];
-    if (typeof name == 'string') options[name] = option !== flags[i];
-  }
-  options.flags = flags;
+  const [files] = await Promise.all([
+    initFiles(currentOptions.files, rootFolder),
+    initReporter(getReporter, setReporter, currentOptions.flags),
+    selectTimer()
+  ]);
 
-  if (!parIsSet) {
-    parallel = process.env.TAPE6_PAR || parallel;
-  }
-  if (parallel) {
-    parallel = Math.max(0, +parallel);
-    if (parallel === Infinity) parallel = 0;
-  } else {
-    parallel = 0;
-  }
-  if (!parallel) {
-    if (typeof navigator !== 'undefined' && navigator.hardwareConcurrency) {
-      parallel = navigator.hardwareConcurrency;
-    } else {
-      try {
-        parallel = os.availableParallelism();
-      } catch (e) {
-        void e;
-        parallel = 1;
-      }
-    }
-  }
-};
-
-const init = async () => {
-  const currentReporter = getReporter();
-  if (!currentReporter) {
-    const reporterType = getReporterType(),
-      reporterFile = getReporterFileName(reporterType),
-      CustomReporter = (await import('../src/reporters/' + reporterFile)).default,
-      hasColors = !(
-        options.monochrome ||
-        process.env.NO_COLOR ||
-        process.env.NODE_DISABLE_COLORS ||
-        process.env.FORCE_COLOR === '0'
-      ),
-      customOptions = reporterType === 'tap' ? {useJson: true, hasColors} : {...options, hasColors},
-      customReporter = new CustomReporter(customOptions);
-    setReporter(customReporter);
-  }
+  process.on('uncaughtException', (error, origin) => {
+    console.error('UNHANDLED ERROR:', origin, error);
+    process.exit(1);
+  });
 
-  if (files.length) {
-    files = await resolvePatterns(rootFolder, files);
-  } else {
-    files = await resolveTests(rootFolder, 'node');
+  if (currentOptions.optionFlags['--info'] === '') {
+    showInfo(currentOptions, files);
+    process.exit(0);
   }
-};
-
-const main = async () => {
-  config();
-  await init();
-  await selectTimer();
-
-  process.on('uncaughtException', (error, origin) =>
-    console.error('UNHANDLED ERROR:', origin, error)
-  );
 
   if (!files.length) {
     console.log('No files found.');
@@ -142,7 +50,7 @@ const main = async () => {
   }
 
   const reporter = getReporter(),
-    worker = new TestWorker(reporter, parallel, options);
+    worker = new TestWorker(reporter, currentOptions.parallel, currentOptions.flags);
 
   reporter.report({type: 'test', test: 0});
 

package/bin/tape6-seq.js

@@ -3,12 +3,7 @@
 import process from 'node:process';
 import {fileURLToPath} from 'node:url';
 
-import {
-  resolveTests,
-  resolvePatterns,
-  getReporterFileName,
-  getReporterType
-} from '../src/utils/config.js';
+import {getOptions, initFiles, initReporter, showInfo} from '../src/utils/config.js';
 
 import {getReporter, setReporter, setConfiguredFlag, testRunner} from '../src/test.js';
 import {selectTimer} from '../src/utils/timer.js';
@@ -17,11 +12,7 @@ import TestWorker from '../src/runners/seq/TestWorker.js';
 
 setConfiguredFlag(true);
 
-const options = {},
-  rootFolder = process.cwd();
-
-let flags = '',
-  files = [];
+const rootFolder = process.cwd();
 
 const showSelf = () => {
   const self = new URL(import.meta.url);
@@ -33,83 +24,37 @@ const showSelf = () => {
   process.exit(0);
 };
 
-const config = () => {
-  if (process.argv.includes('--self')) showSelf();
-
-  const optionNames = {
-    f: 'failureOnly',
-    t: 'showTime',
-    b: 'showBanner',
-    d: 'showData',
-    o: 'failOnce',
-    n: 'showAssertNumber',
-    m: 'monochrome',
-    c: 'dontCaptureConsole',
-    h: 'hideStreams'
-  };
-
-  for (let i = 2; i < process.argv.length; ++i) {
-    const arg = process.argv[i];
-    if (arg == '-f' || arg == '--flags') {
-      if (++i < process.argv.length) {
-        flags += process.argv[i];
-      }
-      continue;
-    }
-    if (arg == '-p' || arg == '--par') {
-      // skip
-      ++i;
-      continue;
-    }
-    files.push(arg);
-  }
-
-  flags = (process.env.TAPE6_FLAGS || '') + flags;
-  for (let i = 0; i < flags.length; ++i) {
-    const option = flags[i].toLowerCase(),
-      name = optionNames[option];
-    if (typeof name == 'string') options[name] = option !== flags[i];
-  }
-  options.flags = flags;
-};
+const main = async () => {
+  const currentOptions = getOptions({
+    '--self': showSelf,
+    '--info': {isValueRequired: false}
+  });
 
-const init = async () => {
-  const currentReporter = getReporter();
-  if (!currentReporter) {
-    const reporterType = getReporterType(),
-      reporterFile = getReporterFileName(reporterType),
-      CustomReporter = (await import('../src/reporters/' + reporterFile)).default,
-      hasColors = !(
-        options.monochrome ||
-        process.env.NO_COLOR ||
-        process.env.NODE_DISABLE_COLORS ||
-        process.env.FORCE_COLOR === '0'
-      ),
-      customOptions = reporterType === 'tap' ? {useJson: true, hasColors} : {...options, hasColors},
-      customReporter = new CustomReporter(customOptions);
-    setReporter(customReporter);
-  }
+  const [files] = await Promise.all([
+    initFiles(currentOptions.files, rootFolder),
+    initReporter(getReporter, setReporter, currentOptions.flags),
+    selectTimer()
+  ]);
 
-  if (files.length) {
-    files = await resolvePatterns(rootFolder, files);
-  } else {
-    files = await resolveTests(rootFolder, 'node');
-  }
-};
+  const console = globalThis.console;
 
-const main = async () => {
-  config();
-  await init();
-  await selectTimer();
+  process.on('uncaughtException', (error, origin) => {
+    console.error('UNHANDLED ERROR:', origin, error);
+    process.exit(1);
+  });
 
-  const console = globalThis.console;
+  if (currentOptions.optionFlags['--info'] === '') {
+    showInfo(currentOptions, files);
+    process.exit(0);
+  }
 
-  process.on('uncaughtException', (error, origin) =>
-    console.error('UNHANDLED ERROR:', origin, error)
-  );
+  if (!files.length) {
+    console.log('No files found.');
+    process.exit(1);
+  }
 
   const reporter = getReporter(),
-    worker = new TestWorker(reporter, 1, {...options, testRunner});
+    worker = new TestWorker(reporter, 1, {...currentOptions.flags, testRunner});
 
   reporter.report({type: 'test', test: 0});
 

package/bin/tape6-server.js

@@ -147,6 +147,12 @@ const server = http.createServer(async (req, res) => {
     const cfg = await getConfig(rootFolder);
     return sendJson(req, res, cfg.importmap || {imports: {}}, method === 'HEAD');
   }
+  if (url.pathname === '/favicon.ico') {
+    const faviconFile = path.join(rootFolder, webAppPath, 'favicon.ico');
+    const stat = await fsp.stat(faviconFile).catch(() => null);
+    if (stat && stat.isFile()) return sendFile(req, res, faviconFile, '.ico', method === 'HEAD');
+    return bailOut(req, res);
+  }
   if (url.pathname === '/' || url.pathname === '/index' || url.pathname === '/index.html') {
     // redirect to the web app
     url.pathname = webAppPath;

package/index.js

@@ -38,7 +38,7 @@ const optionNames = {
   n: 'showAssertNumber',
   m: 'monochrome',
   j: 'useJsonL',
-  c: 'dontCaptureConsole',
+  c: 'noConsoleCapture',
   h: 'hideStreams'
 };
 
@@ -74,7 +74,7 @@ const init = async () => {
 
   let originalConsole = null,
     setCurrentReporter = null;
-  if (!options.dontCaptureConsole && (isNode || isBun || isDeno)) {
+  if (!options.noConsoleCapture && (isNode || isBun || isDeno)) {
     const {captureConsole, setCurrentReporter: setReporter} = await import(
       new URL('./src/utils/capture-console.js', import.meta.url)
     );

package/llms-full.txt

@@ -286,11 +286,12 @@ Environment-specific subsections: `node`, `deno`, `bun`, `browser`.
 Runs test files in parallel using worker threads.
 
 ```bash
-tape6 [--flags FLAGS] [--par N] [tests...]
+tape6 [--flags FLAGS] [--par N] [--info] [tests...]
 ```
 
 - `--flags FLAGS` — output control flags (see below).
 - `--par N` — number of parallel workers (default: all CPU cores).
+- `--info` — print current configuration and exit without running tests.
 - No arguments: runs tests from configuration.
 
 ### tape6-seq

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tape-six",
-  "version": "1.7.3",
+  "version": "1.7.5",
   "description": "TAP-based unit test library for Node, Deno, Bun, and browsers. ES modules, TypeScript, zero dependencies.",
   "type": "module",
   "main": "index.js",
@@ -104,7 +104,7 @@
   },
   "devDependencies": {
     "@types/chai": "^5.2.3",
-    "@types/node": "^25.3.1",
+    "@types/node": "^25.3.3",
     "chai": "^6.2.2",
     "playwright": "^1.58.2",
     "puppeteer": "^24.37.5",