A basic test-functions-as-global library on top of node:test
npm install @polkadot/dev-testThis is a very basic Jest-compatible environment that could be used alongside tests. The need for this came from replacing Jest with node --test without rewriting all assertions.
It provides the following -
1. Browser window, document, navigator (see usage for browser-specific path)
2. jest functions, specifically spyOn (not comprehensive, some will error, some witll noop)
3. expect functions (not comprehensive, caters for specific polkadot-js usage)
On thing to note is that node:test is still rapidly evolving - this includes the APIs and features. As such this requires at least Node 18.14, however 18.15+ is recommended.
The entry points are different based on the environment you would like to operate in. For a browser-like environment,
``
node --require @polkadot/dev-test/browser ...
or for a basic describe/expect/jest-only global environment
`
node --require @polkadot/dev-test/node ...
The ... above indicates any additional Node options, for instance a full command could be -
`
node --require @polkadot/dev-test/node --test something.test.js