.. | ||
bin | ||
node_modules | ||
src | ||
LICENSE | ||
package.json | ||
README.md |
Tape-ES
A Tape.js test runner and watcher for modern JavaScript. Works with both ES modules and CommonJS.
Features
- runs ES module tests
- runs tests in parallel for speed
- uses sensible defaults
- works with
type: module
packages
Note: Since this is an ES package, it requires Node >= v14.x
tape-es
Arguments
tape-es [pattern] -i [pattern] -r [path] -t [number]
[pattern]
- the file matcher pattern (default**/*.spec.js
)-i
|--ignore
- the ignore matcher pattern (default**/node_modules/**
)-r
|--root
- the root path to run the tests from (defaultprocess.cwd()
)-t
|--threads
- Number of threads to run concurrently (default10
)
Basic Usage
Use the defaults
tape-es
Advanced Usage
Specify custom parameters
tape-es "**/*.spec.js" -i "node_modules/**" -r ../absurdum/ -t 20
Note: In Linux/OSX the matcher patterns must be delimited in quotes.
tape-watch-es
Arguments
tape-es [pattern] -i [pattern] -r [path]
[pattern]
- the file matcher pattern (default**/*.spec.js
)-i
|--ignore
- the ignore matcher pattern (default**/node_modules/**
)-r
|--root
- the root path to run the tests from (defaultprocess.cwd()
)
Basic Usage
Use the defaults
tape-watch-es
Advanced Usage
Specify custom parameters
tape-es "**/*.spec.js" -i "node_modules/**" -r ../absurdum/
Note: In Linux/OSX the matcher patterns must be delimited in quotes.
Writing Tests
Tests are identical to Tape.js, except import
is used to load modules rather than require.
import test from 'tape';
import { arrays } from '../../index.js';
test('arrays.chunk(array) - should return a chunk for each item in the array', t => {
// ...test code
});
Tap Reporters
One of the greatest advantages to using Tape, is that it outputs results in the standard TAP format. That means you can pipe the results into a wide array of TAP reporters.
The parallel nature of this runner will break most reporters. As a General rule.
- if you want speed (ie CI/CD) don't use a reporter
- if you want speed and readability use tap-spec
- if you want to use any reporter, run tests in parallel with
tape-es -t 1