Skip to content

doc: clarify filtered test behavior#1725

Open
umuoy1 wants to merge 1 commit intonodejs:mainfrom
umuoy1:docs/clarify-filtered-test-behavior
Open

doc: clarify filtered test behavior#1725
umuoy1 wants to merge 1 commit intonodejs:mainfrom
umuoy1:docs/clarify-filtered-test-behavior

Conversation

@umuoy1
Copy link
Copy Markdown
Contributor

@umuoy1 umuoy1 commented Apr 16, 2026

This updates the test documentation to match the current behavior.

npm test --filter=... does not narrow the native build scope. It still runs the default
pretest step (node-gyp rebuild -C test) and only uses --filter to limit which JS
test modules are executed by node test.

This also replaces outdated npm run unit examples with the currently supported npm test --filter=... form in CONTRIBUTING.md and unit-test/README.md.

- fix outdated `npm run unit` examples
- explain that `--filter` affects test execution, not compilation scope
- note that `npm test --filter=...` still triggers the default full rebuild
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Need Triage

Development

Successfully merging this pull request may close these issues.

1 participant