tapx

Native ESM Support for node-tap

Usage no npm install needed!

<script type="module">
  import tapx from 'https://cdn.skypack.dev/tapx';
</script>

README

tapx

Native ESM Support for node-tap

Supports the following:

import { test } from 'tapx'

It also overrides the tap test runner so that the TAP_NO_ESM environment variable is set. This (counterintuitively) allows node-tap to work with native ESM modules - because it suppresses faux-ESM support.

nyc currently does not work with native ESM. tapx uses c8 to provide coverage instead.

Due to some coverage bugs on Node 12 or below, coverage is not generated at all for Node 12 or below. Tests will still run. Use Node 14 to check coverage.

An additional cov command is also provided, which is the equivalent to tap --coverage-report=HTML.

This module (at least the version 0.x.x) line will be deprecated when https://github.com/tapjs/node-tap/pull/668/files lands and when node-tap has coverage support for native ESM.

Snapshots are modified so that they're saved with a .cjs extension instead of .js. This prevents "type": "module" in a project's package.json from invalidating CommonJS .js files in the tap-snapshots folder.

ESM Mocking

As of v0.1.0 tapx now comes integrated with mockalicious.

import { test, mockalicious } from 'tapx'

const load = mockalicious(import.meta.url)

test('..', async ({ok}) => {
  const myModule = load('../index.js', {
    moduleToMock: {
      default () {
        // mocking default export...
      },
      foo: 1, //mocking other exports
    }
  })
  ok('hooray')
})

See the mockalicious repository for more information.

License

ISC