tape-six 1.7.2 → 1.7.4

package/bin/tape6-bun.js

@@ -119,9 +119,10 @@ const main = async () => {
   await init();
   await selectTimer();
 
-  process.on('uncaughtException', (error, origin) =>
-    console.error('UNHANDLED ERROR:', origin, error)
-  );
+  process.on('uncaughtException', (error, origin) => {
+    console.error('UNHANDLED ERROR:', origin, error);
+    process.exit(1);
+  });
 
   const reporter = getReporter(),
     worker = new TestWorker(reporter, parallel, options);

package/bin/tape6-node.js

@@ -132,9 +132,10 @@ const main = async () => {
   await init();
   await selectTimer();
 
-  process.on('uncaughtException', (error, origin) =>
-    console.error('UNHANDLED ERROR:', origin, error)
-  );
+  process.on('uncaughtException', (error, origin) => {
+    console.error('UNHANDLED ERROR:', origin, error);
+    process.exit(1);
+  });
 
   if (!files.length) {
     console.log('No files found.');

package/bin/tape6-seq.js

@@ -104,9 +104,10 @@ const main = async () => {
 
   const console = globalThis.console;
 
-  process.on('uncaughtException', (error, origin) =>
-    console.error('UNHANDLED ERROR:', origin, error)
-  );
+  process.on('uncaughtException', (error, origin) => {
+    console.error('UNHANDLED ERROR:', origin, error);
+    process.exit(1);
+  });
 
   const reporter = getReporter(),
     worker = new TestWorker(reporter, 1, {...options, testRunner});

package/index.d.ts

@@ -66,15 +66,15 @@ export declare interface Tester {
   /**
    * A symbol that can be used to match any value.
    */
-  any: Symbol;
+  any: symbol;
 
   /**
    * A symbol that can be used to match any value. An alias of `any`.
    */
-  _: Symbol;
+  _: symbol;
 
   /**
-   * A signal that can be used to abort asynchronous operations. It is triggered when the test is ended.
+   * A signal that can be used to abort asynchronous operations. It is triggered when the test ends.
    */
   signal: AbortSignal;
 
@@ -287,7 +287,7 @@ export declare interface Tester {
   ): Promise<void>;
 
   /**
-   * Runs non-asynchronous callback-based test.
+   * Runs a callback-based test wrapped in a promise.
    * @param name - The name of the test
    * @param fn - The test function
    * @param options - The test options
@@ -299,7 +299,7 @@ export declare interface Tester {
   ): Promise<void>;
 
   /**
-   * Runs non-asynchronous callback-based test.
+   * Runs a callback-based test wrapped in a promise.
    * @param name - The name of the test
    * @param options - The test options
    * @param fn - The test function
@@ -311,7 +311,7 @@ export declare interface Tester {
   ): Promise<void>;
 
   /**
-   * Runs non-asynchronous callback-based test.
+   * Runs a callback-based test wrapped in a promise.
    * @param fn - The test function
    * @param options - The test options
    * @param name - The name of the test
@@ -323,7 +323,7 @@ export declare interface Tester {
   ): Promise<void>;
 
   /**
-   * Runs non-asynchronous callback-based test.
+   * Runs a callback-based test wrapped in a promise.
    * @param fn - The test function
    * @param name - The name of the test
    * @param options - The test options
@@ -335,7 +335,7 @@ export declare interface Tester {
   ): Promise<void>;
 
   /**
-   * Runs non-asynchronous callback-based test.
+   * Runs a callback-based test wrapped in a promise.
    * @param options - The test options
    * @param fn - The test function
    * @param name - The name of the test
@@ -347,7 +347,7 @@ export declare interface Tester {
   ): Promise<void>;
 
   /**
-   * Runs non-asynchronous callback-based test.
+   * Runs a callback-based test wrapped in a promise.
    * @param options - The test options
    * @param name - The name of the test
    * @param fn - The test function
@@ -425,8 +425,8 @@ export declare interface Tester {
   notOk(value: unknown, message?: string): void;
 
   /**
-   * Asserts that `error` is an error and fails the test.
-   * @param error - The error to test
+   * Asserts that `error` is falsy. If the value is truthy (e.g. an Error object), the assertion fails.
+   * @param error - The value to test
    * @param message - Optional message to display if the assertion fails
    */
   error(error: Error | null | unknown, message?: string): void;
@@ -600,22 +600,22 @@ export declare interface Tester {
   notok(value: unknown, message?: string): void;
 
   /**
-   * Asserts that `error` is an error and fails the test. Alias of `error`.
-   * @param error - The error to test
+   * Asserts that `error` is falsy. If the value is truthy (e.g. an Error object), the assertion fails. Alias of `error`.
+   * @param error - The value to test
    * @param message - Optional message to display if the assertion fails
    */
   ifError(error: Error | null | unknown, message?: string): void;
 
   /**
-   * Asserts that `error` is an error and fails the test. Alias of `error`.
-   * @param error - The error to test
+   * Asserts that `error` is falsy. If the value is truthy (e.g. an Error object), the assertion fails. Alias of `error`.
+   * @param error - The value to test
    * @param message - Optional message to display if the assertion fails
    */
   ifErr(error: Error | null | unknown, message?: string): void;
 
   /**
-   * Asserts that `error` is an error and fails the test. Alias of `error`.
-   * @param error - The error to test
+   * Asserts that `error` is falsy. If the value is truthy (e.g. an Error object), the assertion fails. Alias of `error`.
+   * @param error - The value to test
    * @param message - Optional message to display if the assertion fails
    */
   iferror(error: Error | null | unknown, message?: string): void;
@@ -1122,57 +1122,64 @@ export declare interface Test {
 }
 
 /**
- * The main function, which is used to define tests. Many other functions are defined as properties of this function.
+ * The main function used to define tests. When called inside a test body, it delegates to the current tester.
+ * Many other functions are defined as properties of this function.
  */
 export declare const test: Test;
 
 /**
- * An alias for `test`. Used for compatibility with other testing frameworks to define test suites.
+ * An alias for `test`. When called inside a test body, it delegates to the current tester.
  */
 export declare const suite = test;
 
 /**
- * An alias for `test`. Used for compatibility with other testing frameworks to define test suites.
+ * An alias for `test`. When called inside a test body, it delegates to the current tester.
  */
 export declare const describe = test;
 
 /**
- * An alias for `test`. Used for compatibility with other testing frameworks to define tests.
+ * An alias for `test`. When called inside a test body, it delegates to the current tester.
  */
 export declare const it = test;
 
 /**
  * Registers a function that will be called before all 1st-level embedded tests in the current scope.
+ * When called inside a test body, delegates to the current tester.
  * @param fn a hook function
  */
 export declare const beforeAll: typeof test.beforeAll;
 
 /**
  * Registers a function that will be called after all 1st-level embedded tests in the current scope.
+ * When called inside a test body, delegates to the current tester.
  * @param fn a hook function
  */
 export declare const afterAll: typeof test.afterAll;
 
 /**
  * Registers a function that will be called before each 1st-level embedded test in the current scope.
+ * When called inside a test body, delegates to the current tester.
  * @param fn a hook function
  */
 export declare const beforeEach: typeof test.beforeEach;
 
 /**
  * Registers a function that will be called after each 1st-level embedded test in the current scope.
+ * When called inside a test body, delegates to the current tester.
  * @param fn a hook function
  */
 export declare const afterEach: typeof test.afterEach;
 
 /**
  * Registers a function that will be called before all 1st-level embedded tests in the current scope. An alias for `beforeAll()`.
+ * When called inside a test body, delegates to the current tester.
  * @param fn a hook function
  */
 export declare const before: typeof test.before;
 
 /**
  * Registers a function that will be called after all 1st-level embedded tests in the current scope. An alias for `afterAll()`.
+ * When called inside a test body, delegates to the current tester.
  * @param fn a hook function
  */
 export declare const after: typeof test.after;

package/llms-full.txt

@@ -9,6 +9,7 @@
 - Browser testing with built-in web UI and automation support (Puppeteer, Playwright)
 - Before/after hooks: `beforeAll`, `afterAll`, `beforeEach`, `afterEach`
 - `test()` is aliased as `suite()`, `describe()`, and `it()` for easy migration
+- When called inside a test body, top-level functions auto-delegate to the current tester
 - Compatible with `AssertionError`-based libraries like `node:assert` and `chai`
 
 ## Quick start
@@ -128,6 +129,20 @@ test('top', async t => {
 
 Always `await` embedded tests to preserve execution order.
 
+Top-level `test()`/`it()`/`describe()` auto-delegate when called inside a test body, so these are equivalent:
+
+```js
+import {describe, it, before, beforeEach} from 'tape-six';
+
+describe('module', () => {
+  before(() => { /* setup */ });
+  beforeEach(() => { /* per-test setup */ });
+
+  it('works', t => { t.ok(true); });
+  it('also works', t => { t.equal(1, 1); });
+});
+```
+
 ## Tester API
 
 The `Tester` object is passed to test functions. All `msg` arguments are optional.
@@ -163,17 +178,17 @@ The `Tester` object is passed to test functions. All `msg` arguments are optiona
 
 ### Embedded test methods
 
-- `test(name, options, testFn)` — nested test suite (async, await it).
+- `test(name, options, testFn)` — nested test suite (async, await it). Top-level `test()`/`it()` also works.
 - `skip(name, options, testFn)` — skip nested suite.
 - `todo(name, options, testFn)` — TODO nested suite.
 - `asPromise(name, options, testPromiseFn)` — callback-style nested suite.
 
 ### Hooks
 
-- `beforeAll(fn)` / `before(fn)` — run before first nested test.
-- `afterAll(fn)` / `after(fn)` — run after last nested test.
-- `beforeEach(fn)` — run before each nested test.
-- `afterEach(fn)` — run after each nested test.
+- `beforeAll(fn)` / `before(fn)` — run before first nested test. Top-level `beforeAll()`/`before()` also works.
+- `afterAll(fn)` / `after(fn)` — run after last nested test. Top-level `afterAll()`/`after()` also works.
+- `beforeEach(fn)` — run before each nested test. Top-level `beforeEach()` also works.
+- `afterEach(fn)` — run after each nested test. Top-level `afterEach()` also works.
 
 ### Miscellaneous
 
@@ -211,12 +226,16 @@ beforeEach(() => { /* runs before each top-level test */ });
 afterEach(() => { /* runs after each top-level test */ });
 ```
 
-Nested hooks (via tester object):
+Nested hooks (top-level functions auto-delegate to current tester):
 
 ```js
+import {test, beforeEach, afterEach} from 'tape-six';
+
 test('suite', async t => {
-  t.beforeEach(() => { /* before each nested test */ });
-  t.afterEach(() => { /* after each nested test */ });
+  beforeEach(() => { /* before each nested test */ });
+  afterEach(() => { /* after each nested test */ });
+
+  // equivalent: t.beforeEach(), t.afterEach()
 
   await t.test('test 1', t => t.pass());
   await t.test('test 2', t => t.pass());
@@ -323,6 +342,7 @@ Browser: `http://localhost:3000/?flags=FO`
 - `TAPE6_PAR` — number of parallel workers.
 - `TAPE6_TAP` — force TAP reporter (any non-empty value).
 - `TAPE6_JSONL` — force JSONL reporter (any non-empty value).
+- `TAPE6_MIN` — force minimal reporter (any non-empty value).
 - `TAPE6_TEST_FILE_NAME` — set by runners to identify the current test file.
 
 ## Browser testing

package/llms.txt

@@ -33,6 +33,7 @@ Registers a test. All three arguments are optional and can be in any order (reco
 Returns a promise that resolves when the test finishes. Usually no need to await.
 
 Aliases: `suite`, `describe`, `it` — all are the same function.
+When called inside a test body, these (and all hook functions) automatically delegate to the current tester — no need to use `t.test()` or `t.before()` explicitly.
 
 ```js
 import {test, describe, it, suite} from 'tape-six';
@@ -97,7 +98,7 @@ The object passed to test functions. Provides assertions and test control.
 
 #### Embedded tests (all async, should be awaited)
 
-- `await t.test(name, options, testFn)` — nested test.
+- `await t.test(name, options, testFn)` — nested test. Top-level `test()`/`it()` also works (auto-delegates).
 - `await t.skip(name, options, testFn)` — nested skipped test.
 - `await t.todo(name, options, testFn)` — nested TODO test.
 - `await t.asPromise(name, options, testPromiseFn)` — nested callback-style test.
@@ -122,12 +123,14 @@ afterAll(() => { /* runs once after all tests */ });
 beforeEach(() => { /* runs before each test */ });
 afterEach(() => { /* runs after each test */ });
 
-// Or inside a test:
+// Inside a test — top-level functions auto-delegate to current tester:
 test('suite', async t => {
-  t.beforeAll(() => { /* before embedded tests */ });
-  t.afterAll(() => { /* after embedded tests */ });
-  t.beforeEach(() => { /* before each embedded test */ });
-  t.afterEach(() => { /* after each embedded test */ });
+  beforeAll(() => { /* before embedded tests */ });
+  afterAll(() => { /* after embedded tests */ });
+  beforeEach(() => { /* before each embedded test */ });
+  afterEach(() => { /* after each embedded test */ });
+
+  // equivalent: t.beforeAll(), t.afterAll(), t.beforeEach(), t.afterEach()
 
   await t.test('inner', t => { t.pass(); });
 });
@@ -198,9 +201,12 @@ test('partial match', t => {
 ### Using describe/it style
 
 ```js
-import {describe, it} from 'tape-six';
+import {describe, it, before, beforeEach} from 'tape-six';
 
 describe('my module', () => {
+  before(() => { /* setup — auto-delegates to current tester */ });
+  beforeEach(() => { /* per-test setup */ });
+
   it('should work', t => {
     t.ok(true);
   });
@@ -223,6 +229,15 @@ npx tape6-seq              # run sequentially (no worker threads)
 npx tape6-server --trace   # start browser test server
 ```
 
+## Environment variables
+
+- `TAPE6_FLAGS` — flags string.
+- `TAPE6_PAR` — number of parallel workers.
+- `TAPE6_TAP` — force TAP reporter (any non-empty value).
+- `TAPE6_JSONL` — force JSONL reporter (any non-empty value).
+- `TAPE6_MIN` — force minimal reporter (any non-empty value).
+- `TAPE6_TEST_FILE_NAME` — set by runners to identify the current test file.
+
 ## Configuration (package.json)
 
 ```json

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tape-six",
-  "version": "1.7.2",
+  "version": "1.7.4",
   "description": "TAP-based unit test library for Node, Deno, Bun, and browsers. ES modules, TypeScript, zero dependencies.",
   "type": "module",
   "main": "index.js",
@@ -61,7 +61,8 @@
     "bun",
     "nodejs",
     "tap-protocol",
-    "cross-runtime"
+    "cross-runtime",
+    "zero-dependency"
   ],
   "author": "Eugene Lazutkin <eugene.lazutkin@gmail.com> (https://www.lazutkin.com/)",
   "funding": "https://github.com/sponsors/uhop",
@@ -78,7 +79,9 @@
     "web-app",
     "src",
     "llms.txt",
-    "llms-full.txt"
+    "llms-full.txt",
+    "TESTING.md",
+    "workflows"
   ],
   "tape6": {
     "tests": [
@@ -101,7 +104,7 @@
   },
   "devDependencies": {
     "@types/chai": "^5.2.3",
-    "@types/node": "^25.3.0",
+    "@types/node": "^25.3.1",
     "chai": "^6.2.2",
     "playwright": "^1.58.2",
     "puppeteer": "^24.37.5",

package/src/State.js

@@ -246,10 +246,10 @@ export class State {
     return event;
   }
 
-  postprocess(event) {
+  postprocess(event, suppressStopTest = false) {
     switch (event.type) {
       case 'assert':
-        if (event.stopTest && event.operator !== 'exception') {
+        if (!suppressStopTest && event.stopTest && event.operator !== 'exception') {
           const stopTest = new StopTest('failOnce is activated');
           stopTest[signature] = signature;
           throw stopTest;
@@ -257,6 +257,7 @@ export class State {
         this.time = this.timer.now();
         break;
       case 'bail-out':
+        if (suppressStopTest) return;
         const stopTest = new StopTest('bailOut is activated');
         stopTest[signature] = signature;
         throw stopTest;

package/src/Tester.js

@@ -236,7 +236,7 @@ export class Tester {
 
   deepLooseEqual(a, b, msg) {
     this.reporter.report({
-      name: msg || 'should be loosely equal',
+      name: msg || 'should be deeply loosely equal',
       test: this.testNumber,
       marker: new Error(),
       time: this.timer.now(),
@@ -251,7 +251,7 @@ export class Tester {
 
   notDeepLooseEqual(a, b, msg) {
     this.reporter.report({
-      name: msg || 'should not be loosely equal',
+      name: msg || 'should not be deeply loosely equal',
       test: this.testNumber,
       marker: new Error(),
       time: this.timer.now(),

package/src/reporters/JSONLReporter.js

@@ -21,7 +21,7 @@ export class JSONLReporter extends Reporter {
     prefix ||= getEnvVar('TAPE6_JSONL_PREFIX') || '';
     this.prefix = prefix ? '\n' + prefix : '';
   }
-  report(event) {
+  report(event, suppressStopTest = false) {
     event = this.state?.preprocess(event) || event;
     if (event.type === 'assert' && this.renumberAsserts) {
       event = {...event, id: ++this.assertCounter};
@@ -39,7 +39,7 @@ export class JSONLReporter extends Reporter {
     }
     const jsonEvent = JSON.stringify(event);
     this.console.log(this.prefix ? this.prefix + jsonEvent : jsonEvent);
-    this.state?.postprocess(event);
+    this.state?.postprocess(event, suppressStopTest);
   }
 }
 

package/src/reporters/MinReporter.js

@@ -1,22 +1,11 @@
 import Reporter from './Reporter.js';
 
-const getEnvVar = name => {
-  if (typeof Deno == 'object' && Deno?.version) {
-    return Deno.env.get(name);
-  } else if (typeof Bun == 'object' && Bun?.version) {
-    return Bun.env[name];
-  } else if (typeof process == 'object' && process?.versions?.node) {
-    return process.env[name];
-  }
-  return undefined;
-};
-
 export class MinReporter extends Reporter {
   constructor({failOnce = false, originalConsole} = {}) {
     super({failOnce});
     this.console = originalConsole || console;
   }
-  report(event) {
+  report(event, suppressStopTest = false) {
     event = this.state?.preprocess(event) || event;
     const handler = Reporter.EVENT_MAP[event.type];
     typeof handler == 'string' && this[handler]?.(event);
@@ -30,7 +19,7 @@ export class MinReporter extends Reporter {
       'Fail:',
       event.fail
     );
-    this.state?.postprocess(event);
+    this.state?.postprocess(event, suppressStopTest);
   }
 }
 

package/src/reporters/ProxyReporter.js

@@ -5,7 +5,7 @@ export class ProxyReporter extends Reporter {
     super({failOnce});
     this.reportTo = reportTo;
   }
-  report(event) {
+  report(event, suppressStopTest = false) {
     event = this.state?.preprocess(event) || event;
     switch (event.type) {
       case 'test':
@@ -19,7 +19,7 @@ export class ProxyReporter extends Reporter {
         break;
     }
     this.reportTo(event);
-    this.state?.postprocess(event);
+    this.state?.postprocess(event, suppressStopTest);
   }
 }
 

package/src/reporters/Reporter.js

@@ -57,13 +57,13 @@ export class Reporter {
     }
   }
 
-  report(event) {
+  report(event, suppressStopTest = false) {
     event = this.state?.preprocess(event) || event;
 
     const handler = this.constructor.EVENT_MAP[event.type];
     typeof handler == 'string' && this[handler]?.(event);
 
-    this.state?.postprocess(event);
+    this.state?.postprocess(event, suppressStopTest);
   }
 
   static EVENT_MAP = {
@@ -76,7 +76,7 @@ export class Reporter {
     console: 'onConsole',
     stdout: 'onStdout',
     stderr: 'onStderr',
-    bailOut: 'onBailOut'
+    'bail-out': 'onBailOut'
   };
 }
 

package/src/reporters/TTYReporter.js

@@ -148,15 +148,15 @@ export class TTYReporter extends Reporter {
     ++this.lines;
     return this;
   }
-  report(event) {
+  report(event, suppressStopTest = false) {
     this.consoleSkipChecks = true;
     try {
-      this.reportInternal(event);
+      this.reportInternal(event, suppressStopTest);
     } finally {
       this.consoleSkipChecks = false;
     }
   }
-  reportInternal(event) {
+  reportInternal(event, suppressStopTest = false) {
     if (this.output.isTTY) {
       if (!this.consoleWasUsed && this.overrideLastLine) {
         this.output.moveCursor(0, -1);
@@ -320,7 +320,7 @@ export class TTYReporter extends Reporter {
       this.showScore();
       this.overrideLastLine = true;
     }
-    this.state?.postprocess(event);
+    this.state?.postprocess(event, suppressStopTest);
   }
   showScore() {
     this.out(

package/src/reporters/TapReporter.js

@@ -61,7 +61,7 @@ export class TapReporter extends Reporter {
       this.opened = true;
     }
   }
-  report(event) {
+  report(event, suppressStopTest = false) {
     event = this.state?.preprocess(event) || event;
     let text;
     switch (event.type) {
@@ -192,6 +192,7 @@ export class TapReporter extends Reporter {
         }
         break;
     }
+    this.state?.postprocess(event, suppressStopTest);
   }
   showSummary(state, diffTime) {
     const success = state.asserts - state.failed - state.skipped;

package/src/runners/bun/TestWorker.js

@@ -1,6 +1,5 @@
 import {sep} from 'node:path';
 
-import {isStopTest} from '../../State.js';
 import EventServer from '../../utils/EventServer.js';
 
 const srcName = new URL('../../', import.meta.url),
@@ -21,11 +20,7 @@ export default class TestWorker extends EventServer {
     this.idToWorker[id] = worker;
     worker.addEventListener('message', event => {
       const msg = event.data;
-      try {
-        this.report(id, msg);
-      } catch (error) {
-        if (!isStopTest(error)) throw error;
-      }
+      this.report(id, msg);
       if (msg.type === 'end' && msg.test === 0) {
         this.close(id);
       }
@@ -36,20 +31,16 @@ export default class TestWorker extends EventServer {
         name: 'fail to load: ' + (error.message || 'Worker error'),
         test: 0
       });
-      try {
-        this.report(id, {
-          name: String(error),
-          test: 0,
-          marker: new Error(),
-          operator: 'error',
-          fail: true,
-          data: {
-            actual: error
-          }
-        });
-      } catch (error) {
-        if (!isStopTest(error)) throw error;
-      }
+      this.report(id, {
+        name: String(error),
+        test: 0,
+        marker: new Error(),
+        operator: 'error',
+        fail: true,
+        data: {
+          actual: error
+        }
+      });
       this.close(id);
     });
     worker.addEventListener('messageerror', error => {
@@ -58,20 +49,16 @@ export default class TestWorker extends EventServer {
         name: 'fail to load: ' + (error.message || 'Worker error'),
         test: 0
       });
-      try {
-        this.report(id, {
-          name: String(error),
-          test: 0,
-          marker: new Error(),
-          operator: 'error',
-          fail: true,
-          data: {
-            actual: error
-          }
-        });
-      } catch (error) {
-        if (!isStopTest(error)) throw error;
-      }
+      this.report(id, {
+        name: String(error),
+        test: 0,
+        marker: new Error(),
+        operator: 'error',
+        fail: true,
+        data: {
+          actual: error
+        }
+      });
       this.close(id);
     });
     worker.postMessage({