summaryrefslogtreecommitdiff
path: root/doc/api
diff options
context:
space:
mode:
authorMyles Borins <mylesborins@google.com>2017-09-10 04:58:50 +0200
committerMyles Borins <mylesborins@google.com>2017-09-12 17:34:51 +0200
commita10856a7d31f9b641bf330fe9edfa9728f4b1c78 (patch)
tree738810a5d44828fcd743593125bf5aca8a821ea1 /doc/api
parentc981483686be11980908ebebe77723ae95d05b86 (diff)
downloadandroid-node-v8-a10856a7d31f9b641bf330fe9edfa9728f4b1c78.tar.gz
android-node-v8-a10856a7d31f9b641bf330fe9edfa9728f4b1c78.tar.bz2
android-node-v8-a10856a7d31f9b641bf330fe9edfa9728f4b1c78.zip
2017-09-12, Version 8.5.0 (Current)
Notable Changes * build: * Snapshots are now re-enabled in V8 https://github.com/nodejs/node/pull/14875 * console: * Implement minimal `console.group()`. https://github.com/nodejs/node/pull/14910 * deps: * upgrade libuv to 1.14.1 https://github.com/nodejs/node/pull/14866 * update nghttp2 to v1.25.0 https://github.com/nodejs/node/pull/14955 * dns: * Add `verbatim` option to dns.lookup(). When true, results from the DNS resolver are passed on as-is, without the reshuffling that Node.js otherwise does that puts IPv4 addresses before IPv6 addresses. https://github.com/nodejs/node/pull/14731 * fs: * add fs.copyFile and fs.copyFileSync which allows for more efficient copying of files. https://github.com/nodejs/node/pull/15034 * inspector: * Enable async stack traces https://github.com/nodejs/node/pull/13870 * module: * Add support for ESM. This is currently behind the `--experimental-modules` flag and requires the .mjs extension. `node --experimental-modules index.mjs` https://github.com/nodejs/node/pull/14369 * napi: * implement promise https://github.com/nodejs/node/pull/14365 * os: * Add support for CIDR notation to the output of the networkInterfaces() method. https://github.com/nodejs/node/pull/14307 * perf_hooks: * An initial implementation of the Performance Timing API for Node.js. This is the same Performance Timing API implemented by modern browsers with a number of Node.js specific properties. The User Timing mark() and measure() APIs are implemented, as is a Node.js specific flavor of the Frame Timing for measuring event loop duration. https://github.com/nodejs/node/pull/14680 * tls: * multiple PFX in createSecureContext [#14793](https://github.com/nodejs/node/pull/14793) * Added new collaborators: * BridgeAR – Ruben Bridgewater PR-URL: https://github.com/nodejs/node/pull/15308
Diffstat (limited to 'doc/api')
-rw-r--r--doc/api/assert.md2
-rw-r--r--doc/api/console.md6
-rw-r--r--doc/api/fs.md4
-rw-r--r--doc/api/http2.md8
-rw-r--r--doc/api/n-api.md14
-rw-r--r--doc/api/perf_hooks.md88
6 files changed, 62 insertions, 60 deletions
diff --git a/doc/api/assert.md b/doc/api/assert.md
index 254d4faf98..504830826b 100644
--- a/doc/api/assert.md
+++ b/doc/api/assert.md
@@ -112,6 +112,8 @@ changes:
description: NaN is now compared using the [SameValueZero][] comparison.
- version: REPLACEME
pr-url: https://github.com/nodejs/node/pull/15001
+ - version: v8.5.0
+ pr-url: https://github.com/nodejs/node/pull/12142
description: Error names and messages are now properly compared
- version: v8.0.0
pr-url: https://github.com/nodejs/node/pull/12142
diff --git a/doc/api/console.md b/doc/api/console.md
index 0bd72cd776..9ccdad9998 100644
--- a/doc/api/console.md
+++ b/doc/api/console.md
@@ -290,7 +290,7 @@ values are concatenated. See [`util.format()`][] for more information.
### console.group([...label])
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
* `label` {any}
@@ -302,14 +302,14 @@ additional indentation.
### console.groupCollapsed()
<!-- YAML
- added: REPLACEME
+ added: v8.5.0
-->
An alias for [`console.group()`][].
### console.groupEnd()
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
Decreases indentation of subsequent lines by two spaces.
diff --git a/doc/api/fs.md b/doc/api/fs.md
index 3e8349ee92..0ae7fee6cb 100644
--- a/doc/api/fs.md
+++ b/doc/api/fs.md
@@ -752,7 +752,7 @@ operations. The specific constants currently defined are described in
## fs.copyFile(src, dest[, flags], callback)
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
* `src` {string|Buffer|URL} source filename to copy
@@ -795,7 +795,7 @@ fs.copyFile('source.txt', 'destination.txt', COPYFILE_EXCL, callback);
## fs.copyFileSync(src, dest[, flags])
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
* `src` {string|Buffer|URL} source filename to copy
diff --git a/doc/api/http2.md b/doc/api/http2.md
index b0ee912d4a..6f0f0b41ba 100644
--- a/doc/api/http2.md
+++ b/doc/api/http2.md
@@ -851,7 +851,7 @@ the client.
#### Event: 'continue'
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
Emitted when the server sends a `100 Continue` status, usually because
@@ -1257,7 +1257,7 @@ an `Http2Session` object. If no listener is registered for this event, an
#### Event: 'streamError'
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
* `socket` {http2.ServerHttp2Stream}
@@ -1317,7 +1317,7 @@ a given number of milliseconds set using `http2server.setTimeout()`.
#### Event: 'checkContinue'
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
* `request` {http2.Http2ServerRequest}
@@ -1422,7 +1422,7 @@ added: v8.4.0
#### Event: 'checkContinue'
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
* `request` {http2.Http2ServerRequest}
diff --git a/doc/api/n-api.md b/doc/api/n-api.md
index daac4c592f..e3d7dcce32 100644
--- a/doc/api/n-api.md
+++ b/doc/api/n-api.md
@@ -3185,7 +3185,7 @@ then by calling `napi_unwrap()` on the wrapper object.
### *napi_remove_wrap*
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
```C
napi_status napi_remove_wrap(napi_env env,
@@ -3399,7 +3399,7 @@ support it:
### napi_adjust_external_memory
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
```C
NAPI_EXTERN napi_status napi_adjust_external_memory(napi_env env,
@@ -3478,7 +3478,7 @@ deferred = NULL;
### napi_create_promise
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
```C
NAPI_EXTERN napi_status napi_create_promise(napi_env env,
@@ -3498,7 +3498,7 @@ This API creates a deferred object and a JavaScript promise.
### napi_resolve_deferred
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
```C
NAPI_EXTERN napi_status napi_resolve_deferred(napi_env env,
@@ -3521,7 +3521,7 @@ The deferred object is freed upon successful completion.
### napi_reject_deferred
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
```C
NAPI_EXTERN napi_status napi_reject_deferred(napi_env env,
@@ -3544,7 +3544,7 @@ The deferred object is freed upon successful completion.
### napi_is_promise
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
```C
NAPI_EXTERN napi_status napi_is_promise(napi_env env,
@@ -3564,7 +3564,7 @@ underlying JavaScript engine.
### napi_run_script
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
```C
NAPI_EXTERN napi_status napi_run_script(napi_env env,
diff --git a/doc/api/perf_hooks.md b/doc/api/perf_hooks.md
index f41caf6f53..bccc99c18e 100644
--- a/doc/api/perf_hooks.md
+++ b/doc/api/perf_hooks.md
@@ -1,6 +1,6 @@
# Performance Timing API
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
> Stability: 1 - Experimental
@@ -24,7 +24,7 @@ doSomeLongRunningProcess(() => {
## Class: Performance
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
The `Performance` provides access to performance metric data. A single
@@ -32,7 +32,7 @@ instance of this class is provided via the `performance` property.
### performance.clearFunctions([name])
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
* `name` {string}
@@ -42,7 +42,7 @@ Performance Timeline. If `name` is provided, removes entries with `name`.
### performance.clearMarks([name])
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
* `name` {string}
@@ -52,7 +52,7 @@ Performance Timeline. If `name` is provided, removes only the named mark.
### performance.clearMeasures([name])
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
* `name` {string}
@@ -63,7 +63,7 @@ Performance Timeline. If `name` is provided, removes only objects whose
### performance.getEntries()
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
* Returns: {Array}
@@ -73,7 +73,7 @@ with respect to `performanceEntry.startTime`.
### performance.getEntriesByName(name[, type])
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
* `name` {string}
@@ -87,7 +87,7 @@ equal to `name`, and optionally, whose `performanceEntry.entryType` is equal to
### performance.getEntriesByType(type)
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
* `type` {string}
@@ -99,7 +99,7 @@ is equal to `type`.
### performance.mark([name])
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
* `name` {string}
@@ -112,7 +112,7 @@ to mark specific significant moments in the Performance Timeline.
### performance.measure(name, startMark, endMark)
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
* `name` {string}
@@ -137,7 +137,7 @@ error will be thrown.
### performance.nodeFrame
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
* {PerformanceFrame}
@@ -147,7 +147,7 @@ for the event loop.
### performance.nodeTiming
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
* {PerformanceNodeTiming}
@@ -157,7 +157,7 @@ metrics for specific Node.js operational milestones.
### performance.now()
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
* Returns: {number}
@@ -166,7 +166,7 @@ Returns the current high resolution millisecond timestamp.
### performance.timeOrigin
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
* {number}
@@ -176,7 +176,7 @@ which all performance metric durations are measured.
### performance.timerify(fn)
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
* `fn` {Function}
@@ -210,12 +210,12 @@ wrapped();
## Class: PerformanceEntry
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
### performanceEntry.duration
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
* {number}
@@ -225,7 +225,7 @@ be meaningful for all Performance Entry types.
### performanceEntry.name
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
* {string}
@@ -234,7 +234,7 @@ The name of the performance entry.
### performanceEntry.startTime
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
* {number}
@@ -244,7 +244,7 @@ Performance Entry.
### performanceEntry.entryType
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
* {string}
@@ -254,7 +254,7 @@ The type of the performance entry. Current it may be one of: `'node'`, `'mark'`,
### performanceEntry.kind
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
* {number}
@@ -270,7 +270,7 @@ The value may be one of:
## Class: PerformanceNodeFrame extends PerformanceEntry
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
Provides timing details for the Node.js event loop.
@@ -301,14 +301,14 @@ current loop.
## Class: PerformanceNodeTiming extends PerformanceEntry
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
Provides timing details for Node.js itself.
### performanceNodeTiming.bootstrapComplete
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
* {number}
@@ -318,7 +318,7 @@ completed bootstrap.
### performanceNodeTiming.clusterSetupEnd
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
* {number}
@@ -327,7 +327,7 @@ The high resolution millisecond timestamp at which cluster processing ended.
### performanceNodeTiming.clusterSetupStart
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
* {number}
@@ -336,7 +336,7 @@ The high resolution millisecond timestamp at which cluster processing started.
### performanceNodeTiming.loopExit
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
* {number}
@@ -346,7 +346,7 @@ exited.
### performanceNodeTiming.loopStart
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
* {number}
@@ -356,7 +356,7 @@ started.
### performanceNodeTiming.moduleLoadEnd
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
* {number}
@@ -365,7 +365,7 @@ The high resolution millisecond timestamp at which main module load ended.
### performanceNodeTiming.moduleLoadStart
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
* {number}
@@ -374,7 +374,7 @@ The high resolution millisecond timestamp at which main module load started.
### performanceNodeTiming.nodeStart
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
* {number}
@@ -384,7 +384,7 @@ initialized.
### performanceNodeTiming.preloadModuleLoadEnd
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
* {number}
@@ -393,7 +393,7 @@ The high resolution millisecond timestamp at which preload module load ended.
### performanceNodeTiming.preloadModuleLoadStart
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
* {number}
@@ -402,7 +402,7 @@ The high resolution millisecond timestamp at which preload module load started.
### performanceNodeTiming.thirdPartyMainEnd
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
* {number}
@@ -412,7 +412,7 @@ ended.
### performanceNodeTiming.thirdPartyMainStart
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
* {number}
@@ -422,7 +422,7 @@ started.
### performanceNodeTiming.v8Start
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
* {number}
@@ -433,7 +433,7 @@ initialized.
## Class: PerformanceObserver(callback)
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
* `callback` {Function} A `PerformanceObserverCallback` callback function.
@@ -463,7 +463,7 @@ longer needed.
### Callback: PerformanceObserverCallback(list, observer)
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
* `list` {PerformanceObserverEntryList}
@@ -476,7 +476,7 @@ notified about new `PerformanceEntry` instances. The callback receives a
### Class: PerformanceObserverEntryList
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
The `PerformanceObserverEntryList` class is used to provide access to the
@@ -484,7 +484,7 @@ The `PerformanceObserverEntryList` class is used to provide access to the
#### performanceObserverEntryList.getEntries()
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
* Returns: {Array}
@@ -494,7 +494,7 @@ with respect to `performanceEntry.startTime`.
#### performanceObserverEntryList.getEntriesByName(name[, type])
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
* `name` {string}
@@ -508,7 +508,7 @@ equal to `name`, and optionally, whose `performanceEntry.entryType` is equal to
#### performanceObserverEntryList.getEntriesByType(type)
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
* `type` {string}
@@ -520,13 +520,13 @@ is equal to `type`.
### performanceObserver.disconnect()
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
Disconnects the `PerformanceObserver` instance from all notifications.
### performanceObserver.observe(options)
<!-- YAML
-added: REPLACEME
+added: v8.5.0
-->
* `options` {Object}
* `entryTypes` {Array} An array of strings identifying the types of