@@ -143,8 +143,8 @@ platforms. This is true regardless of entries in the table below.
143
143
community will only address issues that reproduce on native GNU/Linux
144
144
systems. Issues that only reproduce on WSL should be reported in the
145
145
[ WSL issue tracker] ( https://github.com/Microsoft/WSL/issues ) . Running the
146
- Windows binary (` node.exe ` ) in WSL is not recommended. It will not work
147
- without workarounds such as stdio redirection.
146
+ Windows binary (` node.exe ` ) in WSL will not work without workarounds such as
147
+ stdio redirection.
148
148
149
149
[ ^ 6 ] : Running Node.js on x86 Windows should work and binaries
150
150
are provided. However, tests in our infrastructure only run on WoW64.
@@ -306,8 +306,7 @@ $ make test-only
306
306
307
307
At this point, you are ready to make code changes and re-run the tests.
308
308
309
- If you are running tests before submitting a pull request, the recommended
310
- command is:
309
+ If you are running tests before submitting a pull request, use:
311
310
312
311
``` console
313
312
$ make -j4 test
@@ -316,31 +315,34 @@ $ make -j4 test
316
315
` make -j4 test ` does a full check on the codebase, including running linters and
317
316
documentation tests.
318
317
319
- Make sure the linter does not report any issues and that all tests pass. Please
320
- do not submit patches that fail either check.
321
-
322
- If you want to run the linter without running tests, use
318
+ To run the linter without running tests, use
323
319
` make lint ` /` vcbuild lint ` . It will lint JavaScript, C++, and Markdown files.
324
320
325
321
If you are updating tests and want to run tests in a single test file
326
322
(e.g. ` test/parallel/test-stream2-transform.js ` ):
327
323
328
324
``` text
329
- $ python tools/test.py test/parallel/test-stream2-transform.js
325
+ $ tools/test.py test/parallel/test-stream2-transform.js
330
326
```
331
327
332
328
You can execute the entire suite of tests for a given subsystem
333
329
by providing the name of a subsystem:
334
330
335
331
``` text
336
- $ python tools/test.py -J --mode=release child-process
332
+ $ tools/test.py -J child-process
333
+ ```
334
+
335
+ You can also execute the tests in a tests directory (such as ` test/message ` ):
336
+
337
+ ``` text
338
+ $ tools/test.py -J test/message
337
339
```
338
340
339
341
If you want to check the other options, please refer to the help by using
340
342
the ` --help ` option:
341
343
342
344
``` text
343
- $ python tools/test.py --help
345
+ $ tools/test.py --help
344
346
```
345
347
346
348
You can usually run tests directly with node:
@@ -355,7 +357,7 @@ the `lib` or `src` directories.
355
357
The tests attempt to detect support for IPv6 and exclude IPv6 tests if
356
358
appropriate. If your main interface has IPv6 addresses, then your
357
359
loopback interface must also have '::1' enabled. For some default installations
358
- on Ubuntu that does not seem to be the case. To enable '::1' on the
360
+ on Ubuntu, that does not seem to be the case. To enable '::1' on the
359
361
loopback interface on Ubuntu:
360
362
361
363
``` bash
@@ -364,7 +366,7 @@ sudo sysctl -w net.ipv6.conf.lo.disable_ipv6=0
364
366
365
367
You can use
366
368
[ node-code-ide-configs] ( https://github.com/nodejs/node-code-ide-configs )
367
- to run/debug tests, if your IDE configs are present.
369
+ to run/debug tests if your IDE configs are present.
368
370
369
371
#### Running coverage
370
372
@@ -392,7 +394,7 @@ If you are updating tests and want to collect coverage for a single test file
392
394
393
395
``` text
394
396
$ make coverage-clean
395
- $ NODE_V8_COVERAGE=coverage/tmp python tools/test.py test/parallel/test-stream2-transform.js
397
+ $ NODE_V8_COVERAGE=coverage/tmp tools/test.py test/parallel/test-stream2-transform.js
396
398
$ make coverage-report-js
397
399
```
398
400
@@ -401,7 +403,7 @@ by providing the name of a subsystem:
401
403
402
404
``` text
403
405
$ make coverage-clean
404
- $ NODE_V8_COVERAGE=coverage/tmp python tools/test.py -J --mode=release child-process
406
+ $ NODE_V8_COVERAGE=coverage/tmp tools/test.py -J --mode=release child-process
405
407
$ make coverage-report-js
406
408
```
407
409
0 commit comments