@@ -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
@@ -641,7 +641,7 @@ added: v10.0.0
641
641
changes:
642
642
- version: v15.14.0
643
643
pr-url: https://github.com/nodejs/node/pull/37490
644
- description: The ` data` argument supports ` AsyncIterable` , ` Iterable` and ` Stream` .
644
+ description: The ` data` argument supports ` AsyncIterable` , ` Iterable` , and ` Stream` .
645
645
- version: v14.0.0
646
646
pr-url: https://github.com/nodejs/node/pull/31030
647
647
description: The ` data` parameter won't coerce unsupported input to
@@ -655,7 +655,7 @@ changes:
655
655
* Returns: {Promise}
656
656
657
657
Asynchronously writes data to a file, replacing the file if it already exists.
658
- ` data` can be a string, a buffer, an {AsyncIterable} or {Iterable} object.
658
+ ` data` can be a string, a buffer, an {AsyncIterable}, or an {Iterable} object.
659
659
The promise is resolved with no arguments upon success.
660
660
661
661
If ` options` is a string, then it specifies the ` encoding` .
@@ -1447,7 +1447,7 @@ The `atime` and `mtime` arguments follow these rules:
1447
1447
1448
1448
* Values can be either numbers representing Unix epoch time, `Date`s, or a
1449
1449
numeric string like `'123456789.0'`.
1450
- * If the value can not be converted to a number, or is `NaN`, `Infinity` or
1450
+ * If the value can not be converted to a number, or is `NaN`, `Infinity`, or
1451
1451
`-Infinity`, an `Error` will be thrown.
1452
1452
1453
1453
### `fsPromises.watch(filename[, options])`
@@ -1507,7 +1507,7 @@ added: v10.0.0
1507
1507
changes:
1508
1508
- version: v15.14.0
1509
1509
pr-url: https://github.com/nodejs/node/pull/37490
1510
- description: The `data` argument supports `AsyncIterable`, `Iterable` and `Stream`.
1510
+ description: The `data` argument supports `AsyncIterable`, `Iterable`, and `Stream`.
1511
1511
- version:
1512
1512
- v15.2.0
1513
1513
- v14.17.0
@@ -1530,7 +1530,7 @@ changes:
1530
1530
* Returns: {Promise} Fulfills with `undefined` upon success.
1531
1531
1532
1532
Asynchronously writes data to a file, replacing the file if it already exists.
1533
- `data` can be a string, a buffer, an {AsyncIterable} or {Iterable} object.
1533
+ `data` can be a string, a buffer, an {AsyncIterable}, or an {Iterable} object.
1534
1534
1535
1535
The `encoding` option is ignored if `data` is a buffer.
1536
1536
@@ -1650,7 +1650,7 @@ access(file, constants.R_OK | constants.W_OK, (err) => {
1650
1650
```
1651
1651
1652
1652
Do not use `fs.access()` to check for the accessibility of a file before calling
1653
- `fs.open()`, `fs.readFile()` or `fs.writeFile()`. Doing
1653
+ `fs.open()`, `fs.readFile()`, or `fs.writeFile()`. Doing
1654
1654
so introduces a race condition, since other processes may change the file's
1655
1655
state between the two calls. Instead, user code should open/read/write the
1656
1656
file directly and handle the error raised if the file is not accessible.
@@ -1927,17 +1927,17 @@ specifies the permissions for others.
1927
1927
1928
1928
For example, the octal value `0o765` means:
1929
1929
1930
- * The owner may read, write and execute the file.
1930
+ * The owner may read, write, and execute the file.
1931
1931
* The group may read and write the file.
1932
1932
* Others may read and execute the file.
1933
1933
1934
1934
When using raw numbers where file modes are expected, any value larger than
1935
1935
`0o777` may result in platform-specific behaviors that are not supported to work
1936
- consistently. Therefore constants like `S_ISVTX`, `S_ISGID` or `S_ISUID` are not
1937
- exposed in `fs.constants`.
1936
+ consistently. Therefore constants like `S_ISVTX`, `S_ISGID`, or `S_ISUID` are
1937
+ not exposed in `fs.constants`.
1938
1938
1939
1939
Caveats: on Windows only the write permission can be changed, and the
1940
- distinction among the permissions of group, owner or others is not
1940
+ distinction among the permissions of group, owner, or others is not
1941
1941
implemented.
1942
1942
1943
1943
### `fs.chown(path, uid, gid, callback)`
@@ -2286,7 +2286,7 @@ By default, the stream will emit a `'close'` event after it has been
2286
2286
destroyed. Set the `emitClose` option to `false` to change this behavior.
2287
2287
2288
2288
By providing the `fs` option it is possible to override the corresponding `fs`
2289
- implementations for `open`, `write`, `writev` and `close`. Overriding `write()`
2289
+ implementations for `open`, `write`, `writev`, and `close`. Overriding `write()`
2290
2290
without `writev()` can reduce performance as some optimizations (`_writev()`)
2291
2291
will be disabled. When providing the `fs` option, overrides for at least one of
2292
2292
`write` and `writev` are required. If no `fd` option is supplied, an override
@@ -2336,7 +2336,7 @@ has only one boolean parameter. This is one reason `fs.access()` is recommended
2336
2336
instead of `fs.exists()`.
2337
2337
2338
2338
Using `fs.exists()` to check for the existence of a file before calling
2339
- `fs.open()`, `fs.readFile()` or `fs.writeFile()` is not recommended. Doing
2339
+ `fs.open()`, `fs.readFile()`, or `fs.writeFile()` is not recommended. Doing
2340
2340
so introduces a race condition, since other processes may change the file's
2341
2341
state between the two calls. Instead, user code should open/read/write the
2342
2342
file directly and handle the error raised if the file does not exist.
@@ -2651,7 +2651,7 @@ changes:
2651
2651
it will emit a deprecation warning with id DEP0013.
2652
2652
- version: v4.1.0
2653
2653
pr-url: https://github.com/nodejs/node/pull/2387
2654
- description: Numeric strings, `NaN` and `Infinity` are now allowed
2654
+ description: Numeric strings, `NaN`, and `Infinity` are now allowed
2655
2655
time specifiers.
2656
2656
-->
2657
2657
@@ -3097,7 +3097,7 @@ changes:
3097
3097
- v12.17.0
3098
3098
pr-url: https://github.com/nodejs/node/pull/31402
3099
3099
description: Options object can be passed in
3100
- to make Buffer , offset, length and position optional.
3100
+ to make buffer , offset, length, and position optional.
3101
3101
-->
3102
3102
3103
3103
* ` fd` {integer}
@@ -3424,7 +3424,7 @@ changes:
3424
3424
* ` err` {Error }
3425
3425
* ` resolvedPath` {string| Buffer}
3426
3426
3427
- Asynchronously computes the canonical pathname by resolving ` .` , ` ..` and
3427
+ Asynchronously computes the canonical pathname by resolving ` .` , ` ..` , and
3428
3428
symbolic links.
3429
3429
3430
3430
A canonical pathname is not necessarily unique . Hard links and bind mounts can
@@ -3663,7 +3663,7 @@ Asynchronous stat(2). The callback gets two arguments `(err, stats)` where
3663
3663
In case of an error, the ` err.code` will be one of [Common System Errors][].
3664
3664
3665
3665
Using ` fs.stat()` to check for the existence of a file before calling
3666
- ` fs.open()` , ` fs.readFile()` or ` fs.writeFile()` is not recommended.
3666
+ ` fs.open()` , ` fs.readFile()` , or ` fs.writeFile()` is not recommended.
3667
3667
Instead, user code should open/ read/ write the file directly and handle the
3668
3668
error raised if the file is not available.
3669
3669
@@ -3927,7 +3927,7 @@ changes:
3927
3927
it will emit a deprecation warning with id DEP0013.
3928
3928
- version: v4.1.0
3929
3929
pr-url: https://github.com/nodejs/node/pull/2387
3930
- description: Numeric strings, `NaN` and `Infinity` are now allowed
3930
+ description: Numeric strings, `NaN`, and `Infinity` are now allowed
3931
3931
time specifiers.
3932
3932
-->
3933
3933
@@ -3943,7 +3943,7 @@ The `atime` and `mtime` arguments follow these rules:
3943
3943
3944
3944
* Values can be either numbers representing Unix epoch time in seconds,
3945
3945
`Date`s, or a numeric string like `' 123456789.0 ' `.
3946
- * If the value can not be converted to a number, or is `NaN`, `Infinity` or
3946
+ * If the value can not be converted to a number, or is `NaN`, `Infinity`, or
3947
3947
`-Infinity`, an `Error` will be thrown.
3948
3948
3949
3949
### `fs.watch(filename[, options][, listener])`
@@ -4812,7 +4812,7 @@ added: v0.4.2
4812
4812
changes:
4813
4813
- version: v4.1.0
4814
4814
pr-url: https://github.com/nodejs/node/pull/2387
4815
- description: Numeric strings, ` NaN ` and ` Infinity ` are now allowed
4815
+ description: Numeric strings, ` NaN ` , and ` Infinity ` are now allowed
4816
4816
time specifiers.
4817
4817
-->
4818
4818
@@ -5172,7 +5172,7 @@ changes:
5172
5172
- v12.17.0
5173
5173
pr-url: https://github.com/nodejs/node/pull/32460
5174
5174
description: Options object can be passed in
5175
- to make offset, length and position optional.
5175
+ to make offset, length, and position optional.
5176
5176
-->
5177
5177
5178
5178
* ` fd` {integer}
@@ -5475,7 +5475,7 @@ changes:
5475
5475
protocol.
5476
5476
- version: v4.1.0
5477
5477
pr-url: https://github.com/nodejs/node/pull/2387
5478
- description: Numeric strings, ` NaN ` and ` Infinity ` are now allowed
5478
+ description: Numeric strings, ` NaN ` , and ` Infinity ` are now allowed
5479
5479
time specifiers.
5480
5480
-->
5481
5481
@@ -6095,7 +6095,7 @@ changes:
6095
6095
6096
6096
A {fs.Stats} object provides information about a file.
6097
6097
6098
- Objects returned from [` fs .stat ()` ][], [` fs .lstat ()` ][] and [` fs .fstat ()` ][] and
6098
+ Objects returned from [` fs .stat ()` ][], [` fs .lstat ()` ][], [` fs .fstat ()` ][], and
6099
6099
their synchronous counterparts are of this type.
6100
6100
If ` bigint` in the ` options` passed to those methods is true, the numeric values
6101
6101
will be ` bigint` instead of ` number` , and the object will contain additional
@@ -6742,7 +6742,7 @@ The following constants are meant for use with `fs.open()`.
6742
6742
</table>
6743
6743
6744
6744
On Windows, only ` O_APPEND ` , ` O_CREAT ` , ` O_EXCL ` , ` O_RDONLY ` , ` O_RDWR ` ,
6745
- ` O_TRUNC ` , ` O_WRONLY ` and ` UV_FS_O_FILEMAP ` are available.
6745
+ ` O_TRUNC ` , ` O_WRONLY ` , and ` UV_FS_O_FILEMAP ` are available.
6746
6746
6747
6747
##### File type constants
6748
6748
@@ -7253,7 +7253,7 @@ fs.open('<directory>', 'a+', (err, fd) => {
7253
7253
` ` `
7254
7254
7255
7255
On Windows, opening an existing hidden file using the ` ' w' ` flag (either
7256
- through ` fs .open ()` or ` fs .writeFile ()` or ` fsPromises .open ()` ) will fail with
7256
+ through ` fs .open ()` , ` fs .writeFile ()` , or ` fsPromises .open ()` ) will fail with
7257
7257
` EPERM ` . Existing hidden files can be opened for writing with the ` ' r+' ` flag.
7258
7258
7259
7259
A call to ` fs .ftruncate ()` or ` filehandle .truncate ()` can be used to reset
0 commit comments