tape-six 1.7.2 → 1.7.4

package/src/runners/deno/TestWorker.js

@@ -1,7 +1,6 @@
 import {pathToFileURL} from 'node:url';
 import {sep} from 'node:path';
 
-import {isStopTest} from '../../State.js';
 import EventServer from '../../utils/EventServer.js';
 
 const srcName = new URL('../../', import.meta.url),
@@ -23,11 +22,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);
       }
@@ -38,20 +33,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({

package/src/runners/deno/worker.js

@@ -1,7 +1,7 @@
 const DEFAULT_START_TIMEOUT = 5_000;
 
 const getTimeout = () => {
-  const timeoutValue = Deno.env.get('TAPE6_WORKER_START TIMEOUT');
+  const timeoutValue = Deno.env.get('TAPE6_WORKER_START_TIMEOUT');
   if (!timeoutValue) return DEFAULT_START_TIMEOUT;
   let timeout = Number(timeoutValue);
   if (isNaN(timeout) || timeout <= 0 || timeout === Infinity) timeout = DEFAULT_START_TIMEOUT;

package/src/runners/node/TestWorker.js

@@ -3,7 +3,6 @@ import {sep} from 'node:path';
 import {pathToFileURL} from 'node:url';
 import {Worker} from 'node:worker_threads';
 
-import {isStopTest} from '../../State.js';
 import EventServer from '../../utils/EventServer.js';
 
 const srcName = new URL('../../', import.meta.url),
@@ -23,11 +22,7 @@ export default class TestWorker extends EventServer {
       });
     this.idToWorker[id] = worker;
     worker.on('message', msg => {
-      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);
       }
@@ -38,20 +33,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.on('messageerror', error => {
@@ -60,20 +51,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({

package/src/runners/seq/BypassReporter.js

@@ -25,12 +25,12 @@ export class BypassReporter {
     return this.reporter.signal;
   }
 
-  get abort() {
-    return this.reporter.abort;
+  abort() {
+    this.reporter.abort();
   }
 
-  report(event) {
-    this.reportTo(event);
+  report(event, suppressStopTest = false) {
+    this.reportTo(event, suppressStopTest);
   }
 }
 

package/src/runners/seq/TestWorker.js

@@ -2,7 +2,6 @@ import process from 'node:process';
 import {sep} from 'node:path';
 import {pathToFileURL} from 'node:url';
 
-import {isStopTest} from '../../State.js';
 import EventServer from '../../utils/EventServer.js';
 import {getTimeoutValue} from '../../utils/config.js';
 import {getOriginalConsole, setCurrentReporter} from '../../utils/capture-console.js';
@@ -35,11 +34,7 @@ export default class TestWorker extends EventServer {
           clearTimeout(this.timeoutId);
           this.timeoutId = null;
         }
-        try {
-          this.report(id, event);
-        } catch (error) {
-          if (!isStopTest(error)) throw error;
-        }
+        this.report(id, event);
         if (event.type === 'end' && event.test === 0) {
           this.close(id);
         }
@@ -79,20 +74,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);
   }
   #reportTimeout(id, fileName) {
@@ -101,17 +92,13 @@ export default class TestWorker extends EventServer {
       test: 0,
       name: 'FILE: /' + fileName
     });
-    try {
-      this.report(id, {
-        name: `No tests found in ${this.timeout}ms`,
-        test: 0,
-        marker: new Error(),
-        operator: 'error',
-        fail: true
-      });
-    } catch (error) {
-      if (!isStopTest(error)) throw error;
-    }
+    this.report(id, {
+      name: `No tests found in ${this.timeout}ms`,
+      test: 0,
+      marker: new Error(),
+      operator: 'error',
+      fail: true
+    });
     this.report(id, {
       type: 'end',
       test: 0,

package/src/test.js

@@ -203,6 +203,7 @@ export const runTests = async tests => {
         });
       } else {
         tester.reporter.report({
+          type: 'assert',
           name: 'UNEXPECTED EXCEPTION: ' + String(error),
           test: testNumber,
           marker: new Error(),

package/src/utils/EventServer.js

@@ -18,11 +18,11 @@ export default class EventServer {
     if (this.passThroughId === id) {
       if (events) {
         for (const event of events) {
-          this.reporter.report(event);
+          this.reporter.report(event, true);
         }
         delete this.retained[id];
       }
-      return this.reporter.report(event);
+      return this.reporter.report(event, true);
     }
     if (Array.isArray(events)) {
       events.push(event);
@@ -46,7 +46,7 @@ export default class EventServer {
       // dump ready events
       for (const events of this.readyQueue) {
         for (const event of events) {
-          this.reporter.report(event);
+          this.reporter.report(event, true);
         }
       }
       this.readyQueue = [];
@@ -57,7 +57,7 @@ export default class EventServer {
         if (this.passThroughId === null) {
           // dump events
           for (const event of events) {
-            this.reporter.report(event);
+            this.reporter.report(event, true);
           }
         } else {
           // add to the ready queue

package/web-app/DashReporter.js

@@ -27,7 +27,7 @@ export class DashReporter extends Reporter {
     this.spinnerNode = document.querySelector('.tape6 tape6-spinner');
     this.running = true;
   }
-  report(event) {
+  report(event, suppressStopTest = false) {
     event = this.state?.preprocess(event) || event;
     switch (event.type) {
       case 'test':
@@ -57,7 +57,7 @@ export class DashReporter extends Reporter {
         this.updateDashboard();
         break;
     }
-    this.state?.postprocess(event);
+    this.state?.postprocess(event, suppressStopTest);
   }
   updateDashboard() {
     this.updateDonut();

package/web-app/DomReporter.js

@@ -28,7 +28,7 @@ class DomReporter extends Reporter {
     this.stack = []; // previous test nodes
     this.current = null; // the current test node
   }
-  report(event) {
+  report(event, suppressStopTest = false) {
     event = this.state?.preprocess(event) || event;
     let text;
     switch (event.type) {
@@ -194,7 +194,7 @@ class DomReporter extends Reporter {
         }
         break;
     }
-    this.state?.postprocess(event);
+    this.state?.postprocess(event, suppressStopTest);
   }
 }
 

package/workflows/write-tests.md

@@ -0,0 +1,33 @@
+---
+description: Write or update tape-six tests for a module or feature
+---
+
+# Write Tests
+
+Write or update tests using the tape-six testing library.
+
+## Notes
+
+- `tape-six` supports ES modules (`.js`, `.mjs`, `.ts`, `.mts`) and CommonJS (`.cjs`, `.cts`).
+- TypeScript is supported natively — no transpilation needed (Node 22+, Deno, Bun run `.ts` files directly).
+- The default `tape6` runner uses worker threads for parallel execution. `tape6-seq` runs sequentially in-process — useful for debugging or when tests share state.
+
+## Steps
+
+1. Read the testing guide at `node_modules/tape-six/TESTING.md` for API reference and patterns.
+2. Identify the module or feature to test. Read its source code to understand the public API.
+3. Create or update the test file in `tests/test-<name>.js` (or `.ts` for TypeScript projects):
+   - Import `test` from `tape-six` (ESM: `import test from 'tape-six'`; CJS: `const {test} = require('tape-six')`).
+   - Import the module under test using the project's package name.
+   - Write one top-level `test()` per logical group.
+   - Use embedded `await t.test()` for sub-cases.
+   - Use `t.beforeEach`/`t.afterEach` for shared setup/teardown.
+   - Cover: normal operation, edge cases, error conditions.
+   - Use `t.equal` for primitives, `t.deepEqual` for objects/arrays, `t.throws` for errors, `await t.rejects` for async errors.
+   - All `msg` arguments are optional but recommended for clarity.
+     // turbo
+4. Run the new test file directly to verify: `node tests/test-<name>.js`
+   // turbo
+5. Run the full test suite to check for regressions: `npm test`
+   - If debugging, use `npm run test:seq` (runs sequentially, easier to trace issues).
+6. Report results and any failures.