GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — test_runner: add shards support · nodejs/node@b55eb2a

File tree

Expand file treeCollapse file tree
Open diff view settings
Filter options
  • doc
    • api
      • cli.md
      • test.md
    • node.1
  • lib/internal
    • main
      • test_runner.js
    • test_runner
      • runner.js
  • src
    • node_options.cc
    • node_options.h
  • test
    • fixtures/test-runner/shards
      • a.cjs
      • b.cjs
      • c.cjs
      • d.cjs
      • e.cjs
      • f.cjs
      • g.cjs
      • h.cjs
      • i.cjs
      • j.cjs
    • parallel
      • test-runner-cli.js
      • test-runner-run.mjs
Expand file treeCollapse file tree
Open diff view settings
Collapse file

‎doc/api/cli.md‎

Copy file name to clipboardExpand all lines: doc/api/cli.md
+22Lines changed: 22 additions & 0 deletions
  • Display the source diff
  • Display the rich diff
Original file line numberDiff line numberDiff line change
@@ -1289,6 +1289,27 @@ added: v18.0.0
12891289
Configures the test runner to only execute top level tests that have the `only`
12901290
option set.
12911291

1292+
### `--test-shard`
1293+
1294+
<!-- YAML
1295+
added: REPLACEME
1296+
-->
1297+
1298+
Test suite shard to execute in a format of `<index>/<total>`, where
1299+
1300+
`index` is a positive integer, index of divided parts
1301+
`total` is a positive integer, total of divided part
1302+
This command will divide all tests files into `total` equal parts,
1303+
and will run only those that happen to be in an `index` part.
1304+
1305+
For example, to split your tests suite into three parts, use this:
1306+
1307+
```bash
1308+
node --test --test-shard=1/3
1309+
node --test --test-shard=2/3
1310+
node --test --test-shard=3/3
1311+
```
1312+
12921313
### `--throw-deprecation`
12931314

12941315
<!-- YAML
@@ -1952,6 +1973,7 @@ Node.js options that are allowed are:
19521973
* `--test-only`
19531974
* `--test-reporter-destination`
19541975
* `--test-reporter`
1976+
* `--test-shard`
19551977
* `--throw-deprecation`
19561978
* `--title`
19571979
* `--tls-cipher-list`
Collapse file

‎doc/api/test.md‎

Copy file name to clipboardExpand all lines: doc/api/test.md
+5Lines changed: 5 additions & 0 deletions
  • Display the source diff
  • Display the rich diff
Original file line numberDiff line numberDiff line change
@@ -901,6 +901,11 @@ changes:
901901
If unspecified, subtests inherit this value from their parent.
902902
**Default:** `Infinity`.
903903
* `watch` {boolean} Whether to run in watch mode or not. **Default:** `false`.
904+
* `shard` {Object} Running tests in a specific shard. **Default:** `undefined`.
905+
* `index` {number} is a positive integer between 1 and `<total>`
906+
that specifies the index of the shard to run. This option is _required_.
907+
* `total` {number} is a positive integer that specifies the total number
908+
of shards to split the test files to. This option is _required_.
904909
* Returns: {TestsStream}
905910

906911
```mjs
Collapse file

‎doc/node.1‎

Copy file name to clipboardExpand all lines: doc/node.1
+3Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -409,6 +409,9 @@ The destination for the corresponding test reporter.
409409
Configures the test runner to only execute top level tests that have the `only`
410410
option set.
411411
.
412+
.It Fl -test-shard
413+
Test suite shard to execute in a format of <index>/<total>.
414+
.
412415
.It Fl -throw-deprecation
413416
Throw errors for deprecations.
414417
.
Collapse file

‎lib/internal/main/test_runner.js‎

Copy file name to clipboardExpand all lines: lib/internal/main/test_runner.js
+36-1Lines changed: 36 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,16 @@ const { getOptionValue } = require('internal/options');
77
const { isUsingInspector } = require('internal/util/inspector');
88
const { run } = require('internal/test_runner/runner');
99
const { setupTestReporters } = require('internal/test_runner/utils');
10+
const {
11+
codes: {
12+
ERR_INVALID_ARG_VALUE,
13+
},
14+
} = require('internal/errors');
15+
const {
16+
NumberParseInt,
17+
RegExpPrototypeExec,
18+
StringPrototypeSplit,
19+
} = primordials;
1020

1121
prepareMainThreadExecution(false);
1222
markBootstrapComplete();
@@ -21,7 +31,32 @@ if (isUsingInspector()) {
2131
inspectPort = process.debugPort;
2232
}
2333

24-
run({ concurrency, inspectPort, watch: getOptionValue('--watch'), setup: setupTestReporters })
34+
let shard;
35+
const shardOption = getOptionValue('--test-shard');
36+
if (shardOption) {
37+
if (!RegExpPrototypeExec(/^\d+\/\d+$/, shardOption)) {
38+
process.exitCode = 1;
39+
40+
throw new ERR_INVALID_ARG_VALUE(
41+
'--test-shard',
42+
shardOption,
43+
'must be in the form of <index>/<total>',
44+
);
45+
}
46+
47+
const { 0: indexStr, 1: totalStr } = StringPrototypeSplit(shardOption, '/');
48+
49+
const index = NumberParseInt(indexStr, 10);
50+
const total = NumberParseInt(totalStr, 10);
51+
52+
shard = {
53+
__proto__: null,
54+
index,
55+
total,
56+
};
57+
}
58+
59+
run({ concurrency, inspectPort, watch: getOptionValue('--watch'), setup: setupTestReporters, shard })
2560
.once('test:fail', () => {
2661
process.exitCode = 1;
2762
});
Collapse file

‎lib/internal/test_runner/runner.js‎

Copy file name to clipboardExpand all lines: lib/internal/test_runner/runner.js
+31-3Lines changed: 31 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -39,10 +39,18 @@ const console = require('internal/console/global');
3939
const {
4040
codes: {
4141
ERR_INVALID_ARG_TYPE,
42+
ERR_INVALID_ARG_VALUE,
4243
ERR_TEST_FAILURE,
44+
ERR_OUT_OF_RANGE,
4345
},
4446
} = require('internal/errors');
45-
const { validateArray, validateBoolean, validateFunction } = require('internal/validators');
47+
const {
48+
validateArray,
49+
validateBoolean,
50+
validateFunction,
51+
validateObject,
52+
validateInteger,
53+
} = require('internal/validators');
4654
const { getInspectPort, isUsingInspector, isInspectorMessage } = require('internal/util/inspector');
4755
const { isRegExp } = require('internal/util/types');
4856
const { kEmptyObject } = require('internal/util');
@@ -459,7 +467,7 @@ function run(options) {
459467
if (options === null || typeof options !== 'object') {
460468
options = kEmptyObject;
461469
}
462-
let { testNamePatterns } = options;
470+
let { testNamePatterns, shard } = options;
463471
const { concurrency, timeout, signal, files, inspectPort, watch, setup } = options;
464472

465473
if (files != null) {
@@ -468,6 +476,22 @@ function run(options) {
468476
if (watch != null) {
469477
validateBoolean(watch, 'options.watch');
470478
}
479+
if (shard != null) {
480+
validateObject(shard, 'options.shard');
481+
// Avoid re-evaluating the shard object in case it's a getter
482+
shard = { __proto__: null, index: shard.index, total: shard.total };
483+
484+
validateInteger(shard.total, 'options.shard.total', 1);
485+
validateInteger(shard.index, 'options.shard.index');
486+
487+
if (shard.index <= 0 || shard.total < shard.index) {
488+
throw new ERR_OUT_OF_RANGE('options.shard.index', `>= 1 && <= ${shard.total} ("options.shard.total")`, shard.index);
489+
}
490+
491+
if (watch) {
492+
throw new ERR_INVALID_ARG_VALUE('options.shard', watch, 'shards not supported with watch mode');
493+
}
494+
}
471495
if (setup != null) {
472496
validateFunction(setup, 'options.setup');
473497
}
@@ -489,7 +513,11 @@ function run(options) {
489513
}
490514

491515
const root = createTestTree({ concurrency, timeout, signal });
492-
const testFiles = files ?? createTestFileList();
516+
let testFiles = files ?? createTestFileList();
517+
518+
if (shard) {
519+
testFiles = ArrayPrototypeFilter(testFiles, (_, index) => index % shard.total === shard.index - 1);
520+
}
493521

494522
let postRun = () => root.postRun();
495523
let filesWatcher;
Collapse file

‎src/node_options.cc‎

Copy file name to clipboardExpand all lines: src/node_options.cc
+4Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -581,6 +581,10 @@ EnvironmentOptionsParser::EnvironmentOptionsParser() {
581581
"run tests with 'only' option set",
582582
&EnvironmentOptions::test_only,
583583
kAllowedInEnvvar);
584+
AddOption("--test-shard",
585+
"run test at specific shard",
586+
&EnvironmentOptions::test_shard,
587+
kAllowedInEnvvar);
584588
AddOption("--test-udp-no-try-send", "", // For testing only.
585589
&EnvironmentOptions::test_udp_no_try_send);
586590
AddOption("--throw-deprecation",
Collapse file

‎src/node_options.h‎

Copy file name to clipboardExpand all lines: src/node_options.h
+1Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -161,6 +161,7 @@ class EnvironmentOptions : public Options {
161161
std::vector<std::string> test_reporter_destination;
162162
bool test_only = false;
163163
bool test_udp_no_try_send = false;
164+
std::string test_shard;
164165
bool throw_deprecation = false;
165166
bool trace_atomics_wait = false;
166167
bool trace_deprecation = false;
Collapse file

‎test/fixtures/test-runner/shards/a.cjs‎

Copy file name to clipboard
+4Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
'use strict';
2+
const test = require('node:test');
3+
4+
test('a.cjs this should pass');
Collapse file

‎test/fixtures/test-runner/shards/b.cjs‎

Copy file name to clipboard
+4Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
'use strict';
2+
const test = require('node:test');
3+
4+
test('b.cjs this should pass');
Collapse file

‎test/fixtures/test-runner/shards/c.cjs‎

Copy file name to clipboard
+4Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
'use strict';
2+
const test = require('node:test');
3+
4+
test('c.cjs this should pass');

0 commit comments

Comments
0 (0)
You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.