@exodus/test v1.0.0-rc.59
@exodus/test
A runner for node:test
, jest
, and tape
test suites on top of node:test
(and any runtime)
Features
- Native ESM, including in Jest tests
- Esbuild on the fly for babelified ESM interop (enable via
--esbuild
) - TypeScript support in both transform (through tsx, enable via
--esbuild
) and typestrip (via--typescript
) modes - Runs on node:test, and (experimental) on bun, deno, d8, JSC and Hermes
- Testsuite-agnostic -- can run any file as long as it sets exit code based on test results
- Built-in Jest compatibility (with
--jest
), includingjest.*
global- Up to ~10x faster depending on the original setup
- Actual
expect
module, alsojest-extended
andjest-when
just work on top - Snapshots, including snapshot matchers
- Function and timer mocks
- test.concurrent
- Module mocks (on top of Node.js runtime only), including for ESM modules
- Loads Jest configuration
- It works on Hermes too!
- Built-in network record/replay for offline tests, mocking
fetch
andWebSocket
sessions --drop-network
support for guaranteed offline testing- Native code coverage via v8 (Node.js or c8), with istanbul reporters
- GitHub reporter (auto-enabled by default)
- JSDOM env support
- Hanging tests error by default (unlike
jest
) - Babel support, picks up your Babel config (enable via
--babel
) - Unlike
bun:test
, it runs test files in isolated contexts \ Bun leaks globals / side effects between test files (ref), and has incompatibletest()
lifecycle / order - Also features a tape API for drop-in replacement
Reporter samples
CLI (but uses colors when output supports them, e.g. in terminal):
# tests/jest/expect.mock.test.js
✔ PASS drinkAll > drinks something lemon-flavoured (1.300417ms)
✔ PASS drinkAll > does not drink something octopus-flavoured (0.191791ms)
✔ PASS drinkAll (1.842959ms)
✔ PASS drinkEach > drinkEach drinks each drink (0.360625ms)
✔ PASS drinkEach (0.463416ms)
✔ PASS toHaveBeenCalledWith > registration applies correctly to orange La Croix (0.53325ms)
✔ PASS toHaveBeenCalledWith (0.564166ms)
✔ PASS toHaveBeenLastCalledWith > applying to all flavors does mango last (0.380375ms)
✔ PASS toHaveBeenLastCalledWith (0.473417ms)
# tests/jest/fn.invocationCallOrder.test.js
✔ PASS mock.invocationCallOrder (4.221042ms)
GitHub Actions collapses test results per-file, like this:
See live output in CI
Library
List of exports
@exodus/test/node
--node:test
API, working under non-Node.js platforms@exodus/test/jest
--jest
implementation@exodus/test/tape
--tape
mock (can also be helpful when moving fromtap
)
Binary
Just use "test": "exodus-test"
Options
--jest
-- register jest test helpers as global variables, also loadjest.config.*
configuration options--esbuild
-- use esbuild loader, also enables Typescript support--babel
-- use babel loader (slower than--esbuild
, makes sense if you have a special config)--coverage
-- enable coverage, prints coverage output (varies by coverage engine)--coverage-engine c8
-- use c8 coverage engine (default), also generates./coverage/
dirs--coverage-engine node
-- use Node.js builtint coverage engine--watch
-- operate in watch mode and re-run tests on file changes--only
-- only run the tests marked withtest.only
--passWithNoTests
-- do not error when no test files were found--write-snapshots
-- write snapshots instead of verifying them (has--test-update-snapshots
alias)--test-force-exit
-- force exit after tests are done (useful in integration tests where it could be unfeasible to resolve all open handles)
License
9 months ago
9 months ago
9 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
11 months ago
11 months ago
11 months ago
11 months ago
11 months ago
11 months ago
11 months ago
11 months ago
12 months ago
12 months ago
12 months ago
12 months ago
12 months ago
12 months ago
12 months ago
12 months ago
12 months ago
12 months ago
12 months ago
12 months ago
12 months ago
12 months ago
12 months ago
12 months ago
12 months ago
12 months ago
12 months ago
12 months ago
12 months ago
12 months ago
12 months ago
12 months ago
12 months ago
12 months ago
12 months ago
12 months ago
12 months ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago