supertape 12.8.0 → 12.10.0

package/ChangeLog

@@ -1,3 +1,13 @@
+2026.03.09, v12.10.0
+
+feature:
+- e44620b supertape: callWhenTestsEnds: add
+
+2026.03.09, v12.9.0
+
+feature:
+- 8b5573d supertape: isSkipTests: add
+
 2026.03.09, v12.8.0
 
 feature:

package/README.md

@@ -239,6 +239,13 @@ Here is Possible `options` similar to [Environment Variables](#environment-varia
 - `checkAssertionsCount`;
 - `timeout`;
 
+```js
+test('hello: world', (t) => {
+    t.equal('hello', 'world');
+    t.end();
+});
+```
+
 ### test.only(message, fn, options?)
 
 Like `test(name, cb)` except if you use `.only` this is the only test case
@@ -273,6 +280,38 @@ test('assertion', (t) => {
 });
 ```
 
+### `isSkiptTests`
+
+When you need to know if there was `only` tests use:
+
+```js
+import {isOnlyTests} from 'supertape';
+
+isOnlyTests();
+```
+
+### `isOnlyTests`
+
+When you need to know if there was `skip` tests use:
+
+```js
+import {isSkipTests} from 'supertape';
+
+isSkipTests();
+```
+
+### `callWhenTestsEnds`
+
+Call your function when tests ends (usually on 'process.exit')
+
+```js
+import {callWhenTestsEnds} from 'supertape';
+
+callWhenTestsEnds('TYPE_CHECK', () => {
+    console.log(`tests ends without 'skip' and 'only'`);
+});
+```
+
 ## Example
 
 ```js

package/lib/call-when-tests-ends.js

@@ -0,0 +1,23 @@
+import _process from 'node:process';
+import {isOnlyTests as _isOnlyTests} from './is-only-tests.js';
+import {isSkipTests as _isSkipTests} from './is-skip-tests.js';
+
+export function callWhenTestsEnds(name, fn, overrides = {}) {
+    const {
+        process = _process,
+        isOnlyTests = _isOnlyTests,
+        isSkipTests = _isSkipTests,
+    } = overrides;
+    
+    if (!process.env[name])
+        return;
+    
+    const runner = () => {
+        if (isOnlyTests() || isSkipTests())
+            return;
+        
+        process.exitCode = fn() || 0;
+    };
+    
+    process.once('exit', runner);
+}

package/lib/is-only-tests.js

@@ -1,3 +1,3 @@
 import {fullstore} from 'fullstore';
 
-export const isOnlyTests = fullstore();
+export const isOnlyTests = fullstore(false);

package/lib/is-skip-tests.js

@@ -0,0 +1,3 @@
+import {fullstore} from 'fullstore';
+
+export const isSkipTests = fullstore();

package/lib/run-tests.js

@@ -4,6 +4,7 @@ import {tryToCatch} from 'try-to-catch';
 import _isDebug from './is-debug.js';
 import {createValidator} from './validator.js';
 import {isOnlyTests} from './is-only-tests.js';
+import {isSkipTests} from './is-skip-tests.js';
 
 const inc = wraptile((store) => store(store() + 1));
 const isOnly = ({only}) => only;
@@ -41,11 +42,16 @@ export default async (tests, overrides = {}) => {
     const onlyTests = tests.filter(isOnly);
     
     if (onlyTests.length) {
-        isOnlyTests(true);
+        isOnlyTests(onlyTests.length);
+        
+        const skipped = tests.length - onlyTests.length;
+        
+        isSkipTests(skipped);
+        
         return await runTests(onlyTests, {
             formatter,
             operators,
-            skipped: tests.length - onlyTests.length,
+            skipped,
             isStop,
             isDebug,
         });
@@ -54,6 +60,8 @@ export default async (tests, overrides = {}) => {
     const notSkippedTests = tests.filter(notSkip);
     const skipped = tests.filter(isSkip).length;
     
+    isSkipTests(skipped);
+    
     return await runTests(notSkippedTests, {
         formatter,
         operators,

package/lib/supertape.d.ts

@@ -54,3 +54,5 @@ export type CustomOperator = Record<string, OperatorFactory>;
 export declare function extend(operators: CustomOperator): TestFunction;
 
 export let isOnlyTests: () => boolean;
+export let isSkipTests: () => boolean;
+export let callWhenTestsEnds: (name: string, fn: () => number | void) => void;

package/lib/supertape.js

@@ -12,6 +12,8 @@ import {createEmitter as _createEmitter} from './emitter.js';
 import {createFormatter as _createFormatter} from './formatter/index.js';
 
 export {isOnlyTests} from './is-only-tests.js';
+export {isSkipTests} from './is-skip-tests.js';
+export {callWhenTestsEnds} from './call-when-tests-ends.js';
 
 const createOnly = (test) => (message, fn, options) => {
     return test(message, fn, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "supertape",
-  "version": "12.8.0",
+  "version": "12.10.0",
   "author": "coderaiser <mnemonic.enemy@gmail.com> (https://github.com/coderaiser)",
   "description": "📼 Supertape simplest high speed test runner with superpowers",
   "homepage": "http://github.com/coderaiser/supertape",