Tape-ES

📼 A Tape test runner for modern JavaScript 📼

Features

• Runs ECMAScript module tests
• Runs CommonJS tests
• Uses sensible defaults
• Compatible with tap reporters
• Works in CI/CD pipelines

tape-es

Arguments

tape-es [...options] [files]

• [files] - File(s)/glob(s) to test (default: **/*.spec.js)
• --cwd - Current working directory
• --ignore - File(s)/glob(s) to ignore (default **/node_modules/**)
• --watch - Watch for changes to the test(s)

Usage

# run the tests
esmtk test

# run the tests (using a different naming scheme)
esmtk test **/*.test.js

# run the tests (ignore tests)
esmtk test **/*.test.js --ignore node_modules/**,src/rm.spec.js

# run the tests (change the current working directory)
esmtk test **/*.test.js --cwd src/

# run the tests (watch for changes)
esmtk test --watch

Note: In Linux/OSX, glob pattern[s] must be delimited in quotes.

Writing Tests

Tests are identical to Tape, except import is used to load modules (ie not 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
})

Configuration

Project-level config can be defined in package.json

package.json

{
  "tape" {
    "files": [ "**.*.mjs" ],
    "ignore": [ "test/**.*" ]
  }
}

Note: Configuration defined in the command-line will take precedence over package.json configuration.

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.

Recommendation:

1. if you want speed (ie CI/CD) don't use a reporter
2. if you want readability use tap-spec

tape-es | tap-spec