Skip to content

Commit cd4ae7c

Browse files
targostargos
committed
2020-05-26, Version 12.17.0 'Erbium' (LTS)
Notable changes: * ECMAScript Modules - `--experimental-modules` flag removal * AsyncLocalStorage API (experimental) * REPL previews * REPL reverse-i-search * REPL substring-based search * Error monitoring * Monitoring `error` events * Monitoring uncaught exceptions * File system APIs * New function: `fs.readv` * Optional parameters in `fs.read` * Console `groupIndentation` option * `maxStringLength` option for `util.inspect()` * Stable N-API release 6 * Stable diagnostic reports * Increase of the default server headers timeout * New `--trace-sigint` CLI flag * Various crypto APIs now support Diffie-Hellman secrets * Added support for the `dns.ALL` flag in `dns.lookup()` * Added a new experimental API to interact with Source Map V3 data * Added support for passing a `transferList` along with `workerData` to the `Worker` constructor PR-URL: #33197
1 parent ebd9090 commit cd4ae7c

21 files changed

+717
-72
lines changed

‎CHANGELOG.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,8 @@ release.
2828
</tr>
2929
<tr>
3030
<td valign="top">
31-
<b><a href="doc/changelogs/CHANGELOG_V12.md#12.16.3">12.16.3</a></b><br/>
31+
<b><a href="doc/changelogs/CHANGELOG_V12.md#12.17.0">12.17.0</a></b><br/>
32+
<a href="doc/changelogs/CHANGELOG_V12.md#12.16.3">12.16.3</a><br/>
3233
<a href="doc/changelogs/CHANGELOG_V12.md#12.16.2">12.16.2</a><br/>
3334
<a href="doc/changelogs/CHANGELOG_V12.md#12.16.1">12.16.1</a><br/>
3435
<a href="doc/changelogs/CHANGELOG_V12.md#12.16.0">12.16.0</a><br/>

‎doc/api/async_hooks.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -467,7 +467,7 @@ init for PROMISE with id 6, trigger id: 5 # the Promise returned by then()
467467
#### `async_hooks.executionAsyncResource()`
468468

469469
<!-- YAML
470-
added: REPLACEME
470+
added: v12.17.0
471471
-->
472472

473473
* Returns: {Object} The resource representing the current execution.
@@ -869,7 +869,7 @@ for (let i = 0; i < 10; i++) {
869869

870870
## Class: `AsyncLocalStorage`
871871
<!-- YAML
872-
added: REPLACEME
872+
added: v12.17.0
873873
-->
874874

875875
This class is used to create asynchronous state within callbacks and promise
@@ -918,15 +918,15 @@ from each other. It is safe to instantiate this class multiple times.
918918

919919
### `new AsyncLocalStorage()`
920920
<!-- YAML
921-
added: REPLACEME
921+
added: v12.17.0
922922
-->
923923

924924
Creates a new instance of `AsyncLocalStorage`. Store is only provided within a
925925
`run` method call.
926926

927927
### `asyncLocalStorage.disable()`
928928
<!-- YAML
929-
added: REPLACEME
929+
added: v12.17.0
930930
-->
931931

932932
This method disables the instance of `AsyncLocalStorage`. All subsequent calls
@@ -946,7 +946,7 @@ in the current process.
946946

947947
### `asyncLocalStorage.getStore()`
948948
<!-- YAML
949-
added: REPLACEME
949+
added: v12.17.0
950950
-->
951951

952952
* Returns: {any}
@@ -957,7 +957,7 @@ calling `asyncLocalStorage.run`, it will return `undefined`.
957957

958958
### `asyncLocalStorage.enterWith(store)`
959959
<!-- YAML
960-
added: REPLACEME
960+
added: v12.17.0
961961
-->
962962

963963
* `store` {any}
@@ -999,7 +999,7 @@ asyncLocalStorage.getStore(); // Returns the same object
999999

10001000
### `asyncLocalStorage.run(store, callback[, ...args])`
10011001
<!-- YAML
1002-
added: REPLACEME
1002+
added: v12.17.0
10031003
-->
10041004

10051005
* `store` {any}
@@ -1034,7 +1034,7 @@ try {
10341034

10351035
### `asyncLocalStorage.exit(callback[, ...args])`
10361036
<!-- YAML
1037-
added: REPLACEME
1037+
added: v12.17.0
10381038
-->
10391039

10401040
* `callback` {Function}

‎doc/api/cli.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -129,7 +129,7 @@ Specify the file name of the CPU profile generated by `--cpu-prof`.
129129

130130
### `--disable-proto=mode`
131131
<!--YAML
132-
added: REPLACEME
132+
added: v12.17.0
133133
-->
134134

135135
Disable the `Object.prototype.__proto__` property. If `mode` is `delete`, the
@@ -625,7 +625,7 @@ warning will be written to stderr instead.
625625

626626
### `--report-compact`
627627
<!-- YAML
628-
added: REPLACEME
628+
added: v12.17.0
629629
-->
630630

631631
Write reports in a compact format, single-line JSON, more easily consumable
@@ -636,7 +636,7 @@ human consumption.
636636
<!-- YAML
637637
added: v11.8.0
638638
changes:
639-
- version: REPLACEME
639+
- version: v12.17.0
640640
pr-url: https://github.com/nodejs/node/pull/32242
641641
description: This option is no longer considered experimental.
642642
- version: v12.0.0
@@ -651,7 +651,7 @@ Location at which the report will be generated.
651651
<!-- YAML
652652
added: v11.8.0
653653
changes:
654-
- version: REPLACEME
654+
- version: v12.17.0
655655
pr-url: https://github.com/nodejs/node/pull/32242
656656
description: This option is no longer considered experimental.
657657
- version: v12.0.0
@@ -666,7 +666,7 @@ Name of the file to which the report will be written.
666666
<!-- YAML
667667
added: v11.8.0
668668
changes:
669-
- version: REPLACEME
669+
- version: v12.17.0
670670
pr-url: https://github.com/nodejs/node/pull/32496
671671
description: This option is no longer considered experimental.
672672
- version: v12.0.0
@@ -685,7 +685,7 @@ error.
685685
<!-- YAML
686686
added: v11.8.0
687687
changes:
688-
- version: REPLACEME
688+
- version: v12.17.0
689689
pr-url: https://github.com/nodejs/node/pull/32242
690690
description: This option is no longer considered experimental.
691691
- version: v12.0.0
@@ -702,7 +702,7 @@ specified through `--report-signal`.
702702
<!-- YAML
703703
added: v11.8.0
704704
changes:
705-
- version: REPLACEME
705+
- version: v12.17.0
706706
pr-url: https://github.com/nodejs/node/pull/32242
707707
description: This option is no longer considered experimental.
708708
- version: v12.0.0
@@ -718,7 +718,7 @@ Default signal is `SIGUSR2`.
718718
<!-- YAML
719719
added: v11.8.0
720720
changes:
721-
- version: REPLACEME
721+
- version: v12.17.0
722722
pr-url: https://github.com/nodejs/node/pull/32242
723723
description: This option is no longer considered experimental.
724724
- version: v12.0.0
@@ -851,7 +851,7 @@ i.e. invoking `process.exit()`.
851851

852852
### `--trace-sigint`
853853
<!-- YAML
854-
added: REPLACEME
854+
added: v12.17.0
855855
-->
856856

857857
Prints a stack trace on SIGINT.
@@ -937,7 +937,7 @@ See `SSL_CERT_DIR` and `SSL_CERT_FILE`.
937937

938938
### `--use-largepages=mode`
939939
<!-- YAML
940-
added: REPLACEME
940+
added: v12.17.0
941941
-->
942942

943943
Re-map the Node.js static code to large memory pages at startup. If supported on

‎doc/api/console.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -81,7 +81,7 @@ const { Console } = console;
8181
### `new Console(options)`
8282
<!-- YAML
8383
changes:
84-
- version: REPLACEME
84+
- version: v12.17.0
8585
pr-url: https://github.com/nodejs/node/pull/32964
8686
description: The `groupIndentation` option was introduced.
8787
- version: v11.7.0

‎doc/api/crypto.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1232,7 +1232,7 @@ passing keys as strings or `Buffer`s due to improved security features.
12321232
<!-- YAML
12331233
added: v11.6.0
12341234
changes:
1235-
- version: REPLACEME
1235+
- version: v12.17.0
12361236
pr-url: https://github.com/nodejs/node/pull/31178
12371237
description: Added support for `'dh'`.
12381238
- version: v12.0.0
@@ -2091,7 +2091,7 @@ algorithm names.
20912091

20922092
### `crypto.diffieHellman(options)`
20932093
<!-- YAML
2094-
added: REPLACEME
2094+
added: v12.17.0
20952095
-->
20962096

20972097
* `options`: {Object}
@@ -2107,7 +2107,7 @@ Both keys must have the same `asymmetricKeyType`, which must be one of `'dh'`
21072107
<!-- YAML
21082108
added: v10.12.0
21092109
changes:
2110-
- version: REPLACEME
2110+
- version: v12.17.0
21112111
pr-url: https://github.com/nodejs/node/pull/31178
21122112
description: Add support for Diffie-Hellman.
21132113
- version: v12.0.0
@@ -2180,7 +2180,7 @@ a `Promise` for an `Object` with `publicKey` and `privateKey` properties.
21802180
<!-- YAML
21812181
added: v10.12.0
21822182
changes:
2183-
- version: REPLACEME
2183+
- version: v12.17.0
21842184
pr-url: https://github.com/nodejs/node/pull/31178
21852185
description: Add support for Diffie-Hellman.
21862186
- version: v12.0.0

‎doc/api/dns.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -202,7 +202,7 @@ is not set to `true`, it returns a `Promise` for an `Object` with `address` and
202202
### Supported getaddrinfo flags
203203
<!-- YAML
204204
changes:
205-
- version: REPLACEME
205+
- version: v12.17.0
206206
pr-url: https://github.com/nodejs/node/pull/32183
207207
description: Added support for the `dns.ALL` flag.
208208
-->

‎doc/api/errors.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1868,7 +1868,7 @@ The context must be a `SecureContext`.
18681868
<a id="ERR_TLS_INVALID_STATE"></a>
18691869
### `ERR_TLS_INVALID_STATE`
18701870
<!-- YAML
1871-
added: REPLACEME
1871+
added: v12.17.0
18721872
-->
18731873

18741874
The TLS socket must be connected and securily established. Ensure the 'secure'

‎doc/api/events.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -362,7 +362,7 @@ Its `name` property is set to `'MaxListenersExceededWarning'`.
362362

363363
### `EventEmitter.errorMonitor`
364364
<!-- YAML
365-
added: REPLACEME
365+
added: v12.17.0
366366
-->
367367

368368
This symbol shall be used to install a listener for only monitoring `'error'`

‎doc/api/fs.md

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1675,7 +1675,7 @@ changes:
16751675
- version: v2.3.0
16761676
pr-url: https://github.com/nodejs/node/pull/1845
16771677
description: The passed `options` object can be a string now.
1678-
- version: REPLACEME
1678+
- version: v12.17.0
16791679
pr-url: https://github.com/nodejs/node/pull/29083
16801680
description: The `fs` options allow overriding the used `fs`
16811681
implementation.
@@ -1778,8 +1778,8 @@ changes:
17781778
- version: v2.3.0
17791779
pr-url: https://github.com/nodejs/node/pull/1845
17801780
description: The passed `options` object can be a string now.
1781-
- version: REPLACEME
1782-
pr-url: https://github.com/nodejs/node/pull/REPLACEME
1781+
- version: v12.17.0
1782+
pr-url: https://github.com/nodejs/node/pull/v12.17.0
17831783
description: The `fs` options allow overriding the used `fs`
17841784
implementation.
17851785
-->
@@ -2439,7 +2439,7 @@ Synchronous lstat(2).
24392439
<!-- YAML
24402440
added: v0.1.8
24412441
changes:
2442-
- version: REPLACEME
2442+
- version: v12.17.0
24432443
pr-url: https://github.com/nodejs/node/pull/31530
24442444
description: In `recursive` mode, the callback now receives the first
24452445
created path as an argument.
@@ -2501,7 +2501,7 @@ See also: mkdir(2).
25012501
<!-- YAML
25022502
added: v0.1.21
25032503
changes:
2504-
- version: REPLACEME
2504+
- version: v12.17.0
25052505
pr-url: https://github.com/nodejs/node/pull/31530
25062506
description: In `recursive` mode, the first created path is returned now.
25072507
- version: v10.12.0
@@ -2785,9 +2785,9 @@ a `Promise` for an `Object` with `bytesRead` and `buffer` properties.
27852785

27862786
## `fs.read(fd, [options,] callback)`
27872787
<!-- YAML
2788-
added: REPLACEME
2788+
added: v12.17.0
27892789
changes:
2790-
- version: REPLACEME
2790+
- version: v12.17.0
27912791
pr-url: https://github.com/nodejs/node/pull/31402
27922792
description: Options object can be passed in
27932793
to make Buffer, offset, length and position optional
@@ -3083,9 +3083,9 @@ this API: [`fs.read()`][].
30833083

30843084
## `fs.readSync(fd, buffer, [options])`
30853085
<!-- YAML
3086-
added: REPLACEME
3086+
added: v12.17.0
30873087
changes:
3088-
- version: REPLACEME
3088+
- version: v12.17.0
30893089
pr-url: https://github.com/nodejs/node/pull/32460
30903090
description: Options object can be passed in
30913091
to make offset, length and position optional
@@ -3109,7 +3109,7 @@ this API: [`fs.read()`][].
31093109

31103110
## `fs.readv(fd, buffers[, position], callback)`
31113111
<!-- YAML
3112-
added: REPLACEME
3112+
added: v12.17.0
31133113
-->
31143114

31153115
* `fd` {integer}
@@ -3132,7 +3132,7 @@ The callback will be given three arguments: `err`, `bytesRead`, and
31323132

31333133
## `fs.readvSync(fd, buffers[, position])`
31343134
<!-- YAML
3135-
added: REPLACEME
3135+
added: v12.17.0
31363136
-->
31373137

31383138
* `fd` {integer}
@@ -4460,7 +4460,7 @@ property that is a reference to the passed in `buffer` argument.
44604460

44614461
#### `filehandle.read(options)`
44624462
<!-- YAML
4463-
added: REPLACEME
4463+
added: v12.17.0
44644464
-->
44654465
* `options` {Object}
44664466
* `buffer` {Buffer|Uint8Array} **Default:** `Buffer.alloc(16384)`
@@ -4495,7 +4495,7 @@ of the file.
44954495

44964496
#### `filehandle.readv(buffers[, position])`
44974497
<!-- YAML
4498-
added: REPLACEME
4498+
added: v12.17.0
44994499
-->
45004500

45014501
* `buffers` {ArrayBufferView[]}

‎doc/api/modules.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1026,7 +1026,7 @@ import('fs').then((esmFS) => {
10261026
10271027
## Source Map V3 Support
10281028
<!-- YAML
1029-
added: REPLACEME
1029+
added: v12.17.0
10301030
-->
10311031
10321032
> Stability: 1 - Experimental
@@ -1045,7 +1045,7 @@ const { findSourceMap, SourceMap } = require('module');
10451045
10461046
### `module.findSourceMap(path[, error])`
10471047
<!-- YAML
1048-
added: REPLACEME
1048+
added: v12.17.0
10491049
-->
10501050
10511051
* `path` {string}
@@ -1063,7 +1063,7 @@ will be associated with the `error` instance along with the `path`.
10631063
10641064
### Class: `module.SourceMap`
10651065
<!-- YAML
1066-
added: REPLACEME
1066+
added: v12.17.0
10671067
-->
10681068
10691069
#### `new SourceMap(payload)`

0 commit comments

Comments
 (0)