mirror of
https://github.com/vercel-labs/scriptc.git
synced 2026-11-01 07:33:12 +08:00
Chris Tate
f67678b422
After socket.setEncoding(enc), socket.pipe(destination) wrote the raw bytes it read to the destination. It now writes the decoded strings, as Node's pipe writes each string chunk: the destination receives their UTF-8 bytes, and a partial character the decoder holds at EOF is written before the destination ends. tests/node-parallel/run.mjs runs each job's files with its own TEST_THREAD_ID, as Node's test runner does, so test/common/tmpdir gives concurrent files different directories instead of one shared .tmp.0.
24 lines
2.1 KiB
Markdown
24 lines
2.1 KiB
Markdown
# Node test/parallel files
|
|
|
|
`run.mjs` builds files from a Node.js checkout's `test/parallel` with scriptc, runs each executable in that directory, and compares its exit status with Node's. It records a verdict per file: `pass` (the same exit code, or the same terminating signal), `fail` (a different exit code or signal), or `refused` (the build failed), with the first error line.
|
|
|
|
```bash
|
|
git clone --depth 1 --branch v24.22.0 https://github.com/nodejs/node /path/to/node
|
|
node tests/node-parallel/run.mjs --node /path/to/node --pattern '^test-(url-|whatwg-url-|querystring)'
|
|
```
|
|
|
|
Options:
|
|
|
|
- `--node`: a Node.js checkout, or its `test` directory. Use the version in `.node-version`.
|
|
- `--pattern`: a regular expression over file names in `test/parallel`.
|
|
- `--common`: `minimal` (the default) or `node`.
|
|
- `minimal` copies the selected files into `<out>/tree/test/parallel` and uses `common/index.cjs`, `common/wpt.cjs` and `common/tmpdir.cjs` from this directory as `test/common/index.js`, `test/common/wpt.js` and `test/common/tmpdir.js`, with the checkout's `test/fixtures`, `test/common/fixtures.js`, `test/common/dns.js` and `test/common/internet.js`. The minimal common has the helpers these files use (`mustCall`, `mustNotCall`, `mustSucceed`, `skip`, `expectWarning`, `expectsError`, `invalidArgTypeHelper`, `spawnPromisified`, `hasIntl`, `isWindows`, `PIPE`, ...) with Node's semantics, so a verdict measures the module under test rather than Node's full `test/common`.
|
|
- `node` builds the files in place against Node's own `test/common`.
|
|
- `--out`: where executables and results go (default `node_modules/.cache/scriptc-node-parallel`).
|
|
- `--cli`: the scriptc CLI entry (default `packages/cli/dist/main.js`).
|
|
- `--jobs`: concurrent files (default 4).
|
|
|
|
Node runs each file with its `// Flags:` line. Each job runs its files with its own `TEST_THREAD_ID`, as Node's test runner does, so `test/common/tmpdir` gives concurrent files different directories. Results are written to `<out>/results.json` and `<out>/results.md`.
|
|
|
|
Before a lane relies on the minimal common, run its files under Node in `<out>/tree/test/parallel`: they should all pass there.
|