@@ -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
@@ -688,7 +688,7 @@ added: v10.0.0
688
688
changes:
689
689
- version: v15.14.0
690
690
pr-url: https://github.com/nodejs/node/pull/37490
691
- description: The ` data` argument supports ` AsyncIterable` , ` Iterable` and ` Stream` .
691
+ description: The ` data` argument supports ` AsyncIterable` , ` Iterable` , and ` Stream` .
692
692
- version: v14.0.0
693
693
pr-url: https://github.com/nodejs/node/pull/31030
694
694
description: The ` data` parameter won't coerce unsupported input to
@@ -702,7 +702,7 @@ changes:
702
702
* Returns: {Promise}
703
703
704
704
Asynchronously writes data to a file, replacing the file if it already exists.
705
- ` data` can be a string, a buffer, an {AsyncIterable} or {Iterable} object.
705
+ ` data` can be a string, a buffer, an {AsyncIterable}, or an {Iterable} object.
706
706
The promise is resolved with no arguments upon success.
707
707
708
708
If ` options` is a string, then it specifies the ` encoding` .
@@ -1466,7 +1466,7 @@ The `atime` and `mtime` arguments follow these rules:
1466
1466
1467
1467
* Values can be either numbers representing Unix epoch time, `Date`s, or a
1468
1468
numeric string like `'123456789.0'`.
1469
- * If the value can not be converted to a number, or is `NaN`, `Infinity` or
1469
+ * If the value can not be converted to a number, or is `NaN`, `Infinity`, or
1470
1470
`-Infinity`, an `Error` will be thrown.
1471
1471
1472
1472
### `fsPromises.watch(filename[, options])`
@@ -1526,7 +1526,7 @@ added: v10.0.0
1526
1526
changes:
1527
1527
- version: v15.14.0
1528
1528
pr-url: https://github.com/nodejs/node/pull/37490
1529
- description: The `data` argument supports `AsyncIterable`, `Iterable` and `Stream`.
1529
+ description: The `data` argument supports `AsyncIterable`, `Iterable`, and `Stream`.
1530
1530
- version:
1531
1531
- v15.2.0
1532
1532
- v14.17.0
@@ -1549,7 +1549,7 @@ changes:
1549
1549
* Returns: {Promise} Fulfills with `undefined` upon success.
1550
1550
1551
1551
Asynchronously writes data to a file, replacing the file if it already exists.
1552
- `data` can be a string, a buffer, an {AsyncIterable} or {Iterable} object.
1552
+ `data` can be a string, a buffer, an {AsyncIterable}, or an {Iterable} object.
1553
1553
1554
1554
The `encoding` option is ignored if `data` is a buffer.
1555
1555
@@ -1669,7 +1669,7 @@ access(file, constants.R_OK | constants.W_OK, (err) => {
1669
1669
```
1670
1670
1671
1671
Do not use `fs.access()` to check for the accessibility of a file before calling
1672
- `fs.open()`, `fs.readFile()` or `fs.writeFile()`. Doing
1672
+ `fs.open()`, `fs.readFile()`, or `fs.writeFile()`. Doing
1673
1673
so introduces a race condition, since other processes may change the file's
1674
1674
state between the two calls. Instead, user code should open/read/write the
1675
1675
file directly and handle the error raised if the file is not accessible.
@@ -1946,17 +1946,17 @@ specifies the permissions for others.
1946
1946
1947
1947
For example, the octal value `0o765` means:
1948
1948
1949
- * The owner may read, write and execute the file.
1949
+ * The owner may read, write, and execute the file.
1950
1950
* The group may read and write the file.
1951
1951
* Others may read and execute the file.
1952
1952
1953
1953
When using raw numbers where file modes are expected, any value larger than
1954
1954
`0o777` may result in platform-specific behaviors that are not supported to work
1955
- consistently. Therefore constants like `S_ISVTX`, `S_ISGID` or `S_ISUID` are not
1956
- exposed in `fs.constants`.
1955
+ consistently. Therefore constants like `S_ISVTX`, `S_ISGID`, or `S_ISUID` are
1956
+ not exposed in `fs.constants`.
1957
1957
1958
1958
Caveats: on Windows only the write permission can be changed, and the
1959
- distinction among the permissions of group, owner or others is not
1959
+ distinction among the permissions of group, owner, or others is not
1960
1960
implemented.
1961
1961
1962
1962
### `fs.chown(path, uid, gid, callback)`
@@ -2305,7 +2305,7 @@ By default, the stream will emit a `'close'` event after it has been
2305
2305
destroyed. Set the `emitClose` option to `false` to change this behavior.
2306
2306
2307
2307
By providing the `fs` option it is possible to override the corresponding `fs`
2308
- implementations for `open`, `write`, `writev` and `close`. Overriding `write()`
2308
+ implementations for `open`, `write`, `writev`, and `close`. Overriding `write()`
2309
2309
without `writev()` can reduce performance as some optimizations (`_writev()`)
2310
2310
will be disabled. When providing the `fs` option, overrides for at least one of
2311
2311
`write` and `writev` are required. If no `fd` option is supplied, an override
@@ -2355,7 +2355,7 @@ has only one boolean parameter. This is one reason `fs.access()` is recommended
2355
2355
instead of `fs.exists()`.
2356
2356
2357
2357
Using `fs.exists()` to check for the existence of a file before calling
2358
- `fs.open()`, `fs.readFile()` or `fs.writeFile()` is not recommended. Doing
2358
+ `fs.open()`, `fs.readFile()`, or `fs.writeFile()` is not recommended. Doing
2359
2359
so introduces a race condition, since other processes may change the file's
2360
2360
state between the two calls. Instead, user code should open/read/write the
2361
2361
file directly and handle the error raised if the file does not exist.
@@ -2670,7 +2670,7 @@ changes:
2670
2670
it will emit a deprecation warning with id DEP0013.
2671
2671
- version: v4.1.0
2672
2672
pr-url: https://github.com/nodejs/node/pull/2387
2673
- description: Numeric strings, `NaN` and `Infinity` are now allowed
2673
+ description: Numeric strings, `NaN`, and `Infinity` are now allowed
2674
2674
time specifiers.
2675
2675
-->
2676
2676
@@ -3114,7 +3114,7 @@ changes:
3114
3114
- v12.17.0
3115
3115
pr-url: https://github.com/nodejs/node/pull/31402
3116
3116
description: Options object can be passed in
3117
- to make Buffer , offset, length and position optional.
3117
+ to make buffer , offset, length, and position optional.
3118
3118
-->
3119
3119
3120
3120
* ` fd` {integer}
@@ -3441,7 +3441,7 @@ changes:
3441
3441
* ` err` {Error }
3442
3442
* ` resolvedPath` {string| Buffer}
3443
3443
3444
- Asynchronously computes the canonical pathname by resolving ` .` , ` ..` and
3444
+ Asynchronously computes the canonical pathname by resolving ` .` , ` ..` , and
3445
3445
symbolic links.
3446
3446
3447
3447
A canonical pathname is not necessarily unique . Hard links and bind mounts can
@@ -3680,7 +3680,7 @@ Asynchronous stat(2). The callback gets two arguments `(err, stats)` where
3680
3680
In case of an error, the ` err.code` will be one of [Common System Errors][].
3681
3681
3682
3682
Using ` fs.stat()` to check for the existence of a file before calling
3683
- ` fs.open()` , ` fs.readFile()` or ` fs.writeFile()` is not recommended.
3683
+ ` fs.open()` , ` fs.readFile()` , or ` fs.writeFile()` is not recommended.
3684
3684
Instead, user code should open/ read/ write the file directly and handle the
3685
3685
error raised if the file is not available.
3686
3686
@@ -3944,7 +3944,7 @@ changes:
3944
3944
it will emit a deprecation warning with id DEP0013 .
3945
3945
- version: v4.1 .0
3946
3946
pr- url: https: // github.com/nodejs/node/pull/2387
3947
- description: Numeric strings, ` NaN` and ` Infinity` are now allowed
3947
+ description: Numeric strings, ` NaN` , and ` Infinity` are now allowed
3948
3948
time specifiers.
3949
3949
-->
3950
3950
@@ -3960,7 +3960,7 @@ The `atime` and `mtime` arguments follow these rules:
3960
3960
3961
3961
* Values can be either numbers representing Unix epoch time in seconds,
3962
3962
` Date` s, or a numeric string like ` '123456789.0'` .
3963
- * If the value can not be converted to a number, or is ` NaN` , ` Infinity` or
3963
+ * If the value can not be converted to a number, or is ` NaN` , ` Infinity` , or
3964
3964
` -Infinity` , an ` Error` will be thrown.
3965
3965
3966
3966
### ` fs.watch(filename[, options][, listener])`
@@ -4835,7 +4835,7 @@ added: v0.4.2
4835
4835
changes:
4836
4836
- version: v4.1.0
4837
4837
pr-url: https://github.com/nodejs/node/pull/2387
4838
- description: Numeric strings, ` NaN ` and ` Infinity ` are now allowed
4838
+ description: Numeric strings, ` NaN ` , and ` Infinity ` are now allowed
4839
4839
time specifiers.
4840
4840
-->
4841
4841
@@ -5195,7 +5195,7 @@ changes:
5195
5195
- v12.17.0
5196
5196
pr-url: https://github.com/nodejs/node/pull/32460
5197
5197
description: Options object can be passed in
5198
- to make offset, length and position optional.
5198
+ to make offset, length, and position optional.
5199
5199
-->
5200
5200
5201
5201
* ` fd` {integer}
@@ -5498,7 +5498,7 @@ changes:
5498
5498
protocol.
5499
5499
- version: v4.1.0
5500
5500
pr-url: https://github.com/nodejs/node/pull/2387
5501
- description: Numeric strings, ` NaN ` and ` Infinity ` are now allowed
5501
+ description: Numeric strings, ` NaN ` , and ` Infinity ` are now allowed
5502
5502
time specifiers.
5503
5503
-->
5504
5504
@@ -6119,7 +6119,7 @@ changes:
6119
6119
6120
6120
A {fs.Stats} object provides information about a file.
6121
6121
6122
- Objects returned from [` fs .stat ()` ][], [` fs .lstat ()` ][] and [` fs .fstat ()` ][] and
6122
+ Objects returned from [` fs .stat ()` ][], [` fs .lstat ()` ][], [` fs .fstat ()` ][], and
6123
6123
their synchronous counterparts are of this type.
6124
6124
If ` bigint` in the ` options` passed to those methods is true, the numeric values
6125
6125
will be ` bigint` instead of ` number` , and the object will contain additional
@@ -6766,7 +6766,7 @@ The following constants are meant for use with `fs.open()`.
6766
6766
</table>
6767
6767
6768
6768
On Windows, only ` O_APPEND ` , ` O_CREAT ` , ` O_EXCL ` , ` O_RDONLY ` , ` O_RDWR ` ,
6769
- ` O_TRUNC ` , ` O_WRONLY ` and ` UV_FS_O_FILEMAP ` are available.
6769
+ ` O_TRUNC ` , ` O_WRONLY ` , and ` UV_FS_O_FILEMAP ` are available.
6770
6770
6771
6771
##### File type constants
6772
6772
@@ -7277,7 +7277,7 @@ fs.open('<directory>', 'a+', (err, fd) => {
7277
7277
` ` `
7278
7278
7279
7279
On Windows, opening an existing hidden file using the ` ' w' ` flag (either
7280
- through ` fs .open ()` or ` fs .writeFile ()` or ` fsPromises .open ()` ) will fail with
7280
+ through ` fs .open ()` , ` fs .writeFile ()` , or ` fsPromises .open ()` ) will fail with
7281
7281
` EPERM ` . Existing hidden files can be opened for writing with the ` ' r+' ` flag.
7282
7282
7283
7283
A call to ` fs .ftruncate ()` or ` filehandle .truncate ()` can be used to reset
0 commit comments