1
0
Fork 0
mirror of https://github.com/denoland/deno.git synced 2024-12-25 08:39:09 -05:00
denoland-deno/tests/node_compat/runner/README.md
Asher Gomez 29085895c9
chore: move tools/node_compat to tests/node_compat/runner (#23025)
The `tools/node_compat/node` submodule has been moved to
`tests/node_compat/runner/suite` and the remaining files within
`tools/node_compat` to `tests/node_compat/runner`.

Most of the changes are of the header within `tests/node_compat/test`
files. The `setup` and `test` tasks within `tests/node_comapt` execute
successfully.

Towards #22525
CC @mmastrac
2024-04-03 09:24:55 +11:00

50 lines
1.9 KiB
Markdown

# Tools for Node.js compatibility work
We run
[native Node.js test cases](https://github.com/nodejs/node/tree/main/test)
against our Node.js compatibility feature.
This directory includes the tools for downloading, setting up, and updating the
Node.js compat testing in Deno repository.
- `//tests/node_compat/runner/setup.ts`
- This script sets up the Node.js compat tests.
- `//tests/node_compat/runner/versions/`
- Node.js source tarballs and extracted test cases are stored here.
- `//tests/node_compat/config.jsonc`
- This json file stores the settings about which Node.js compat test to run
with Deno.
- `//tests/node_compat/test`
- The actual test cases are stored here.
## Steps to add new test cases from Node.js test cases
1. Update `tests` property of `//tests/node_compat/config.jsonc`. For example,
if you want to add `test/parallel/test-foo.js` from Node.js test cases, then
add `test-foo.js` entry in `tests.parallel` array property in `config.jsonc`
1. Run `deno task setup` in `tests/node_compat/runner` dir.
The above command copies the updated items from Node.js tarball to the Deno
source tree.
Ideally Deno should pass the Node.js compat tests without modification, but if
you need to modify it, then add that item in `ignore` property of
`config.jsonc`. Then `setup.ts` doesn't overwrite the modified Node.js test
cases anymore.
If the test needs to be ignored in particular platform, then add them in
`${platform}Ignore` property of `config.jsonc`
## Run Node.js test cases
Node.js compat tests are run as part of `cargo test` command. If you want to run
only the Node.js compat test cases you can use the command
`cargo test node_compat`. If you want to run specific tests you can use the
command `deno task test` (in `tests/node_compat/runner` dir). For example, if
you want to run all test files which contains `buffer` in filename you can use
the command:
```shellsession
/path/to/deno/tests/node_compat/runner
$ deno task test buffer
```