@@ -184,7 +184,7 @@ changes:
184
184
- v15.14.0
185
185
- v14.18.0
186
186
pr-url: https://github.com/nodejs/node/pull/37490
187
- description: The `data` argument supports `AsyncIterable`, `Iterable` and `Stream`.
187
+ description: The `data` argument supports `AsyncIterable`, `Iterable`, and `Stream`.
188
188
- version: v14.0.0
189
189
pr-url: https://github.com/nodejs/node/pull/31030
190
190
description: The `data` parameter won't coerce unsupported input to
@@ -690,7 +690,7 @@ changes:
690
690
- v15.14.0
691
691
- v14.18.0
692
692
pr-url: https://github.com/nodejs/node/pull/37490
693
- description: The ` data` argument supports ` AsyncIterable` , ` Iterable` and ` Stream` .
693
+ description: The ` data` argument supports ` AsyncIterable` , ` Iterable` , and ` Stream` .
694
694
- version: v14.0.0
695
695
pr-url: https://github.com/nodejs/node/pull/31030
696
696
description: The ` data` parameter won't coerce unsupported input to
@@ -704,7 +704,7 @@ changes:
704
704
* Returns: {Promise}
705
705
706
706
Asynchronously writes data to a file, replacing the file if it already exists.
707
- ` data` can be a string, a buffer, an {AsyncIterable} or {Iterable} object.
707
+ ` data` can be a string, a buffer, an {AsyncIterable}, or an {Iterable} object.
708
708
The promise is resolved with no arguments upon success.
709
709
710
710
If ` options` is a string, then it specifies the ` encoding` .
@@ -1472,7 +1472,7 @@ The `atime` and `mtime` arguments follow these rules:
1472
1472
1473
1473
* Values can be either numbers representing Unix epoch time, `Date`s, or a
1474
1474
numeric string like `'123456789.0'`.
1475
- * If the value can not be converted to a number, or is `NaN`, `Infinity` or
1475
+ * If the value can not be converted to a number, or is `NaN`, `Infinity`, or
1476
1476
`-Infinity`, an `Error` will be thrown.
1477
1477
1478
1478
### `fsPromises.watch(filename[, options])`
@@ -1536,7 +1536,7 @@ changes:
1536
1536
- v15.14.0
1537
1537
- v14.18.0
1538
1538
pr-url: https://github.com/nodejs/node/pull/37490
1539
- description: The `data` argument supports `AsyncIterable`, `Iterable` and `Stream`.
1539
+ description: The `data` argument supports `AsyncIterable`, `Iterable`, and `Stream`.
1540
1540
- version:
1541
1541
- v15.2.0
1542
1542
- v14.17.0
@@ -1559,7 +1559,7 @@ changes:
1559
1559
* Returns: {Promise} Fulfills with `undefined` upon success.
1560
1560
1561
1561
Asynchronously writes data to a file, replacing the file if it already exists.
1562
- `data` can be a string, a buffer, an {AsyncIterable} or {Iterable} object.
1562
+ `data` can be a string, a buffer, an {AsyncIterable}, or an {Iterable} object.
1563
1563
1564
1564
The `encoding` option is ignored if `data` is a buffer.
1565
1565
@@ -1684,7 +1684,7 @@ access(file, constants.R_OK | constants.W_OK, (err) => {
1684
1684
```
1685
1685
1686
1686
Do not use `fs.access()` to check for the accessibility of a file before calling
1687
- `fs.open()`, `fs.readFile()` or `fs.writeFile()`. Doing
1687
+ `fs.open()`, `fs.readFile()`, or `fs.writeFile()`. Doing
1688
1688
so introduces a race condition, since other processes may change the file's
1689
1689
state between the two calls. Instead, user code should open/read/write the
1690
1690
file directly and handle the error raised if the file is not accessible.
@@ -1971,17 +1971,17 @@ specifies the permissions for others.
1971
1971
1972
1972
For example, the octal value `0o765` means:
1973
1973
1974
- * The owner may read, write and execute the file.
1974
+ * The owner may read, write, and execute the file.
1975
1975
* The group may read and write the file.
1976
1976
* Others may read and execute the file.
1977
1977
1978
1978
When using raw numbers where file modes are expected, any value larger than
1979
1979
`0o777` may result in platform-specific behaviors that are not supported to work
1980
- consistently. Therefore constants like `S_ISVTX`, `S_ISGID` or `S_ISUID` are not
1981
- exposed in `fs.constants`.
1980
+ consistently. Therefore constants like `S_ISVTX`, `S_ISGID`, or `S_ISUID` are
1981
+ not exposed in `fs.constants`.
1982
1982
1983
1983
Caveats: on Windows only the write permission can be changed, and the
1984
- distinction among the permissions of group, owner or others is not
1984
+ distinction among the permissions of group, owner, or others is not
1985
1985
implemented.
1986
1986
1987
1987
### `fs.chown(path, uid, gid, callback)`
@@ -2354,7 +2354,7 @@ By default, the stream will emit a `'close'` event after it has been
2354
2354
destroyed. Set the `emitClose` option to `false` to change this behavior.
2355
2355
2356
2356
By providing the `fs` option it is possible to override the corresponding `fs`
2357
- implementations for `open`, `write`, `writev` and `close`. Overriding `write()`
2357
+ implementations for `open`, `write`, `writev`, and `close`. Overriding `write()`
2358
2358
without `writev()` can reduce performance as some optimizations (`_writev()`)
2359
2359
will be disabled. When providing the `fs` option, overrides for at least one of
2360
2360
`write` and `writev` are required. If no `fd` option is supplied, an override
@@ -2409,7 +2409,7 @@ has only one boolean parameter. This is one reason `fs.access()` is recommended
2409
2409
instead of `fs.exists()`.
2410
2410
2411
2411
Using `fs.exists()` to check for the existence of a file before calling
2412
- `fs.open()`, `fs.readFile()` or `fs.writeFile()` is not recommended. Doing
2412
+ `fs.open()`, `fs.readFile()`, or `fs.writeFile()` is not recommended. Doing
2413
2413
so introduces a race condition, since other processes may change the file's
2414
2414
state between the two calls. Instead, user code should open/read/write the
2415
2415
file directly and handle the error raised if the file does not exist.
@@ -2759,7 +2759,7 @@ changes:
2759
2759
it will emit a deprecation warning with id DEP0013.
2760
2760
- version: v4.1.0
2761
2761
pr-url: https://github.com/nodejs/node/pull/2387
2762
- description: Numeric strings, `NaN` and `Infinity` are now allowed
2762
+ description: Numeric strings, `NaN`, and `Infinity` are now allowed
2763
2763
time specifiers.
2764
2764
-->
2765
2765
@@ -3256,7 +3256,7 @@ changes:
3256
3256
- v12.17.0
3257
3257
pr-url: https://github.com/nodejs/node/pull/31402
3258
3258
description: Options object can be passed in
3259
- to make Buffer , offset, length and position optional.
3259
+ to make buffer , offset, length, and position optional.
3260
3260
-->
3261
3261
3262
3262
* ` fd` {integer}
@@ -3611,7 +3611,7 @@ changes:
3611
3611
* ` err` {Error }
3612
3612
* ` resolvedPath` {string| Buffer}
3613
3613
3614
- Asynchronously computes the canonical pathname by resolving ` .` , ` ..` and
3614
+ Asynchronously computes the canonical pathname by resolving ` .` , ` ..` , and
3615
3615
symbolic links.
3616
3616
3617
3617
A canonical pathname is not necessarily unique . Hard links and bind mounts can
@@ -3873,7 +3873,7 @@ Asynchronous stat(2). The callback gets two arguments `(err, stats)` where
3873
3873
In case of an error, the ` err.code` will be one of [Common System Errors][].
3874
3874
3875
3875
Using ` fs.stat()` to check for the existence of a file before calling
3876
- ` fs.open()` , ` fs.readFile()` or ` fs.writeFile()` is not recommended.
3876
+ ` fs.open()` , ` fs.readFile()` , or ` fs.writeFile()` is not recommended.
3877
3877
Instead, user code should open/ read/ write the file directly and handle the
3878
3878
error raised if the file is not available.
3879
3879
@@ -4157,7 +4157,7 @@ changes:
4157
4157
it will emit a deprecation warning with id DEP0013 .
4158
4158
- version: v4.1 .0
4159
4159
pr- url: https: // github.com/nodejs/node/pull/2387
4160
- description: Numeric strings, ` NaN` and ` Infinity` are now allowed
4160
+ description: Numeric strings, ` NaN` , and ` Infinity` are now allowed
4161
4161
time specifiers.
4162
4162
-->
4163
4163
@@ -4173,7 +4173,7 @@ The `atime` and `mtime` arguments follow these rules:
4173
4173
4174
4174
* Values can be either numbers representing Unix epoch time in seconds,
4175
4175
` Date` s, or a numeric string like ` '123456789.0'` .
4176
- * If the value can not be converted to a number, or is ` NaN` , ` Infinity` or
4176
+ * If the value can not be converted to a number, or is ` NaN` , ` Infinity` , or
4177
4177
` -Infinity` , an ` Error` will be thrown.
4178
4178
4179
4179
### ` fs.watch(filename[, options][, listener])`
@@ -5069,7 +5069,7 @@ added: v0.4.2
5069
5069
changes:
5070
5070
- version: v4.1.0
5071
5071
pr-url: https://github.com/nodejs/node/pull/2387
5072
- description: Numeric strings, ` NaN ` and ` Infinity ` are now allowed
5072
+ description: Numeric strings, ` NaN ` , and ` Infinity ` are now allowed
5073
5073
time specifiers.
5074
5074
-->
5075
5075
@@ -5431,7 +5431,7 @@ changes:
5431
5431
- v12.17.0
5432
5432
pr-url: https://github.com/nodejs/node/pull/32460
5433
5433
description: Options object can be passed in
5434
- to make offset, length and position optional.
5434
+ to make offset, length, and position optional.
5435
5435
-->
5436
5436
5437
5437
* ` fd` {integer}
@@ -5736,7 +5736,7 @@ changes:
5736
5736
protocol.
5737
5737
- version: v4.1.0
5738
5738
pr-url: https://github.com/nodejs/node/pull/2387
5739
- description: Numeric strings, ` NaN ` and ` Infinity ` are now allowed
5739
+ description: Numeric strings, ` NaN ` , and ` Infinity ` are now allowed
5740
5740
time specifiers.
5741
5741
-->
5742
5742
@@ -6363,7 +6363,7 @@ changes:
6363
6363
6364
6364
A {fs.Stats} object provides information about a file.
6365
6365
6366
- Objects returned from [` fs .stat ()` ][], [` fs .lstat ()` ][] and [` fs .fstat ()` ][] and
6366
+ Objects returned from [` fs .stat ()` ][], [` fs .lstat ()` ][], [` fs .fstat ()` ][], and
6367
6367
their synchronous counterparts are of this type.
6368
6368
If ` bigint` in the ` options` passed to those methods is true, the numeric values
6369
6369
will be ` bigint` instead of ` number` , and the object will contain additional
@@ -7010,7 +7010,7 @@ The following constants are meant for use with `fs.open()`.
7010
7010
</table>
7011
7011
7012
7012
On Windows, only ` O_APPEND ` , ` O_CREAT ` , ` O_EXCL ` , ` O_RDONLY ` , ` O_RDWR ` ,
7013
- ` O_TRUNC ` , ` O_WRONLY ` and ` UV_FS_O_FILEMAP ` are available.
7013
+ ` O_TRUNC ` , ` O_WRONLY ` , and ` UV_FS_O_FILEMAP ` are available.
7014
7014
7015
7015
##### File type constants
7016
7016
@@ -7521,7 +7521,7 @@ fs.open('<directory>', 'a+', (err, fd) => {
7521
7521
` ` `
7522
7522
7523
7523
On Windows, opening an existing hidden file using the ` ' w' ` flag (either
7524
- through ` fs .open ()` or ` fs .writeFile ()` or ` fsPromises .open ()` ) will fail with
7524
+ through ` fs .open ()` , ` fs .writeFile ()` , or ` fsPromises .open ()` ) will fail with
7525
7525
` EPERM ` . Existing hidden files can be opened for writing with the ` ' r+' ` flag.
7526
7526
7527
7527
A call to ` fs .ftruncate ()` or ` filehandle .truncate ()` can be used to reset
0 commit comments