lukechilds
/
node
mirror of https://github.com/lukechilds/node.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
Browse Source

doc/tools: fix more type inconsistencies 

- fix a number of uppercase types
- lowercase 'integer'
- consistent formatting in crypto

PR-URL: https://github.com/nodejs/node/pull/11697
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
Reviewed-By: Timothy Gu <timothygu99@gmail.com>
v7.x
Roman Reiss 8 years ago
committed by Italo A. Casas
parent
5a9e30f1e9
commit
757bf484ff
No known key found for this signature in database GPG Key ID: 23EFEFE93C4CFFFE
19 changed files with 408 additions and 407 deletions
Whitespace
Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL
Split View
Diff Options
Show Stats Download Patch File Download Diff File
  1. 2
      doc/api/assert.md
  2. 204
      doc/api/buffer.md
  3. 32
      doc/api/child_process.md
  4. 8
      doc/api/cluster.md
  5. 10
      doc/api/console.md
  6. 20
      doc/api/crypto.md
  7. 4
      doc/api/dns.md
  8. 18
      doc/api/errors.md
  9. 354
      doc/api/fs.md
  10. 4
      doc/api/globals.md
  11. 8
      doc/api/http.md
  12. 6
      doc/api/modules.md
  13. 24
      doc/api/os.md
  14. 22
      doc/api/path.md
  15. 42
      doc/api/process.md
  16. 2
      doc/api/repl.md
  17. 8
      doc/api/stream.md
  18. 38
      doc/api/url.md
  19. 9
      tools/doc/type-parser.js

2
doc/api/assert.md
View File

@ -241,7 +241,7 @@ added: v0.1.21
* `actual` {any}
* `expected` {any}
* `message` {any}
* `operator` {String}
* `operator` {string}
Throws an `AssertionError`. If `message` is falsy, the error message is set as
the values of `actual` and `expected` separated by the provided `operator`.

204
doc/api/buffer.md
View File

@ -357,8 +357,8 @@ changes:
* `arrayBuffer` {ArrayBuffer} An [`ArrayBuffer`] or the `.buffer` property of a
[`TypedArray`].
* `byteOffset` {Integer} Index of first byte to expose. **Default:** `0`
* `length` {Integer} Number of bytes to expose.
* `byteOffset` {integer} Index of first byte to expose. **Default:** `0`
* `length` {integer} Number of bytes to expose.
**Default:** `arrayBuffer.length - byteOffset`
This creates a view of the [`ArrayBuffer`] without copying the underlying
@ -438,7 +438,7 @@ changes:
> Stability: 0 - Deprecated: Use [`Buffer.alloc()`] instead (also see
> [`Buffer.allocUnsafe()`]).
* `size` {Integer} The desired length of the new `Buffer`
* `size` {integer} The desired length of the new `Buffer`
Allocates a new `Buffer` of `size` bytes. If the `size` is larger than
[`buffer.kMaxLength`] or smaller than 0, a [`RangeError`] will be thrown.
@ -507,8 +507,8 @@ console.log(buf2.toString());
added: v5.10.0
-->
* `size` {Integer} The desired length of the new `Buffer`
* `fill` {string | Buffer | Integer} A value to pre-fill the new `Buffer` with.
* `size` {integer} The desired length of the new `Buffer`
* `fill` {string|Buffer|integer} A value to pre-fill the new `Buffer` with.
**Default:** `0`
* `encoding` {string} If `fill` is a string, this is its encoding.
**Default:** `'utf8'`
@ -568,7 +568,7 @@ changes:
description: Passing a negative `size` will now throw an error.
-->
* `size` {Integer} The desired length of the new `Buffer`
* `size` {integer} The desired length of the new `Buffer`
Allocates a new `Buffer` of `size` bytes. If the `size` is larger than
[`buffer.kMaxLength`] or smaller than 0, a [`RangeError`] will be thrown.
@ -614,7 +614,7 @@ additional performance that [`Buffer.allocUnsafe()`] provides.
added: v5.10.0
-->
* `size` {Integer} The desired length of the new `Buffer`
* `size` {integer} The desired length of the new `Buffer`
Allocates a new `Buffer` of `size` bytes. If the `size` is larger than
[`buffer.kMaxLength`] or smaller than 0, a [`RangeError`] will be thrown.
@ -674,11 +674,11 @@ changes:
or `ArrayBuffer`.
-->
* `string` {string | Buffer | TypedArray | DataView | ArrayBuffer} A value to
* `string` {string|Buffer|TypedArray|DataView|ArrayBuffer} A value to
calculate the length of
* `encoding` {string} If `string` is a string, this is its encoding.
**Default:** `'utf8'`
* Returns: {Integer} The number of bytes contained within `string`
* Returns: {integer} The number of bytes contained within `string`
Returns the actual byte length of a string. This is not the same as
[`String.prototype.length`] since that returns the number of *characters* in
@ -708,7 +708,7 @@ added: v0.11.13
* `buf1` {Buffer}
* `buf2` {Buffer}
* Returns: {Integer}
* Returns: {integer}
Compares `buf1` to `buf2` typically for the purpose of sorting arrays of
`Buffer` instances. This is equivalent to calling
@ -732,7 +732,7 @@ added: v0.7.11
-->
* `list` {Array} List of `Buffer` instances to concat
* `totalLength` {Integer} Total length of the `Buffer` instances in `list`
* `totalLength` {integer} Total length of the `Buffer` instances in `list`
when concatenated
* Returns: {Buffer}
@ -792,8 +792,8 @@ added: v5.10.0
* `arrayBuffer` {ArrayBuffer} An [`ArrayBuffer`] or the `.buffer` property of a
[`TypedArray`].
* `byteOffset` {Integer} Index of first byte to expose. **Default:** `0`
* `length` {Integer} Number of bytes to expose.
* `byteOffset` {integer} Index of first byte to expose. **Default:** `0`
* `length` {integer} Number of bytes to expose.
**Default:** `arrayBuffer.length - byteOffset`
This creates a view of the [`ArrayBuffer`] without copying the underlying
@ -900,7 +900,7 @@ added: v0.1.101
-->
* `obj` {Object}
* Returns: {Boolean}
* Returns: {boolean}
Returns `true` if `obj` is a `Buffer`, `false` otherwise.
@ -910,7 +910,7 @@ added: v0.9.1
-->
* `encoding` {string} A character encoding name to check
* Returns: {Boolean}
* Returns: {boolean}
Returns `true` if `encoding` contains a supported character encoding, or `false`
otherwise.
@ -920,7 +920,7 @@ otherwise.
added: v0.11.3
-->
* {Integer} **Default:** `8192`
* {integer} **Default:** `8192`
This is the number of bytes used to determine the size of pre-allocated, internal
`Buffer` instances used for pooling. This value may be modified.
@ -959,17 +959,17 @@ changes:
-->
* `target` {Buffer} A `Buffer` to compare to
* `targetStart` {Integer} The offset within `target` at which to begin
* `targetStart` {integer} The offset within `target` at which to begin
comparison. **Default:** `0`
* `targetEnd` {Integer} The offset with `target` at which to end comparison
* `targetEnd` {integer} The offset with `target` at which to end comparison
(not inclusive). Ignored when `targetStart` is `undefined`.
**Default:** `target.length`
* `sourceStart` {Integer} The offset within `buf` at which to begin comparison.
* `sourceStart` {integer} The offset within `buf` at which to begin comparison.
Ignored when `targetStart` is `undefined`. **Default:** `0`
* `sourceEnd` {Integer} The offset within `buf` at which to end comparison
* `sourceEnd` {integer} The offset within `buf` at which to end comparison
(not inclusive). Ignored when `targetStart` is `undefined`.
**Default:** [`buf.length`]
* Returns: {Integer}
* Returns: {integer}
Compares `buf` with `target` and returns a number indicating whether `buf`
comes before, after, or is the same as `target` in sort order.
@ -1035,13 +1035,13 @@ added: v0.1.90
-->
* `target` {Buffer|Uint8Array} A `Buffer` or [`Uint8Array`] to copy into.
* `targetStart` {Integer} The offset within `target` at which to begin
* `targetStart` {integer} The offset within `target` at which to begin
copying to. **Default:** `0`
* `sourceStart` {Integer} The offset within `buf` at which to begin copying from.
* `sourceStart` {integer} The offset within `buf` at which to begin copying from.
Ignored when `targetStart` is `undefined`. **Default:** `0`
* `sourceEnd` {Integer} The offset within `buf` at which to stop copying (not
* `sourceEnd` {integer} The offset within `buf` at which to stop copying (not
inclusive). Ignored when `sourceStart` is `undefined`. **Default:** [`buf.length`]
* Returns: {Integer} The number of bytes copied.
* Returns: {integer} The number of bytes copied.
Copies data from a region of `buf` to a region in `target` even if the `target`
memory region overlaps with `buf`.
@ -1114,7 +1114,7 @@ added: v0.11.13
-->
* `otherBuffer` {Buffer} A `Buffer` to compare to
* Returns: {Boolean}
* Returns: {boolean}
Returns `true` if both `buf` and `otherBuffer` have exactly the same bytes,
`false` otherwise.
@ -1142,9 +1142,9 @@ changes:
description: The `encoding` parameter is supported now.
-->
* `value` {string | Buffer | Integer} The value to fill `buf` with
* `offset` {Integer} Where to start filling `buf`. **Default:** `0`
* `end` {Integer} Where to stop filling `buf` (not inclusive). **Default:** [`buf.length`]
* `value` {string|Buffer|integer} The value to fill `buf` with
* `offset` {integer} Where to start filling `buf`. **Default:** `0`
* `end` {integer} Where to stop filling `buf` (not inclusive). **Default:** [`buf.length`]
* `encoding` {string} If `value` is a string, this is its encoding.
**Default:** `'utf8'`
* Returns: {Buffer} A reference to `buf`
@ -1179,11 +1179,11 @@ console.log(Buffer.allocUnsafe(3).fill('\u0222'));
added: v5.3.0
-->
* `value` {string | Buffer | Integer} What to search for
* `byteOffset` {Integer} Where to begin searching in `buf`. **Default:** `0`
* `value` {string|Buffer|integer} What to search for
* `byteOffset` {integer} Where to begin searching in `buf`. **Default:** `0`
* `encoding` {string} If `value` is a string, this is its encoding.
**Default:** `'utf8'`
* Returns: {Boolean} `true` if `value` was found in `buf`, `false` otherwise
* Returns: {boolean} `true` if `value` was found in `buf`, `false` otherwise
Equivalent to [`buf.indexOf() !== -1`][`buf.indexOf()`].
@ -1225,11 +1225,11 @@ changes:
is no longer required.
-->
* `value` {string | Buffer | Integer} What to search for
* `byteOffset` {Integer} Where to begin searching in `buf`. **Default:** `0`
* `value` {string|Buffer|integer} What to search for
* `byteOffset` {integer} Where to begin searching in `buf`. **Default:** `0`
* `encoding` {string} If `value` is a string, this is its encoding.
**Default:** `'utf8'`
* Returns: {Integer} The index of the first occurrence of `value` in `buf` or `-1`
* Returns: {integer} The index of the first occurrence of `value` in `buf` or `-1`
if `buf` does not contain `value`
If `value` is:
@ -1330,12 +1330,12 @@ for (const key of buf.keys()) {
added: v6.0.0
-->
* `value` {string | Buffer | Integer} What to search for
* `byteOffset` {Integer} Where to begin searching in `buf`.
* `value` {string|Buffer|integer} What to search for
* `byteOffset` {integer} Where to begin searching in `buf`.
**Default:** [`buf.length`]` - 1`
* `encoding` {string} If `value` is a string, this is its encoding.
**Default:** `'utf8'`
* Returns: {Integer} The index of the last occurrence of `value` in `buf` or `-1`
* Returns: {integer} The index of the last occurrence of `value` in `buf` or `-1`
if `buf` does not contain `value`
Identical to [`buf.indexOf()`], except `buf` is searched from back to front
@ -1410,7 +1410,7 @@ console.log(b.lastIndexOf('b', []));
added: v0.1.90
-->
* {Integer}
* {integer}
Returns the amount of memory allocated for `buf` in bytes. Note that this
does not necessarily reflect the amount of "usable" data within `buf`.
@ -1456,9 +1456,9 @@ console.log(buf.length);
added: v0.11.15
-->
* `offset` {Integer} Where to start reading. Must satisfy: `0 <= offset <= buf.length - 8`
* `offset` {integer} Where to start reading. Must satisfy: `0 <= offset <= buf.length - 8`
* `noAssert` {boolean} Skip `offset` validation? **Default:** `false`
* Returns: {Number}
* Returns: {number}
Reads a 64-bit double from `buf` at the specified `offset` with specified
endian format (`readDoubleBE()` returns big endian, `readDoubleLE()` returns
@ -1492,9 +1492,9 @@ console.log(buf.readDoubleLE(1, true));
added: v0.11.15
-->
* `offset` {Integer} Where to start reading. Must satisfy: `0 <= offset <= buf.length - 4`
* `offset` {integer} Where to start reading. Must satisfy: `0 <= offset <= buf.length - 4`
* `noAssert` {boolean} Skip `offset` validation? **Default:** `false`
* Returns: {Number}
* Returns: {number}
Reads a 32-bit float from `buf` at the specified `offset` with specified
endian format (`readFloatBE()` returns big endian, `readFloatLE()` returns
@ -1527,9 +1527,9 @@ console.log(buf.readFloatLE(1, true));
added: v0.5.0
-->
* `offset` {Integer} Where to start reading. Must satisfy: `0 <= offset <= buf.length - 1`
* `offset` {integer} Where to start reading. Must satisfy: `0 <= offset <= buf.length - 1`
* `noAssert` {boolean} Skip `offset` validation? **Default:** `false`
* Returns: {Integer}
* Returns: {integer}
Reads a signed 8-bit integer from `buf` at the specified `offset`.
@ -1559,9 +1559,9 @@ console.log(buf.readInt8(2));
added: v0.5.5
-->
* `offset` {Integer} Where to start reading. Must satisfy: `0 <= offset <= buf.length - 2`
* `offset` {integer} Where to start reading. Must satisfy: `0 <= offset <= buf.length - 2`
* `noAssert` {boolean} Skip `offset` validation? **Default:** `false`
* Returns: {Integer}
* Returns: {integer}
Reads a signed 16-bit integer from `buf` at the specified `offset` with
the specified endian format (`readInt16BE()` returns big endian,
@ -1593,9 +1593,9 @@ console.log(buf.readInt16LE(1));
added: v0.5.5
-->
* `offset` {Integer} Where to start reading. Must satisfy: `0 <= offset <= buf.length - 4`
* `offset` {integer} Where to start reading. Must satisfy: `0 <= offset <= buf.length - 4`
* `noAssert` {boolean} Skip `offset` validation? **Default:** `false`
* Returns: {Integer}
* Returns: {integer}
Reads a signed 32-bit integer from `buf` at the specified `offset` with
the specified endian format (`readInt32BE()` returns big endian,
@ -1627,10 +1627,10 @@ console.log(buf.readInt32LE(1));
added: v0.11.15
-->
* `offset` {Integer} Where to start reading. Must satisfy: `0 <= offset <= buf.length - byteLength`
* `byteLength` {Integer} How many bytes to read. Must satisfy: `0 < byteLength <= 6`
* `offset` {integer} Where to start reading. Must satisfy: `0 <= offset <= buf.length - byteLength`
* `byteLength` {integer} How many bytes to read. Must satisfy: `0 < byteLength <= 6`
* `noAssert` {boolean} Skip `offset` and `byteLength` validation? **Default:** `false`
* Returns: {Integer}
* Returns: {integer}
Reads `byteLength` number of bytes from `buf` at the specified `offset`
and interprets the result as a two's complement signed value. Supports up to 48
@ -1659,9 +1659,9 @@ console.log(buf.readIntBE(1, 6).toString(16));
added: v0.5.0
-->
* `offset` {Integer} Where to start reading. Must satisfy: `0 <= offset <= buf.length - 1`
* `offset` {integer} Where to start reading. Must satisfy: `0 <= offset <= buf.length - 1`
* `noAssert` {boolean} Skip `offset` validation? **Default:** `false`
* Returns: {Integer}
* Returns: {integer}
Reads an unsigned 8-bit integer from `buf` at the specified `offset`.
@ -1689,9 +1689,9 @@ console.log(buf.readUInt8(2));
added: v0.5.5
-->
* `offset` {Integer} Where to start reading. Must satisfy: `0 <= offset <= buf.length - 2`
* `offset` {integer} Where to start reading. Must satisfy: `0 <= offset <= buf.length - 2`
* `noAssert` {boolean} Skip `offset` validation? **Default:** `false`
* Returns: {Integer}
* Returns: {integer}
Reads an unsigned 16-bit integer from `buf` at the specified `offset` with
specified endian format (`readUInt16BE()` returns big endian, `readUInt16LE()`
@ -1727,9 +1727,9 @@ console.log(buf.readUInt16LE(2).toString(16));
added: v0.5.5
-->
* `offset` {Integer} Where to start reading. Must satisfy: `0 <= offset <= buf.length - 4`
* `offset` {integer} Where to start reading. Must satisfy: `0 <= offset <= buf.length - 4`
* `noAssert` {boolean} Skip `offset` validation? **Default:** `false`
* Returns: {Integer}
* Returns: {integer}
Reads an unsigned 32-bit integer from `buf` at the specified `offset` with
specified endian format (`readUInt32BE()` returns big endian,
@ -1759,10 +1759,10 @@ console.log(buf.readUInt32LE(1).toString(16));
added: v0.11.15
-->
* `offset` {Integer} Where to start reading. Must satisfy: `0 <= offset <= buf.length - byteLength`
* `byteLength` {Integer} How many bytes to read. Must satisfy: `0 < byteLength <= 6`
* `offset` {integer} Where to start reading. Must satisfy: `0 <= offset <= buf.length - byteLength`
* `byteLength` {integer} How many bytes to read. Must satisfy: `0 < byteLength <= 6`
* `noAssert` {boolean} Skip `offset` and `byteLength` validation? **Default:** `false`
* Returns: {Integer}
* Returns: {integer}
Reads `byteLength` number of bytes from `buf` at the specified `offset`
and interprets the result as an unsigned integer. Supports up to 48
@ -1800,8 +1800,8 @@ changes:
calculations with them.
-->
* `start` {Integer} Where the new `Buffer` will start. **Default:** `0`
* `end` {Integer} Where the new `Buffer` will end (not inclusive).
* `start` {integer} Where the new `Buffer` will start. **Default:** `0`
* `end` {integer} Where the new `Buffer` will end (not inclusive).
**Default:** [`buf.length`]
* Returns: {Buffer}
@ -1982,10 +1982,10 @@ added: v0.1.90
-->
* `encoding` {string} The character encoding to decode to. **Default:** `'utf8'`
* `start` {Integer} The byte offset to start decoding at. **Default:** `0`
* `end` {Integer} The byte offset to stop decoding at (not inclusive).
* `start` {integer} The byte offset to start decoding at. **Default:** `0`
* `end` {integer} The byte offset to stop decoding at (not inclusive).
**Default:** [`buf.length`]
* Returns: {String}
* Returns: {string}
Decodes `buf` to a string according to the specified character encoding in
`encoding`. `start` and `end` may be passed to decode only a subset of `buf`.
@ -2063,10 +2063,10 @@ added: v0.1.90
-->
* `string` {string} String to be written to `buf`
* `offset` {Integer} Where to start writing `string`. **Default:** `0`
* `length` {Integer} How many bytes to write. **Default:** `buf.length - offset`
* `offset` {integer} Where to start writing `string`. **Default:** `0`
* `length` {integer} How many bytes to write. **Default:** `buf.length - offset`
* `encoding` {string} The character encoding of `string`. **Default:** `'utf8'`
* Returns: {Integer} Number of bytes written
* Returns: {integer} Number of bytes written
Writes `string` to `buf` at `offset` according to the character encoding in `encoding`.
The `length` parameter is the number of bytes to write. If `buf` did not contain
@ -2091,9 +2091,9 @@ added: v0.11.15
-->
* `value` {number} Number to be written to `buf`
* `offset` {Integer} Where to start writing. Must satisfy: `0 <= offset <= buf.length - 8`
* `offset` {integer} Where to start writing. Must satisfy: `0 <= offset <= buf.length - 8`
* `noAssert` {boolean} Skip `value` and `offset` validation? **Default:** `false`
* Returns: {Integer} `offset` plus the number of bytes written
* Returns: {integer} `offset` plus the number of bytes written
Writes `value` to `buf` at the specified `offset` with specified endian
format (`writeDoubleBE()` writes big endian, `writeDoubleLE()` writes little
@ -2126,9 +2126,9 @@ added: v0.11.15
-->
* `value` {number} Number to be written to `buf`
* `offset` {Integer} Where to start writing. Must satisfy: `0 <= offset <= buf.length - 4`
* `offset` {integer} Where to start writing. Must satisfy: `0 <= offset <= buf.length - 4`
* `noAssert` {boolean} Skip `value` and `offset` validation? **Default:** `false`
* Returns: {Integer} `offset` plus the number of bytes written
* Returns: {integer} `offset` plus the number of bytes written
Writes `value` to `buf` at the specified `offset` with specified endian
format (`writeFloatBE()` writes big endian, `writeFloatLE()` writes little
@ -2159,10 +2159,10 @@ console.log(buf);
added: v0.5.0
-->
* `value` {Integer} Number to be written to `buf`
* `offset` {Integer} Where to start writing. Must satisfy: `0 <= offset <= buf.length - 1`
* `value` {integer} Number to be written to `buf`
* `offset` {integer} Where to start writing. Must satisfy: `0 <= offset <= buf.length - 1`
* `noAssert` {boolean} Skip `value` and `offset` validation? **Default:** `false`
* Returns: {Integer} `offset` plus the number of bytes written
* Returns: {integer} `offset` plus the number of bytes written
Writes `value` to `buf` at the specified `offset`. `value` *should* be a valid
signed 8-bit integer. Behavior is undefined when `value` is anything other than
@ -2191,10 +2191,10 @@ console.log(buf);
added: v0.5.5
-->
* `value` {Integer} Number to be written to `buf`
* `offset` {Integer} Where to start writing. Must satisfy: `0 <= offset <= buf.length - 2`
* `value` {integer} Number to be written to `buf`
* `offset` {integer} Where to start writing. Must satisfy: `0 <= offset <= buf.length - 2`
* `noAssert` {boolean} Skip `value` and `offset` validation? **Default:** `false`
* Returns: {Integer} `offset` plus the number of bytes written
* Returns: {integer} `offset` plus the number of bytes written
Writes `value` to `buf` at the specified `offset` with specified endian
format (`writeInt16BE()` writes big endian, `writeInt16LE()` writes little
@ -2224,10 +2224,10 @@ console.log(buf);
added: v0.5.5
-->
* `value` {Integer} Number to be written to `buf`
* `offset` {Integer} Where to start writing. Must satisfy: `0 <= offset <= buf.length - 4`
* `value` {integer} Number to be written to `buf`
* `offset` {integer} Where to start writing. Must satisfy: `0 <= offset <= buf.length - 4`
* `noAssert` {boolean} Skip `value` and `offset` validation? **Default:** `false`
* Returns: {Integer} `offset` plus the number of bytes written
* Returns: {integer} `offset` plus the number of bytes written
Writes `value` to `buf` at the specified `offset` with specified endian
format (`writeInt32BE()` writes big endian, `writeInt32LE()` writes little
@ -2257,12 +2257,12 @@ console.log(buf);
added: v0.11.15
-->
* `value` {Integer} Number to be written to `buf`
* `offset` {Integer} Where to start writing. Must satisfy: `0 <= offset <= buf.length - byteLength`
* `byteLength` {Integer} How many bytes to write. Must satisfy: `0 < byteLength <= 6`
* `value` {integer} Number to be written to `buf`
* `offset` {integer} Where to start writing. Must satisfy: `0 <= offset <= buf.length - byteLength`
* `byteLength` {integer} How many bytes to write. Must satisfy: `0 < byteLength <= 6`
* `noAssert` {boolean} Skip `value`, `offset`, and `byteLength` validation?
**Default:** `false`
* Returns: {Integer} `offset` plus the number of bytes written
* Returns: {integer} `offset` plus the number of bytes written
Writes `byteLength` bytes of `value` to `buf` at the specified `offset`.
Supports up to 48 bits of accuracy. Behavior is undefined when `value` is
@ -2292,10 +2292,10 @@ console.log(buf);
added: v0.5.0
-->
* `value` {Integer} Number to be written to `buf`
* `offset` {Integer} Where to start writing. Must satisfy: `0 <= offset <= buf.length - 1`
* `value` {integer} Number to be written to `buf`
* `offset` {integer} Where to start writing. Must satisfy: `0 <= offset <= buf.length - 1`
* `noAssert` {boolean} Skip `value` and `offset` validation? **Default:** `false`
* Returns: {Integer} `offset` plus the number of bytes written
* Returns: {integer} `offset` plus the number of bytes written
Writes `value` to `buf` at the specified `offset`. `value` *should* be a
valid unsigned 8-bit integer. Behavior is undefined when `value` is anything
@ -2324,10 +2324,10 @@ console.log(buf);
added: v0.5.5
-->
* `value` {Integer} Number to be written to `buf`
* `offset` {Integer} Where to start writing. Must satisfy: `0 <= offset <= buf.length - 2`
* `value` {integer} Number to be written to `buf`
* `offset` {integer} Where to start writing. Must satisfy: `0 <= offset <= buf.length - 2`
* `noAssert` {boolean} Skip `value` and `offset` validation? **Default:** `false`
* Returns: {Integer} `offset` plus the number of bytes written
* Returns: {integer} `offset` plus the number of bytes written
Writes `value` to `buf` at the specified `offset` with specified endian
format (`writeUInt16BE()` writes big endian, `writeUInt16LE()` writes little
@ -2361,10 +2361,10 @@ console.log(buf);
added: v0.5.5
-->
* `value` {Integer} Number to be written to `buf`
* `offset` {Integer} Where to start writing. Must satisfy: `0 <= offset <= buf.length - 4`
* `value` {integer} Number to be written to `buf`
* `offset` {integer} Where to start writing. Must satisfy: `0 <= offset <= buf.length - 4`
* `noAssert` {boolean} Skip `value` and `offset` validation? **Default:** `false`
* Returns: {Integer} `offset` plus the number of bytes written
* Returns: {integer} `offset` plus the number of bytes written
Writes `value` to `buf` at the specified `offset` with specified endian
format (`writeUInt32BE()` writes big endian, `writeUInt32LE()` writes little
@ -2396,12 +2396,12 @@ console.log(buf);
added: v0.5.5
-->
* `value` {Integer} Number to be written to `buf`
* `offset` {Integer} Where to start writing. Must satisfy: `0 <= offset <= buf.length - byteLength`
* `byteLength` {Integer} How many bytes to write. Must satisfy: `0 < byteLength <= 6`
* `value` {integer} Number to be written to `buf`
* `offset` {integer} Where to start writing. Must satisfy: `0 <= offset <= buf.length - byteLength`
* `byteLength` {integer} How many bytes to write. Must satisfy: `0 < byteLength <= 6`
* `noAssert` {boolean} Skip `value`, `offset`, and `byteLength` validation?
**Default:** `false`
* Returns: {Integer} `offset` plus the number of bytes written
* Returns: {integer} `offset` plus the number of bytes written
Writes `byteLength` bytes of `value` to `buf` at the specified `offset`.
Supports up to 48 bits of accuracy. Behavior is undefined when `value` is
@ -2431,7 +2431,7 @@ console.log(buf);
added: v0.5.4
-->
* {Integer} **Default:** `50`
* {integer} **Default:** `50`
Returns the maximum number of bytes that will be returned when
`buf.inspect()` is called. This can be overridden by user modules. See
@ -2445,7 +2445,7 @@ Note that this is a property on the `buffer` module returned by
added: v3.0.0
-->
* {Integer} The largest size allowed for a single `Buffer` instance
* {integer} The largest size allowed for a single `Buffer` instance
On 32-bit architectures, this value is `(2^30)-1` (~1GB).
On 64-bit architectures, this value is `(2^31)-1` (~2GB).
@ -2532,7 +2532,7 @@ deprecated: v6.0.0
> Stability: 0 - Deprecated: Use [`Buffer.allocUnsafeSlow()`] instead.
* `size` {Integer} The desired length of the new `SlowBuffer`
* `size` {integer} The desired length of the new `SlowBuffer`
Allocates a new `Buffer` of `size` bytes. If the `size` is larger than
[`buffer.kMaxLength`] or smaller than 0, a [`RangeError`] will be thrown.

32
doc/api/child_process.md
View File

@ -135,9 +135,9 @@ added: v0.1.90
understand the `-c` switch on UNIX or `/d /s /c` on Windows. On Windows,
command line parsing should be compatible with `cmd.exe`.)
* `timeout` {number} (Default: `0`)
* [`maxBuffer`][] {Number} largest amount of data (in bytes) allowed on
* [`maxBuffer`][] {number} largest amount of data (in bytes) allowed on
stdout or stderr - if exceeded child process is killed (Default: `200*1024`)
* `killSignal` {string|Integer} (Default: `'SIGTERM'`)
* `killSignal` {string|integer} (Default: `'SIGTERM'`)
* `uid` {number} Sets the user identity of the process. (See setuid(2).)
* `gid` {number} Sets the group identity of the process. (See setgid(2).)
* `callback` {Function} called with the output when process terminates
@ -212,9 +212,9 @@ added: v0.1.91
* `env` {Object} Environment key-value pairs
* `encoding` {string} (Default: `'utf8'`)
* `timeout` {number} (Default: `0`)
* [`maxBuffer`][] {Number} largest amount of data (in bytes) allowed on
* [`maxBuffer`][] {number} largest amount of data (in bytes) allowed on
stdout or stderr - if exceeded child process is killed (Default: `200*1024`)
* `killSignal` {string|Integer} (Default: `'SIGTERM'`)
* `killSignal` {string|integer} (Default: `'SIGTERM'`)
* `uid` {number} Sets the user identity of the process. (See setuid(2).)
* `gid` {number} Sets the group identity of the process. (See setgid(2).)
* `callback` {Function} called with the output when process terminates
@ -602,7 +602,7 @@ changes:
* `input` {string|Buffer} The value which will be passed as stdin to the
spawned process
- supplying this value will override `stdio[0]`
* `stdio` {string | Array} Child's stdio configuration. (Default: `'pipe'`)
* `stdio` {string|Array} Child's stdio configuration. (Default: `'pipe'`)
- `stderr` by default will be output to the parent process' stderr unless
`stdio` is specified
* `env` {Object} Environment key-value pairs
@ -610,9 +610,9 @@ changes:
* `gid` {number} Sets the group identity of the process. (See setgid(2).)
* `timeout` {number} In milliseconds the maximum amount of time the process
is allowed to run. (Default: `undefined`)
* `killSignal` {string|Integer} The signal value to be used when the spawned
* `killSignal` {string|integer} The signal value to be used when the spawned
process will be killed. (Default: `'SIGTERM'`)
* [`maxBuffer`][] {Number} largest amount of data (in bytes) allowed on
* [`maxBuffer`][] {number} largest amount of data (in bytes) allowed on
stdout or stderr - if exceeded child process is killed
* `encoding` {string} The encoding used for all stdio inputs and outputs. (Default: `'buffer'`)
* Returns: {Buffer|string} The stdout from the command
@ -640,7 +640,7 @@ added: v0.11.12
* `input` {string|Buffer} The value which will be passed as stdin to the
spawned process
- supplying this value will override `stdio[0]`
* `stdio` {string | Array} Child's stdio configuration. (Default: `'pipe'`)
* `stdio` {string|Array} Child's stdio configuration. (Default: `'pipe'`)
- `stderr` by default will be output to the parent process' stderr unless
`stdio` is specified
* `env` {Object} Environment key-value pairs
@ -652,9 +652,9 @@ added: v0.11.12
* `gid` {number} Sets the group identity of the process. (See setgid(2).)
* `timeout` {number} In milliseconds the maximum amount of time the process
is allowed to run. (Default: `undefined`)
* `killSignal` {string|Integer} The signal value to be used when the spawned
* `killSignal` {string|integer} The signal value to be used when the spawned
process will be killed. (Default: `'SIGTERM'`)
* [`maxBuffer`][] {Number} largest amount of data (in bytes) allowed on
* [`maxBuffer`][] {number} largest amount of data (in bytes) allowed on
stdout or stderr - if exceeded child process is killed
* `encoding` {string} The encoding used for all stdio inputs and outputs.
(Default: `'buffer'`)
@ -695,15 +695,15 @@ changes:
* `input` {string|Buffer} The value which will be passed as stdin to the
spawned process
- supplying this value will override `stdio[0]`
* `stdio` {string | Array} Child's stdio configuration.
* `stdio` {string|Array} Child's stdio configuration.
* `env` {Object} Environment key-value pairs
* `uid` {number} Sets the user identity of the process. (See setuid(2).)
* `gid` {number} Sets the group identity of the process. (See setgid(2).)
* `timeout` {number} In milliseconds the maximum amount of time the process
is allowed to run. (Default: `undefined`)
* `killSignal` {string|Integer} The signal value to be used when the spawned
* `killSignal` {string|integer} The signal value to be used when the spawned
process will be killed. (Default: `'SIGTERM'`)
* [`maxBuffer`][] {Number} largest amount of data (in bytes) allowed on
* [`maxBuffer`][] {number} largest amount of data (in bytes) allowed on
stdout or stderr - if exceeded child process is killed
* `encoding` {string} The encoding used for all stdio inputs and outputs.
(Default: `'buffer'`)
@ -833,7 +833,7 @@ IPC channel currently exists, this property is `undefined`.
added: v0.7.2
-->
* {Boolean} Set to `false` after `child.disconnect()` is called
* {boolean} Set to `false` after `child.disconnect()` is called
The `child.connected` property indicates whether it is still possible to send
and receive messages from a child process. When `child.connected` is `false`, it
@ -920,7 +920,7 @@ setTimeout(() => {
added: v0.1.90
-->
* {Number} Integer
* {number} Integer
Returns the process identifier (PID) of the child process.
@ -954,7 +954,7 @@ changes:
* `sendHandle` {Handle}
* `options` {Object}
* `callback` {Function}
* Returns: {Boolean}
* Returns: {boolean}
When an IPC channel has been established between the parent and child (
i.e. when using [`child_process.fork()`][]), the `child.send()` method can be

8
doc/api/cluster.md
View File

@ -332,7 +332,7 @@ if (cluster.isMaster) {
added: v6.0.0
-->
* {Boolean}
* {boolean}
Set by calling `.kill()` or `.disconnect()`. Until then, it is `undefined`.
@ -356,7 +356,7 @@ worker.kill();
added: v0.8.0
-->
* {Number}
* {number}
Each new worker is given its own unique id, this id is stored in the
`id`.
@ -691,7 +691,7 @@ This can only be called from the master process.
added: v0.8.1
-->
* {Boolean}
* {boolean}
True if the process is a master. This is determined
by the `process.env.NODE_UNIQUE_ID`. If `process.env.NODE_UNIQUE_ID` is
@ -702,7 +702,7 @@ undefined, then `isMaster` is `true`.
added: v0.6.0
-->
* {Boolean}
* {boolean}
True if the process is not a master (it is the negation of `cluster.isMaster`).

10
doc/api/console.md
View File

@ -162,9 +162,9 @@ added: v0.1.101
-->
* `obj` {any}
* `options` {Object}
* `showHidden` {Boolean}
* `depth` {Number}
* `colors` {Boolean}
* `showHidden` {boolean}
* `depth` {number}
* `colors` {boolean}
Uses [`util.inspect()`][] on `obj` and prints the resulting string to `stdout`.
This function bypasses any custom `inspect()` function defined on `obj`. An
@ -243,7 +243,7 @@ values are concatenated. See [`util.format()`][] for more information.
<!-- YAML
added: v0.1.104
-->
* `label` {String}
* `label` {string}
Starts a timer that can be used to compute the duration of an operation. Timers
are identified by a unique `label`. Use the same `label` when you call
@ -259,7 +259,7 @@ changes:
description: This method no longer supports multiple calls that don’t map
to individual `console.time()` calls; see below for details.
-->
* `label` {String}
* `label` {string}
Stops a timer that was previously started by calling [`console.time()`][] and
prints the result to `stdout`:

20
doc/api/crypto.md
View File

@ -929,8 +929,8 @@ The `private_key` argument can be an object or a string. If `private_key` is a
string, it is treated as a raw key with no passphrase. If `private_key` is an
object, it is interpreted as a hash containing two properties:
* `key` : {String} - PEM encoded private key
* `passphrase` : {String} - passphrase for the private key
* `key`: {string} - PEM encoded private key
* `passphrase`: {string} - passphrase for the private key
The `output_format` can specify one of `'latin1'`, `'hex'` or `'base64'`. If
`output_format` is provided a string is returned; otherwise a [`Buffer`][] is
@ -1469,8 +1469,8 @@ treated as the key with no passphrase and will use `RSA_PKCS1_OAEP_PADDING`.
If `private_key` is an object, it is interpreted as a hash object with the
keys:
* `key` : {String} - PEM encoded private key
* `passphrase` : {String} - Optional passphrase for the private key
* `key`: {string} - PEM encoded private key
* `passphrase`: {string} - Optional passphrase for the private key
* `padding` : An optional padding value, one of the following:
* `crypto.constants.RSA_NO_PADDING`
* `crypto.constants.RSA_PKCS1_PADDING`
@ -1490,8 +1490,8 @@ treated as the key with no passphrase and will use `RSA_PKCS1_PADDING`.
If `private_key` is an object, it is interpreted as a hash object with the
keys:
* `key` : {String} - PEM encoded private key
* `passphrase` : {String} - Optional passphrase for the private key
* `key`: {string} - PEM encoded private key
* `passphrase`: {string} - Optional passphrase for the private key
* `padding` : An optional padding value, one of the following:
* `crypto.constants.RSA_NO_PADDING`
* `crypto.constants.RSA_PKCS1_PADDING`
@ -1510,8 +1510,8 @@ treated as the key with no passphrase and will use `RSA_PKCS1_PADDING`.
If `public_key` is an object, it is interpreted as a hash object with the
keys:
* `key` : {String} - PEM encoded public key
* `passphrase` : {String} - Optional passphrase for the private key
* `key`: {string} - PEM encoded public key
* `passphrase`: {string} - Optional passphrase for the private key
* `padding` : An optional padding value, one of the following:
* `crypto.constants.RSA_NO_PADDING`
* `crypto.constants.RSA_PKCS1_PADDING`
@ -1534,8 +1534,8 @@ treated as the key with no passphrase and will use `RSA_PKCS1_OAEP_PADDING`.
If `public_key` is an object, it is interpreted as a hash object with the
keys:
* `key` : {String} - PEM encoded public key
* `passphrase` : {String} - Optional passphrase for the private key
* `key`: {string} - PEM encoded public key
* `passphrase`: {string} - Optional passphrase for the private key
* `padding` : An optional padding value, one of the following:
* `crypto.constants.RSA_NO_PADDING`
* `crypto.constants.RSA_PKCS1_PADDING`

4
doc/api/dns.md
View File

@ -80,13 +80,13 @@ Alternatively, `options` can be an object containing these properties:
* `family` {number} - The record family. If present, must be the integer
`4` or `6`. If not provided, both IP v4 and v6 addresses are accepted.
* `hints`: {Number} - If present, it should be one or more of the supported
* `hints`: {number} - If present, it should be one or more of the supported
`getaddrinfo` flags. If `hints` is not provided, then no flags are passed to
`getaddrinfo`. Multiple flags can be passed through `hints` by bitwise
`OR`ing their values.
See [supported `getaddrinfo` flags][] for more information on supported
flags.
* `all`: {Boolean} - When `true`, the callback returns all resolved addresses
* `all`: {boolean} - When `true`, the callback returns all resolved addresses
in an array, otherwise returns a single address. Defaults to `false`.
All properties are optional.

18
doc/api/errors.md
View File

@ -243,7 +243,7 @@ new MyError().stack;
### Error.stackTraceLimit
* {Number}
* {number}
The `Error.stackTraceLimit` property specifies the number of stack frames
collected by a stack trace (whether generated by `new Error().stack` or
@ -257,7 +257,7 @@ not capture any frames.
### error.message
* {String}
* {string}
The `error.message` property is the string description of the error as set by calling `new Error(message)`.
The `message` passed to the constructor will also appear in the first line of
@ -273,7 +273,7 @@ console.error(err.message);
### error.stack
* {String}
* {string}
The `error.stack` property is a string describing the point in the code at which
the `Error` was instantiated.
@ -449,14 +449,14 @@ added properties.
#### error.code
* {String}
* {string}
The `error.code` property is a string representing the error code, which is always
`E` followed by a sequence of capital letters.
#### error.errno
* {String | Number}
* {string|number}
The `error.errno` property is a number or a string.
The number is a **negative** value which corresponds to the error code defined in
@ -466,27 +466,27 @@ In case of a string, it is the same as `error.code`.
#### error.syscall
* {String}
* {string}
The `error.syscall` property is a string describing the [syscall][] that failed.
#### error.path
* {String}
* {string}
When present (e.g. in `fs` or `child_process`), the `error.path` property is a string
containing a relevant invalid pathname.
#### error.address
* {String}
* {string}
When present (e.g. in `net` or `dgram`), the `error.address` property is a string
describing the address to which the connection failed.
#### error.port
* {Number}
* {number}
When present (e.g. in `net` or `dgram`), the `error.port` property is a number representing
the connection's port that is not available.

354
doc/api/fs.md
View File

@ -122,7 +122,7 @@ added: v0.5.8
-->
* `eventType` {string} The type of fs change
* `filename` {string | Buffer} The filename that changed (if relevant/available)
* `filename` {string|Buffer} The filename that changed (if relevant/available)
Emitted when something changes in a watched directory or file.
See more details in [`fs.watch()`][].
@ -177,7 +177,7 @@ using the `fs.close()` method.
added: v0.1.93
-->
* `fd` {Integer} Integer file descriptor used by the ReadStream.
* `fd` {integer} Integer file descriptor used by the ReadStream.
Emitted when the ReadStream's file is opened.
@ -291,7 +291,7 @@ using the `fs.close()` method.
added: v0.1.93
-->
* `fd` {Integer} Integer file descriptor used by the WriteStream.
* `fd` {integer} Integer file descriptor used by the WriteStream.
Emitted when the WriteStream's file is opened.
@ -318,8 +318,8 @@ argument to `fs.createWriteStream()`. If `path` is passed as a string, then
added: v0.11.15
-->
* `path` {string | Buffer}
* `mode` {Integer}
* `path` {string|Buffer}
* `mode` {integer}
* `callback` {Function}
Tests a user's permissions for the file or directory specified by `path`.
@ -439,8 +439,8 @@ process.
added: v0.11.15
-->
* `path` {string | Buffer}
* `mode` {Integer}
* `path` {string|Buffer}
* `mode` {integer}
Synchronous version of [`fs.access()`][]. This throws if any accessibility
checks fail, and does nothing otherwise.
@ -461,11 +461,11 @@ changes:
description: The `file` parameter can be a file descriptor now.
-->
* `file` {string | Buffer | Number} filename or file descriptor
* `data` {string | Buffer}
* `options` {Object | String}
* `encoding` {string | Null} default = `'utf8'`
* `mode` {Integer} default = `0o666`
* `file` {string|Buffer|number} filename or file descriptor
* `data` {string|Buffer}
* `options` {Object|string}
* `encoding` {string|null} default = `'utf8'`
* `mode` {integer} default = `0o666`
* `flag` {string} default = `'a'`
* `callback` {Function}
@ -504,11 +504,11 @@ changes:
description: The `file` parameter can be a file descriptor now.
-->
* `file` {string | Buffer | Number} filename or file descriptor
* `data` {string | Buffer}
* `options` {Object | String}
* `encoding` {string | Null} default = `'utf8'`
* `mode` {Integer} default = `0o666`
* `file` {string|Buffer|number} filename or file descriptor
* `data` {string|Buffer}
* `options` {Object|string}
* `encoding` {string|null} default = `'utf8'`
* `mode` {integer} default = `0o666`
* `flag` {string} default = `'a'`
The synchronous version of [`fs.appendFile()`][]. Returns `undefined`.
@ -523,8 +523,8 @@ changes:
it will emit a deprecation warning.
-->
* `path` {string | Buffer}
* `mode` {Integer}
* `path` {string|Buffer}
* `mode` {integer}
* `callback` {Function}
Asynchronous chmod(2). No arguments other than a possible exception are given
@ -535,8 +535,8 @@ to the completion callback.
added: v0.6.7
-->
* `path` {string | Buffer}
* `mode` {Integer}
* `path` {string|Buffer}
* `mode` {integer}
Synchronous chmod(2). Returns `undefined`.
@ -550,9 +550,9 @@ changes:
it will emit a deprecation warning.
-->
* `path` {string | Buffer}
* `uid` {Integer}
* `gid` {Integer}
* `path` {string|Buffer}
* `uid` {integer}
* `gid` {integer}
* `callback` {Function}
Asynchronous chown(2). No arguments other than a possible exception are given
@ -563,9 +563,9 @@ to the completion callback.
added: v0.1.97
-->
* `path` {string | Buffer}
* `uid` {Integer}
* `gid` {Integer}
* `path` {string|Buffer}
* `uid` {integer}
* `gid` {integer}
Synchronous chown(2). Returns `undefined`.
@ -579,7 +579,7 @@ changes:
it will emit a deprecation warning.
-->
* `fd` {Integer}
* `fd` {integer}
* `callback` {Function}
Asynchronous close(2). No arguments other than a possible exception are given
@ -590,7 +590,7 @@ to the completion callback.
added: v0.1.21
-->
* `fd` {Integer}
* `fd` {integer}
Synchronous close(2). Returns `undefined`.
@ -612,15 +612,15 @@ changes:
description: The passed `options` object can be a string now.
-->
* `path` {string | Buffer}
* `options` {string | Object}
* `path` {string|Buffer}
* `options` {string|Object}
* `flags` {string}
* `encoding` {string}
* `fd` {Integer}
* `mode` {Integer}
* `fd` {integer}
* `mode` {integer}
* `autoClose` {boolean}
* `start` {Integer}
* `end` {Integer}
* `start` {integer}
* `end` {integer}
Returns a new [`ReadStream`][] object. (See [Readable Stream][]).
@ -683,14 +683,14 @@ changes:
description: The passed `options` object can be a string now.
-->
* `path` {string | Buffer}
* `options` {string | Object}
* `path` {string|Buffer}
* `options` {string|Object}
* `flags` {string}
* `defaultEncoding` {string}
* `fd` {Integer}
* `mode` {Integer}
* `fd` {integer}
* `mode` {integer}
* `autoClose` {boolean}
* `start` {Integer}
* `start` {integer}
Returns a new [`WriteStream`][] object. (See [Writable Stream][]).
@ -733,7 +733,7 @@ deprecated: v1.0.0
> Stability: 0 - Deprecated: Use [`fs.stat()`][] or [`fs.access()`][] instead.
* `path` {string | Buffer}
* `path` {string|Buffer}
* `callback` {Function}
Test whether or not the given path exists by checking with the file system.
@ -834,7 +834,7 @@ process.
added: v0.1.21
-->
* `path` {string | Buffer}
* `path` {string|Buffer}
Synchronous version of [`fs.exists()`][].
Returns `true` if the file exists, `false` otherwise.
@ -854,8 +854,8 @@ changes:
it will emit a deprecation warning.
-->
* `fd` {Integer}
* `mode` {Integer}
* `fd` {integer}
* `mode` {integer}
* `callback` {Function}
Asynchronous fchmod(2). No arguments other than a possible exception
@ -866,8 +866,8 @@ are given to the completion callback.
added: v0.4.7
-->
* `fd` {Integer}
* `mode` {Integer}
* `fd` {integer}
* `mode` {integer}
Synchronous fchmod(2). Returns `undefined`.
@ -881,9 +881,9 @@ changes:
it will emit a deprecation warning.
-->
* `fd` {Integer}
* `uid` {Integer}
* `gid` {Integer}
* `fd` {integer}
* `uid` {integer}
* `gid` {integer}
* `callback` {Function}
Asynchronous fchown(2). No arguments other than a possible exception are given
@ -894,9 +894,9 @@ to the completion callback.
added: v0.4.7
-->
* `fd` {Integer}
* `uid` {Integer}
* `gid` {Integer}
* `fd` {integer}
* `uid` {integer}
* `gid` {integer}
Synchronous fchown(2). Returns `undefined`.
@ -910,7 +910,7 @@ changes:
it will emit a deprecation warning.
-->
* `fd` {Integer}
* `fd` {integer}
* `callback` {Function}
Asynchronous fdatasync(2). No arguments other than a possible exception are
@ -921,7 +921,7 @@ given to the completion callback.
added: v0.1.96
-->
* `fd` {Integer}
* `fd` {integer}
Synchronous fdatasync(2). Returns `undefined`.
@ -935,7 +935,7 @@ changes:
it will emit a deprecation warning.
-->
* `fd` {Integer}
* `fd` {integer}
* `callback` {Function}
Asynchronous fstat(2). The callback gets two arguments `(err, stats)` where
@ -947,7 +947,7 @@ except that the file to be stat-ed is specified by the file descriptor `fd`.
added: v0.1.95
-->
* `fd` {Integer}
* `fd` {integer}
Synchronous fstat(2). Returns an instance of [`fs.Stats`][].
@ -961,7 +961,7 @@ changes:
it will emit a deprecation warning.
-->
* `fd` {Integer}
* `fd` {integer}
* `callback` {Function}
Asynchronous fsync(2). No arguments other than a possible exception are given
@ -972,7 +972,7 @@ to the completion callback.
added: v0.1.96
-->
* `fd` {Integer}
* `fd` {integer}
Synchronous fsync(2). Returns `undefined`.
@ -986,8 +986,8 @@ changes:
it will emit a deprecation warning.
-->
* `fd` {Integer}
* `len` {Integer} default = `0`
* `fd` {integer}
* `len` {integer} default = `0`
* `callback` {Function}
Asynchronous ftruncate(2). No arguments other than a possible exception are
@ -1039,8 +1039,8 @@ The last three bytes are null bytes ('\0'), to compensate the over-truncation.
added: v0.8.6
-->
* `fd` {Integer}
* `len` {Integer} default = `0`
* `fd` {integer}
* `len` {integer} default = `0`
Synchronous ftruncate(2). Returns `undefined`.
@ -1058,9 +1058,9 @@ changes:
time specifiers.
-->
* `fd` {Integer}
* `atime` {Integer}
* `mtime` {Integer}
* `fd` {integer}
* `atime` {integer}
* `mtime` {integer}
* `callback` {Function}
Change the file timestamps of a file referenced by the supplied file
@ -1076,9 +1076,9 @@ changes:
time specifiers.
-->
* `fd` {Integer}
* `atime` {Integer}
* `mtime` {Integer}
* `fd` {integer}
* `atime` {integer}
* `mtime` {integer}
Synchronous version of [`fs.futimes()`][]. Returns `undefined`.
@ -1092,8 +1092,8 @@ changes:
it will emit a deprecation warning.
-->
* `path` {string | Buffer}
* `mode` {Integer}
* `path` {string|Buffer}
* `mode` {integer}
* `callback` {Function}
Asynchronous lchmod(2). No arguments other than a possible exception
@ -1106,8 +1106,8 @@ Only available on Mac OS X.
deprecated: v0.4.7
-->
* `path` {string | Buffer}
* `mode` {Integer}
* `path` {string|Buffer}
* `mode` {integer}
Synchronous lchmod(2). Returns `undefined`.
@ -1121,9 +1121,9 @@ changes:
it will emit a deprecation warning.
-->
* `path` {string | Buffer}
* `uid` {Integer}
* `gid` {Integer}
* `path` {string|Buffer}
* `uid` {integer}
* `gid` {integer}
* `callback` {Function}
Asynchronous lchown(2). No arguments other than a possible exception are given
@ -1134,9 +1134,9 @@ to the completion callback.
deprecated: v0.4.7
-->
* `path` {string | Buffer}
* `uid` {Integer}
* `gid` {Integer}
* `path` {string|Buffer}
* `uid` {integer}
* `gid` {integer}
Synchronous lchown(2). Returns `undefined`.
@ -1150,8 +1150,8 @@ changes:
it will emit a deprecation warning.
-->
* `existingPath` {string | Buffer}
* `newPath` {string | Buffer}
* `existingPath` {string|Buffer}
* `newPath` {string|Buffer}
* `callback` {Function}
Asynchronous link(2). No arguments other than a possible exception are given to
@ -1162,8 +1162,8 @@ the completion callback.
added: v0.1.31
-->
* `existingPath` {string | Buffer}
* `newPath` {string | Buffer}
* `existingPath` {string|Buffer}
* `newPath` {string|Buffer}
Synchronous link(2). Returns `undefined`.
@ -1177,7 +1177,7 @@ changes:
it will emit a deprecation warning.
-->
* `path` {string | Buffer}
* `path` {string|Buffer}
* `callback` {Function}
Asynchronous lstat(2). The callback gets two arguments `(err, stats)` where
@ -1190,7 +1190,7 @@ not the file that it refers to.
added: v0.1.30
-->
* `path` {string | Buffer}
* `path` {string|Buffer}
Synchronous lstat(2). Returns an instance of [`fs.Stats`][].
@ -1204,8 +1204,8 @@ changes:
it will emit a deprecation warning.
-->
* `path` {string | Buffer}
* `mode` {Integer}
* `path` {string|Buffer}
* `mode` {integer}
* `callback` {Function}
Asynchronous mkdir(2). No arguments other than a possible exception are given
@ -1216,8 +1216,8 @@ to the completion callback. `mode` defaults to `0o777`.
added: v0.1.21
-->
* `path` {string | Buffer}
* `mode` {Integer}
* `path` {string|Buffer}
* `mode` {integer}
Synchronous mkdir(2). Returns `undefined`.
@ -1235,7 +1235,7 @@ changes:
-->
* `prefix` {string}
* `options` {string | Object}
* `options` {string|Object}
* `encoding` {string} default = `'utf8'`
* `callback` {Function}
@ -1297,7 +1297,7 @@ added: v5.10.0
-->
* `prefix` {string}
* `options` {string | Object}
* `options` {string|Object}
* `encoding` {string} default = `'utf8'`
The synchronous version of [`fs.mkdtemp()`][]. Returns the created
@ -1311,9 +1311,9 @@ object with an `encoding` property specifying the character encoding to use.
added: v0.0.2
-->
* `path` {string | Buffer}
* `flags` {string | Number}
* `mode` {Integer}
* `path` {string|Buffer}
* `flags` {string|number}
* `mode` {integer}
* `callback` {Function}
Asynchronous file open. See open(2). `flags` can be:
@ -1395,9 +1395,9 @@ fs.open('<directory>', 'a+', (err, fd) => {
added: v0.1.21
-->
* `path` {string | Buffer}
* `flags` {string | Number}
* `mode` {Integer}
* `path` {string|Buffer}
* `flags` {string|number}
* `mode` {integer}
Synchronous version of [`fs.open()`][]. Returns an integer representing the file
descriptor.
@ -1414,11 +1414,11 @@ changes:
description: The `length` parameter can now be `0`.
-->
* `fd` {Integer}
* `buffer` {string | Buffer | Uint8Array}
* `offset` {Integer}
* `length` {Integer}
* `position` {Integer}
* `fd` {integer}
* `buffer` {string|Buffer|Uint8Array}
* `offset` {integer}
* `length` {integer}
* `position` {integer}
* `callback` {Function}
Read data from the file specified by `fd`.
@ -1444,8 +1444,8 @@ changes:
it will emit a deprecation warning.
-->
* `path` {string | Buffer}
* `options` {string | Object}
* `path` {string|Buffer}
* `options` {string|Object}
* `encoding` {string} default = `'utf8'`
* `callback` {Function}
@ -1463,8 +1463,8 @@ the filenames returned will be passed as `Buffer` objects.
added: v0.1.21
-->
* `path` {string | Buffer}
* `options` {string | Object}
* `path` {string|Buffer}
* `options` {string|Object}
* `encoding` {string} default = `'utf8'`
Synchronous readdir(3). Returns an array of filenames excluding `'.'` and
@ -1492,9 +1492,9 @@ changes:
description: The `file` parameter can be a file descriptor now.
-->
* `file` {string | Buffer | Integer} filename or file descriptor
* `options` {Object | String}
* `encoding` {string | Null} default = `null`
* `file` {string|Buffer|integer} filename or file descriptor
* `options` {Object|string}
* `encoding` {string|null} default = `null`
* `flag` {string} default = `'r'`
* `callback` {Function}
@ -1532,9 +1532,9 @@ changes:
description: The `file` parameter can be a file descriptor now.
-->
* `file` {string | Buffer | Integer} filename or file descriptor
* `options` {Object | String}
* `encoding` {string | Null} default = `null`
* `file` {string|Buffer|integer} filename or file descriptor
* `options` {Object|string}
* `encoding` {string|null} default = `null`
* `flag` {string} default = `'r'`
Synchronous version of [`fs.readFile`][]. Returns the contents of the `file`.
@ -1552,8 +1552,8 @@ changes:
it will emit a deprecation warning.
-->
* `path` {string | Buffer}
* `options` {string | Object}
* `path` {string|Buffer}
* `options` {string|Object}
* `encoding` {string} default = `'utf8'`
* `callback` {Function}
@ -1570,8 +1570,8 @@ the link path returned will be passed as a `Buffer` object.
added: v0.1.31
-->
* `path` {string | Buffer}
* `options` {string | Object}
* `path` {string|Buffer}
* `options` {string|Object}
* `encoding` {string} default = `'utf8'`
Synchronous readlink(2). Returns the symbolic link's string value.
@ -1590,11 +1590,11 @@ changes:
description: The `length` parameter can now be `0`.
-->
* `fd` {Integer}
* `buffer` {string | Buffer | Uint8Array}
* `offset` {Integer}
* `length` {Integer}
* `position` {Integer}
* `fd` {integer}
* `buffer` {string|Buffer|Uint8Array}
* `offset` {integer}
* `length` {integer}
* `position` {integer}
Synchronous version of [`fs.read()`][]. Returns the number of `bytesRead`.
@ -1615,8 +1615,8 @@ changes:
description: The `cache` parameter was removed.
-->
* `path` {string | Buffer}
* `options` {string | Object}
* `path` {string|Buffer}
* `options` {string|Object}
* `encoding` {string} default = `'utf8'`
* `callback` {Function}
@ -1643,8 +1643,8 @@ changes:
description: The `cache` parameter was removed.
-->
* `path` {string | Buffer};
* `options` {string | Object}
* `path` {string|Buffer};
* `options` {string|Object}
* `encoding` {string} default = `'utf8'`
Synchronous realpath(3). Returns the resolved path.
@ -1666,8 +1666,8 @@ changes:
it will emit a deprecation warning.
-->
* `oldPath` {string | Buffer}
* `newPath` {string | Buffer}
* `oldPath` {string|Buffer}
* `newPath` {string|Buffer}
* `callback` {Function}
Asynchronous rename(2). No arguments other than a possible exception are given
@ -1678,8 +1678,8 @@ to the completion callback.
added: v0.1.21
-->
* `oldPath` {string | Buffer}
* `newPath` {string | Buffer}
* `oldPath` {string|Buffer}
* `newPath` {string|Buffer}
Synchronous rename(2). Returns `undefined`.
@ -1693,7 +1693,7 @@ changes:
it will emit a deprecation warning.
-->
* `path` {string | Buffer}
* `path` {string|Buffer}
* `callback` {Function}
Asynchronous rmdir(2). No arguments other than a possible exception are given
@ -1704,7 +1704,7 @@ to the completion callback.
added: v0.1.21
-->
* `path` {string | Buffer}
* `path` {string|Buffer}
Synchronous rmdir(2). Returns `undefined`.
@ -1718,7 +1718,7 @@ changes:
it will emit a deprecation warning.
-->
* `path` {string | Buffer}
* `path` {string|Buffer}
* `callback` {Function}
Asynchronous stat(2). The callback gets two arguments `(err, stats)` where
@ -1739,7 +1739,7 @@ is recommended.
added: v0.1.21
-->
* `path` {string | Buffer}
* `path` {string|Buffer}
Synchronous stat(2). Returns an instance of [`fs.Stats`][].
@ -1748,8 +1748,8 @@ Synchronous stat(2). Returns an instance of [`fs.Stats`][].
added: v0.1.31
-->
* `target` {string | Buffer}
* `path` {string | Buffer}
* `target` {string|Buffer}
* `path` {string|Buffer}
* `type` {string}
* `callback` {Function}
@ -1773,8 +1773,8 @@ It creates a symbolic link named "new-port" that points to "foo".
added: v0.1.31
-->
* `target` {string | Buffer}
* `path` {string | Buffer}
* `target` {string|Buffer}
* `path` {string|Buffer}
* `type` {string}
Synchronous symlink(2). Returns `undefined`.
@ -1789,8 +1789,8 @@ changes:
it will emit a deprecation warning.
-->
* `path` {string | Buffer}
* `len` {Integer} default = `0`
* `path` {string|Buffer}
* `len` {integer} default = `0`
* `callback` {Function}
Asynchronous truncate(2). No arguments other than a possible exception are
@ -1802,8 +1802,8 @@ first argument. In this case, `fs.ftruncate()` is called.
added: v0.8.6
-->
* `path` {string | Buffer}
* `len` {Integer} default = `0`
* `path` {string|Buffer}
* `len` {integer} default = `0`
Synchronous truncate(2). Returns `undefined`. A file descriptor can also be
passed as the first argument. In this case, `fs.ftruncateSync()` is called.
@ -1818,7 +1818,7 @@ changes:
it will emit a deprecation warning.
-->
* `path` {string | Buffer}
* `path` {string|Buffer}
* `callback` {Function}
Asynchronous unlink(2). No arguments other than a possible exception are given
@ -1829,7 +1829,7 @@ to the completion callback.
added: v0.1.21
-->
* `path` {string | Buffer}
* `path` {string|Buffer}
Synchronous unlink(2). Returns `undefined`.
@ -1838,7 +1838,7 @@ Synchronous unlink(2). Returns `undefined`.
added: v0.1.31
-->
* `filename` {string | Buffer}
* `filename` {string|Buffer}
* `listener` {Function}
Stop watching for changes on `filename`. If `listener` is specified, only that
@ -1866,9 +1866,9 @@ changes:
time specifiers.
-->
* `path` {string | Buffer}
* `atime` {Integer}
* `mtime` {Integer}
* `path` {string|Buffer}
* `atime` {integer}
* `mtime` {integer}
* `callback` {Function}
Change file timestamps of the file referenced by the supplied path.
@ -1893,9 +1893,9 @@ changes:
time specifiers.
-->
* `path` {string | Buffer}
* `atime` {Integer}
* `mtime` {Integer}
* `path` {string|Buffer}
* `atime` {integer}
* `mtime` {integer}
Synchronous version of [`fs.utimes()`][]. Returns `undefined`.
@ -1908,8 +1908,8 @@ changes:
description: The passed `options` object will never be modified.
-->
* `filename` {string | Buffer}
* `options` {string | Object}
* `filename` {string|Buffer}
* `options` {string|Object}
* `persistent` {boolean} Indicates whether the process should continue to run
as long as files are being watched. default = `true`
* `recursive` {boolean} Indicates whether all subdirectories should be
@ -2011,10 +2011,10 @@ fs.watch('somedir', (eventType, filename) => {
added: v0.1.31
-->
* `filename` {string | Buffer}
* `filename` {string|Buffer}
* `options` {Object}
* `persistent` {boolean}
* `interval` {Integer}
* `interval` {integer}
* `listener` {Function}
Watch for changes on `filename`. The callback `listener` will be called each
@ -2068,11 +2068,11 @@ changes:
it will emit a deprecation warning.
-->
* `fd` {Integer}
* `buffer` {Buffer | Uint8Array}
* `offset` {Integer}
* `length` {Integer}
* `position` {Integer}
* `fd` {integer}
* `buffer` {Buffer|Uint8Array}
* `offset` {integer}
* `length` {integer}
* `position` {integer}
* `callback` {Function}
Write `buffer` to the file specified by `fd`.
@ -2108,9 +2108,9 @@ changes:
it will emit a deprecation warning.
-->
* `fd` {Integer}
* `fd` {integer}
* `string` {string}
* `position` {Integer}
* `position` {integer}
* `encoding` {string}
* `callback` {Function}
@ -2155,11 +2155,11 @@ changes:
description: The `file` parameter can be a file descriptor now.
-->
* `file` {string | Buffer | Integer} filename or file descriptor
* `data` {string | Buffer | Uint8Array}
* `options` {Object | String}
* `encoding` {string | Null} default = `'utf8'`
* `mode` {Integer} default = `0o666`
* `file` {string|Buffer|integer} filename or file descriptor
* `data` {string|Buffer|Uint8Array}
* `options` {Object|string}
* `encoding` {string|null} default = `'utf8'`
* `mode` {integer} default = `0o666`
* `flag` {string} default = `'w'`
* `callback` {Function}
@ -2205,11 +2205,11 @@ changes:
description: The `file` parameter can be a file descriptor now.
-->
* `file` {string | Buffer | Integer} filename or file descriptor
* `data` {string | Buffer | Uint8Array}
* `options` {Object | String}
* `encoding` {string | Null} default = `'utf8'`
* `mode` {Integer} default = `0o666`
* `file` {string|Buffer|integer} filename or file descriptor
* `data` {string|Buffer|Uint8Array}
* `options` {Object|string}
* `encoding` {string|null} default = `'utf8'`
* `mode` {integer} default = `0o666`
* `flag` {string} default = `'w'`
The synchronous version of [`fs.writeFile()`][]. Returns `undefined`.
@ -2226,11 +2226,11 @@ changes:
description: The `offset` and `length` parameters are optional now.
-->
* `fd` {Integer}
* `buffer` {Buffer | Uint8Array}
* `offset` {Integer}
* `length` {Integer}
* `position` {Integer}
* `fd` {integer}
* `buffer` {Buffer|Uint8Array}
* `offset` {integer}
* `length` {integer}
* `position` {integer}
## fs.writeSync(fd, string[, position[, encoding]])
<!-- YAML
@ -2241,9 +2241,9 @@ changes:
description: The `position` parameter is optional now.
-->
* `fd` {Integer}
* `fd` {integer}
* `string` {string}
* `position` {Integer}
* `position` {integer}
* `encoding` {string}
Synchronous versions of [`fs.write()`][]. Returns the number of bytes written.

4
doc/api/globals.md
View File

@ -27,7 +27,7 @@ added: v0.1.27
<!-- type=var -->
* {String}
* {string}
The directory name of the current module. This the same as the
[`path.dirname()`][] of the [`__filename`][].
@ -50,7 +50,7 @@ added: v0.0.1
<!-- type=var -->
* {String}
* {string}
The file name of the current module. This is the resolved absolute path of the
current module file.

8
doc/api/http.md
View File

@ -463,7 +463,7 @@ aborted, in milliseconds since 1 January 1970 00:00:00 UTC.
added: v0.1.90
-->
* `data` {string | Buffer}
* `data` {string|Buffer}
* `encoding` {string}
* `callback` {Function}
@ -531,7 +531,7 @@ Returns `request`.
added: v0.1.29
-->
* `chunk` {string | Buffer}
* `chunk` {string|Buffer}
* `encoding` {string}
* `callback` {Function}
@ -907,7 +907,7 @@ will result in a [`TypeError`][] being thrown.
added: v0.1.90
-->
* `data` {string | Buffer}
* `data` {string|Buffer}
* `encoding` {string}
* `callback` {Function}
@ -1152,7 +1152,7 @@ status message which was sent out.
added: v0.1.29
-->
* `chunk` {string | Buffer}
* `chunk` {string|Buffer}
* `encoding` {string}
* `callback` {Function}
* Returns: {Boolean}

6
doc/api/modules.md
View File

@ -580,7 +580,7 @@ function require(...) {
added: v0.1.16
-->
* {String}
* {string}
The fully resolved filename to the module.
@ -589,7 +589,7 @@ The fully resolved filename to the module.
added: v0.1.16
-->
* {String}
* {string}
The identifier for the module. Typically this is the fully resolved
filename.
@ -599,7 +599,7 @@ filename.
added: v0.1.16
-->
* {Boolean}
* {boolean}
Whether or not the module is done loading, or is in the process of
loading.

24
doc/api/os.md
View File

@ -14,7 +14,7 @@ const os = require('os');
added: v0.7.8
-->
* {String}
* {string}
A string constant defining the operating system-specific end-of-line marker:
@ -26,7 +26,7 @@ A string constant defining the operating system-specific end-of-line marker:
added: v0.5.0
-->
* Returns: {String}
* Returns: {string}
The `os.arch()` method returns a string identifying the operating system CPU
architecture *for which the Node.js binary was compiled*.
@ -172,7 +172,7 @@ all processors are always 0.
added: v0.9.4
-->
* Returns: {String}
* Returns: {string}
The `os.endianness()` method returns a string identifying the endianness of the
CPU *for which the Node.js binary was compiled*.
@ -187,7 +187,7 @@ Possible values are:
added: v0.3.3
-->
* Returns: {Integer}
* Returns: {integer}
The `os.freemem()` method returns the amount of free system memory in bytes as
an integer.
@ -197,7 +197,7 @@ an integer.
added: v2.3.0
-->
* Returns: {String}
* Returns: {string}
The `os.homedir()` method returns the home directory of the current user as a
string.
@ -207,7 +207,7 @@ string.
added: v0.3.3
-->
* Returns: {String}
* Returns: {string}
The `os.hostname()` method returns the hostname of the operating system as a
string.
@ -295,7 +295,7 @@ The properties available on the assigned network address object include:
added: v0.5.0
-->
* Returns: {String}
* Returns: {string}
The `os.platform()` method returns a string identifying the operating system
platform as set during compile time of Node.js.
@ -321,7 +321,7 @@ to be experimental at this time.
added: v0.3.3
-->
* Returns: {String}
* Returns: {string}
The `os.release()` method returns a string identifying the operating system
release.
@ -340,7 +340,7 @@ changes:
returns a path with a trailing slash on any platform
-->
* Returns: {String}
* Returns: {string}
The `os.tmpdir()` method returns a string specifying the operating system's
default directory for temporary files.
@ -350,7 +350,7 @@ default directory for temporary files.
added: v0.3.3
-->
* Returns: {Integer}
* Returns: {integer}
The `os.totalmem()` method returns the total amount of system memory in bytes
as an integer.
@ -360,7 +360,7 @@ as an integer.
added: v0.3.3
-->
* Returns: {String}
* Returns: {string}
The `os.type()` method returns a string identifying the operating system name
as returned by uname(3). For example `'Linux'` on Linux, `'Darwin'` on OS X and
@ -374,7 +374,7 @@ information about the output of running uname(3) on various operating systems.
added: v0.3.3
-->
* Returns: {Integer}
* Returns: {integer}
The `os.uptime()` method returns the system uptime in number of seconds.

22
doc/api/path.md
View File

@ -65,7 +65,7 @@ changes:
* `path` {string}
* `ext` {string} An optional file extension
* Returns: {String}
* Returns: {string}
The `path.basename()` methods returns the last portion of a `path`, similar to
the Unix `basename` command.
@ -88,7 +88,7 @@ and is not a string.
added: v0.9.3
-->
* {String}
* {string}
Provides the platform-specific path delimiter:
@ -125,7 +125,7 @@ changes:
-->
* `path` {string}
* Returns: {String}
* Returns: {string}
The `path.dirname()` method returns the directory name of a `path`, similar to
the Unix `dirname` command.
@ -149,7 +149,7 @@ changes:
-->
* `path` {string}
* Returns: {String}
* Returns: {string}
The `path.extname()` method returns the extension of the `path`, from the last
occurrence of the `.` (period) character to end of string in the last portion of
@ -189,7 +189,7 @@ added: v0.11.15
* `base` {string}
* `name` {string}
* `ext` {string}
* Returns: {String}
* Returns: {string}
The `path.format()` method returns a path string from an object. This is the
opposite of [`path.parse()`][].
@ -248,7 +248,7 @@ added: v0.11.2
-->
* `path` {string}
* Returns: {Boolean}
* Returns: {boolean}
The `path.isAbsolute()` method determines if `path` is an absolute path.
@ -283,7 +283,7 @@ added: v0.1.16
-->
* `...paths` {string} A sequence of path segments
* Returns: {String}
* Returns: {string}
The `path.join()` method joins all given `path` segments together using the
platform specific separator as a delimiter, then normalizes the resulting path.
@ -310,7 +310,7 @@ added: v0.1.23
-->
* `path` {string}
* Returns: {String}
* Returns: {string}
The `path.normalize()` method normalizes the given `path`, resolving `'..'` and
`'.'` segments.
@ -429,7 +429,7 @@ changes:
* `from` {string}
* `to` {string}
* Returns: {String}
* Returns: {string}
The `path.relative()` method returns the relative path from `from` to `to`.
If `from` and `to` each resolve to the same path (after calling `path.resolve()`
@ -460,7 +460,7 @@ added: v0.3.4
-->
* `...paths` {string} A sequence of paths or path segments
* Returns: {String}
* Returns: {string}
The `path.resolve()` method resolves a sequence of paths or path segments into
an absolute path.
@ -502,7 +502,7 @@ A [`TypeError`][] is thrown if any of the arguments is not a string.
added: v0.7.9
-->
* {String}
* {string}
Provides the platform-specific path segment separator:

42
doc/api/process.md
View File

@ -416,7 +416,7 @@ generate a core file.
added: v0.5.0
-->
* {String}
* {string}
The `process.arch` property returns a String identifying the processor
architecture that the Node.js process is currently running on. For instance
@ -470,7 +470,7 @@ Would generate the output:
added: 6.4.0
-->
* {String}
* {string}
The `process.argv0` property stores a read-only copy of the original value of
`argv[0]` passed when Node.js starts.
@ -565,7 +565,7 @@ replace the value of `process.config`.
added: v0.7.2
-->
* {Boolean}
* {boolean}
If the Node.js process is spawned with an IPC channel (see the [Child Process][]
and [Cluster][] documentation), the `process.connected` property will return
@ -583,8 +583,8 @@ added: v6.1.0
* `previousValue` {Object} A previous return value from calling
`process.cpuUsage()`
* Returns: {Object}
* `user` {Integer}
* `system` {Integer}
* `user` {integer}
* `system` {integer}
The `process.cpuUsage()` method returns the user and system CPU time usage of
the current process, in an object with properties `user` and `system`, whose
@ -612,7 +612,7 @@ console.log(process.cpuUsage(startUsage));
added: v0.1.8
-->
* Returns: {String}
* Returns: {string}
The `process.cwd()` method returns the current working directory of the Node.js
process.
@ -839,7 +839,7 @@ And `process.argv`:
added: v0.1.100
-->
* {String}
* {string}
The `process.execPath` property returns the absolute pathname of the executable
that started the Node.js process.
@ -856,7 +856,7 @@ For example:
added: v0.1.13
-->
* `code` {Integer} The exit code. Defaults to `0`.
* `code` {integer} The exit code. Defaults to `0`.
The `process.exit()` method instructs Node.js to terminate the process
synchronously with an exit status of `code`. If `code` is omitted, exit uses
@ -921,7 +921,7 @@ is safer than calling `process.exit()`.
added: v0.11.8
-->
* {Integer}
* {integer}
A number which will be the process exit code, when the process either
exits gracefully, or is exited via [`process.exit()`][] without specifying
@ -1006,7 +1006,7 @@ Android)
added: v0.1.28
-->
* Returns: {Integer}
* Returns: {integer}
The `process.getuid()` method returns the numeric user identity of the process.
(See getuid(2).)
@ -1145,10 +1145,10 @@ changes:
-->
* Returns: {Object}
* `rss` {Integer}
* `heapTotal` {Integer}
* `heapUsed` {Integer}
* `external` {Integer}
* `rss` {integer}
* `heapTotal` {integer}
* `heapUsed` {integer}
* `external` {integer}
The `process.memoryUsage()` method returns an object describing the memory usage
of the Node.js process measured in bytes.
@ -1274,7 +1274,7 @@ happening, just like a `while(true);` loop.
added: v0.1.15
-->
* {Integer}
* {integer}
The `process.pid` property returns the PID of the process.
@ -1287,7 +1287,7 @@ console.log(`This process is pid ${process.pid}`);
added: v0.1.16
-->
* {String}
* {string}
The `process.platform` property returns a string identifying the operating
system platform on which the Node.js process is running. For instance
@ -1316,7 +1316,7 @@ tarball.
legacy io.js releases, this will be `'io.js'`.
* `sourceUrl` {string} an absolute URL pointing to a _`.tar.gz`_ file containing
the source code of the current release.
* `headersUrl`{String} an absolute URL pointing to a _`.tar.gz`_ file containing
* `headersUrl`{string} an absolute URL pointing to a _`.tar.gz`_ file containing
only the source header files for the current release. This file is
significantly smaller than the full source file and can be used for compiling
Node.js native add-ons.
@ -1352,7 +1352,7 @@ added: v0.5.9
* `sendHandle` {Handle object}
* `options` {Object}
* `callback` {Function}
* Returns: {Boolean}
* Returns: {boolean}
If Node.js is spawned with an IPC channel, the `process.send()` method can be
used to send messages to the parent process. Messages will be received as a
@ -1604,7 +1604,7 @@ See the [TTY][] documentation for more information.
added: v0.1.104
-->
* {String}
* {string}
The `process.title` property returns the current process title (i.e. returns
the current value of `ps`). Assigning a new value to `process.title` modifies
@ -1645,7 +1645,7 @@ console.log(
added: v0.5.0
-->
* Returns: {Number}
* Returns: {number}
The `process.uptime()` method returns the number of seconds the current Node.js
process has been running.
@ -1655,7 +1655,7 @@ process has been running.
added: v0.1.3
-->
* {String}
* {string}
The `process.version` property returns the Node.js version string.

2
doc/api/repl.md
View File

@ -379,7 +379,7 @@ changes:
description: The `options` parameter is optional now.
-->
* `options` {Object | String}
* `options` {Object|string}
* `prompt` {string} The input prompt to display. Defaults to `> `
(with a trailing space).
* `input` {Readable} The Readable stream from which REPL input will be read.

8
doc/api/stream.md
View File

@ -443,7 +443,7 @@ changes:
* `chunk` {string|Buffer} The data to write
* `encoding` {string} The encoding, if `chunk` is a String
* `callback` {Function} Callback for when this chunk of data is flushed
* Returns: {Boolean} `false` if the stream wishes for the calling code to
* Returns: {boolean} `false` if the stream wishes for the calling code to
wait for the `'drain'` event to be emitted before continuing to write
additional data; otherwise `true`.
@ -741,7 +741,7 @@ preferred over the use of the `'readable'` event.
added: v0.11.14
-->
* Returns: {Boolean}
* Returns: {boolean}
The `readable.isPaused()` method returns the current operating state of the
Readable. This is used primarily by the mechanism that underlies the
@ -846,7 +846,7 @@ added: v0.9.4
-->
* `size` {number} Optional argument to specify how much data to read.
* Return {String|Buffer|null}
* Return {string|Buffer|null}
The `readable.read()` method pulls some data out of the internal buffer and
returns it. If no data available to be read, `null` is returned. By default,
@ -1503,7 +1503,7 @@ user programs.
* `chunk` {Buffer|null|string} Chunk of data to push into the read queue
* `encoding` {string} Encoding of String chunks. Must be a valid
Buffer encoding, such as `'utf8'` or `'ascii'`
* Returns {Boolean} `true` if additional chunks of data may continued to be
* Returns {boolean} `true` if additional chunks of data may continued to be
pushed; `false` otherwise.
When `chunk` is a `Buffer` or `string`, the `chunk` of data will be added to the

38
doc/api/url.md
View File

@ -136,7 +136,7 @@ forward-slash characters (`/`) are required following the colon in the
added: v0.1.25
-->
* `urlObject` {Object | String} A URL object (as returned by `url.parse()` or
* `urlObject` {Object|string} A URL object (as returned by `url.parse()` or
constructed otherwise). If a string, it is converted to an object by passing
it to `url.parse()`.
@ -356,7 +356,7 @@ object returned by `url.parse()` are shown. Below it are properties of a WHATWG
#### Constructor: new URL(input[, base])
* `input` {string} The input URL to parse
* `base` {string | URL} The base URL to resolve against if the `input` is not
* `base` {string|URL} The base URL to resolve against if the `input` is not
absolute.
Creates a new `URL` object by parsing the `input` relative to the `base`. If
@ -388,7 +388,7 @@ Additional [examples of parsed URLs][] may be found in the WHATWG URL Standard.
#### url.hash
* {String}
* {string}
Gets and sets the fragment portion of the URL.
@ -409,7 +409,7 @@ percent-encode may vary somewhat from what the [`url.parse()`][] and
#### url.host
* {String}
* {string}
Gets and sets the host portion of the URL.
@ -427,7 +427,7 @@ Invalid host values assigned to the `host` property are ignored.
#### url.hostname
* {String}
* {string}
Gets and sets the hostname portion of the URL. The key difference between
`url.host` and `url.hostname` is that `url.hostname` does *not* include the
@ -447,7 +447,7 @@ Invalid hostname values assigned to the `hostname` property are ignored.
#### url.href
* {String}
* {string}
Gets and sets the serialized URL.
@ -472,7 +472,7 @@ will be thrown.
#### url.origin
* {String}
* {string}
Gets the read-only serialization of the URL's origin. Unicode characters that
may be contained within the hostname will be encoded as-is without [Punycode][]
@ -495,7 +495,7 @@ console.log(idnURL.hostname);
#### url.password
* {String}
* {string}
Gets and sets the password portion of the URL.
@ -516,7 +516,7 @@ percent-encode may vary somewhat from what the [`url.parse()`][] and
#### url.pathname
* {String}
* {string}
Gets and sets the path portion of the URL.
@ -537,7 +537,7 @@ to percent-encode may vary somewhat from what the [`url.parse()`][] and
#### url.port
* {String}
* {string}
Gets and sets the port portion of the URL.
@ -592,7 +592,7 @@ lies outside the range denoted above, it is ignored.
#### url.protocol
* {String}
* {string}
Gets and sets the protocol portion of the URL.
@ -610,7 +610,7 @@ Invalid URL protocol values assigned to the `protocol` property are ignored.
#### url.search
* {String}
* {string}
Gets and sets the serialized query portion of the URL.
@ -640,7 +640,7 @@ documentation for details.
#### url.username
* {String}
* {string}
Gets and sets the username portion of the URL.
@ -661,7 +661,7 @@ and [`url.format()`][] methods would produce.
#### url.toString()
* Returns: {String}
* Returns: {string}
The `toString()` method on the `URL` object returns the serialized URL. The
value returned is equivalent to that of [`url.href`][] and [`url.toJSON()`][].
@ -672,7 +672,7 @@ to customize the serialization process of the URL. For more flexibility,
#### url.toJSON()
* Returns: {String}
* Returns: {string}
The `toJSON()` method on the `URL` object returns the serialized URL. The
value returned is equivalent to that of [`url.href`][] and
@ -781,7 +781,7 @@ no such pairs, an empty array is returned.
#### urlSearchParams.has(name)
* `name` {string}
* Returns: {Boolean}
* Returns: {boolean}
Returns `true` if there is at least one name-value pair whose name is `name`.
@ -845,7 +845,7 @@ console.log(params.toString());
#### urlSearchParams.toString()
* Returns: {String}
* Returns: {string}
Returns the search parameters serialized as a string, with characters
percent-encoded where necessary.
@ -880,7 +880,7 @@ for (const [name, value] of params) {
### require('url').domainToASCII(domain)
* `domain` {string}
* Returns: {String}
* Returns: {string}
Returns the [Punycode][] ASCII serialization of the `domain`. If `domain` is an
invalid domain, the empty string is returned.
@ -903,7 +903,7 @@ the new `URL` implementation but is not part of the WHATWG URL standard.
### require('url').domainToUnicode(domain)
* `domain` {string}
* Returns: {String}
* Returns: {string}
Returns the Unicode serialization of the `domain`. If `domain` is an invalid
domain, the empty string is returned.

9
tools/doc/type-parser.js
View File

@ -4,12 +4,13 @@ const jsDocPrefix = 'https://developer.mozilla.org/en-US/docs/Web/JavaScript/';
const jsDocUrl = jsDocPrefix + 'Reference/Global_Objects/';
const jsPrimitiveUrl = jsDocPrefix + 'Data_structures';
const jsPrimitives = {
'integer': 'Number', // this is for extending
'number': 'Number',
'string': 'String',
'boolean': 'Boolean',
'integer': 'Number', // not a primitive, used for clarification
'null': 'Null',
'symbol': 'Symbol'
'number': 'Number',
'string': 'String',
'symbol': 'Symbol',
'undefined': 'Undefined'
};
const jsGlobalTypes = [
'Error', 'Object', 'Function', 'Array', 'TypedArray', 'Uint8Array',

Write Preview
Loading…
Cancel
Save