0
0
mirror of https://github.com/nodejs/node.git synced 2024-12-01 16:10:02 +01:00
nodejs/doc/api
Beth Griggs 372c7cc3c2
2020-04-21, Version 14.0.0 (Current)
Deprecations:

- (SEMVER-MAJOR) crypto: move pbkdf2 without digest to EOL
  (James M Snell) [#31166](https://github.com/nodejs/node/pull/31166)
- (SEMVER-MAJOR) fs: deprecate closing FileHandle on garbage collection
  (James M Snell) [#28396](https://github.com/nodejs/node/pull/28396)
- (SEMVER-MAJOR) http: move OutboundMessage.prototype.flush to EOL
  (James M Snell) [#31164](https://github.com/nodejs/node/pull/31164)
- (SEMVER-MAJOR) lib: move GLOBAL and root aliases to EOL
  (James M Snell) [#31167](https://github.com/nodejs/node/pull/31167)
- (SEMVER-MAJOR) os: move tmpDir() to EOL
  (James M Snell)[#31169](https://github.com/nodejs/node/pull/31169)
- (SEMVER-MAJOR) src: remove deprecated wasm type check
  (Clemens Backes) [#32116](https://github.com/nodejs/node/pull/32116)
- (SEMVER-MAJOR) stream: move \_writableState.buffer to EOL
  (James M Snell) [#31165](https://github.com/nodejs/node/pull/31165)
- (SEMVER-MINOR) doc: deprecate process.mainModule
  (Antoine du HAMEL) [#32232](https://github.com/nodejs/node/pull/32232)
- (SEMVER-MINOR) doc: deprecate process.umask() with no arguments
  (Colin Ihrig) [#32499](https://github.com/nodejs/node/pull/32499)

ECMAScript Modules - Experimental Warning Removal:

- module: remove experimental modules warning
  (Guy Bedford) [#31974](https://github.com/nodejs/node/pull/31974)

In Node.js 13 we removed the need to include the --experimental-modules
flag, but when running EcmaScript Modules in Node.js, this would still
result in a warning ExperimentalWarning: The ESM module loader is
experimental.

As of Node.js 14 there is no longer this warning when using ESM in
Node.js. However, the ESM implementation in Node.js remains
experimental. As per our stability index: “The feature is not subject
to Semantic Versioning rules. Non-backward compatible changes or
removal may occur in any future release.” Users should be cautious when
using the feature in production environments.

Please keep in mind that the implementation of ESM in Node.js differs
from the developer experience you might be familiar with. Most
transpilation workflows support features such as optional file
extensions or JSON modules that the Node.js ESM implementation does not
support. It is highly likely that modules from transpiled environments
will require a certain degree of refactoring to work in Node.js. It is
worth mentioning that many of our design decisions were made with two
primary goals. Spec compliance and Web Compatibility. It is our belief
that the current implementation offers a future proof model to
authoring ESM modules that paves the path to Universal JavaScript.
Please read more in our documentation.

The ESM implementation in Node.js is still experimental but we do believe
that we are getting very close to being able to call ESM in Node.js
“stable”. Removing the warning is a huge step in that direction.

New V8 ArrayBuffer API:

* **src**: migrate to new V8 ArrayBuffer API
  (Thang Tran) [#30782](https://github.com/nodejs/node/pull/30782)

Multiple ArrayBuffers pointing to the same base address are no longer
allowed by V8. This may impact native addons.

Toolchain and Compiler Upgrades:

- (SEMVER-MAJOR) build: update macos deployment target to 10.13 for 14.x
  (AshCripps)[#32454](https://github.com/nodejs/node/pull/32454)
- (SEMVER-MAJOR) doc: update cross compiler machine for Linux armv7
  (Richard Lau) [#32812](https://github.com/nodejs/node/pull/32812)
- (SEMVER-MAJOR) doc: update Centos/RHEL releases use devtoolset-8
  (Richard Lau) [#32812](https://github.com/nodejs/node/pull/32812)
- (SEMVER-MAJOR) doc: remove SmartOS from official binaries
  (Richard Lau) [#32812](https://github.com/nodejs/node/pull/32812)
- (SEMVER-MAJOR) win: block running on EOL Windows versions
  (João Reis) [#31954](https://github.com/nodejs/node/pull/31954)

It is expected that there will be an ABI mismatch on ARM between the
Node.js binary and native addons. Native addons are only broken if they
interact with `std::shared_ptr`. This is expected to be fixed in a
later version of Node.js 14.
- [#30786](https://github.com/nodejs/node/issues/30786)

Update to V8 8.1:

- (SEMVER-MAJOR) deps: update V8 to 8.1.307.20
  (Matheus Marchini) [#32116](https://github.com/nodejs/node/pull/32116)

Other Notable Changes:

- cli, report: move --report-on-fatalerror to stable
  (Colin Ihrig) [#32496](https://github.com/nodejs/node/pull/32496)
- deps: upgrade to libuv 1.37.0
  (Colin Ihrig) [#32866](https://github.com/nodejs/node/pull/32866)
- fs: add fs/promises alias module
  (Gus Caplan) [#31553](https://github.com/nodejs/node/pull/31553)

PR-URL: https://github.com/nodejs/node/pull/32181
2020-04-21 15:50:14 +01:00
..
addons.md doc: update context-aware section of addon doc 2020-03-31 10:22:12 -07:00
assert.md 2020-04-21, Version 14.0.0 (Current) 2020-04-21 15:50:14 +01:00
async_hooks.md doc: improve AsyncLocalStorage sample 2020-04-13 18:46:45 +02:00
buffer.md doc: document buffer.from returns internal pool buffer 2020-04-13 18:39:12 +02:00
child_process.md 2020-04-21, Version 14.0.0 (Current) 2020-04-21 15:50:14 +01:00
cli.md 2020-04-21, Version 14.0.0 (Current) 2020-04-21 15:50:14 +01:00
cluster.md
console.md
crypto.md 2020-04-21, Version 14.0.0 (Current) 2020-04-21 15:50:14 +01:00
debugger.md doc: reword possessive form of Node.js in debugger.md 2020-02-17 17:32:53 -08:00
deprecations.md 2020-04-21, Version 14.0.0 (Current) 2020-04-21 15:50:14 +01:00
dgram.md doc: clarify listening event 2020-04-07 20:31:40 +02:00
dns.md 2020-04-14, Version 13.13.0 (Current) 2020-04-14 20:22:41 +02:00
documentation.md doc: add link to sem-ver info 2020-03-02 04:07:33 +00:00
domain.md
embedding.md 2020-04-21, Version 14.0.0 (Current) 2020-04-21 15:50:14 +01:00
errors.md 2020-04-21, Version 14.0.0 (Current) 2020-04-21 15:50:14 +01:00
esm.md doc: missing brackets 2020-04-17 12:19:39 -04:00
events.md doc: add unreachable code on events example 2020-04-05 20:45:29 +02:00
fs.md 2020-04-21, Version 14.0.0 (Current) 2020-04-21 15:50:14 +01:00
globals.md
http2.md doc: fix typo in http2 docs 2020-03-30 09:35:21 +02:00
http.md doc: remove warning from response.writeHead 2020-04-13 23:36:54 +02:00
https.md
index.md doc: add basic embedding example documentation 2020-03-21 10:58:25 +01:00
inspector.md
intl.md
modules.md module: path-only CJS exports extension searching 2020-03-31 20:39:01 -06:00
n-api.md n-api: detect deadlocks in thread-safe function 2020-04-19 10:07:00 -07:00
net.md doc: improve net docs 2020-04-15 14:40:42 +02:00
os.md doc: fix os.version() Windows API 2020-03-12 20:43:34 -04:00
path.md doc: use uppercase on windows path 2020-03-29 22:43:53 +02:00
perf_hooks.md 2020-04-14, Version 13.13.0 (Current) 2020-04-14 20:22:41 +02:00
policy.md doc: remove personal pronoun usage in policy.md 2020-03-09 19:47:29 -07:00
process.md 2020-04-21, Version 14.0.0 (Current) 2020-04-21 15:50:14 +01:00
punycode.md
querystring.md
readline.md doc: updated YAML version representation in readline.md 2020-02-25 13:53:22 -08:00
repl.md
report.md src,cli: support compact (one-line) JSON reports 2020-03-17 08:42:41 -07:00
stream.md 2020-04-21, Version 14.0.0 (Current) 2020-04-21 15:50:14 +01:00
string_decoder.md doc: add support encoding link on string_decoder.md 2020-03-11 17:06:13 +01:00
synopsis.md
timers.md
tls.md 2020-03-04 Version 13.10.0 (Current) 2020-03-04 09:53:11 -08:00
tracing.md
tty.md
url.md doc: remove em dashes 2020-03-05 22:25:42 -08:00
util.md 2020-04-21, Version 14.0.0 (Current) 2020-04-21 15:50:14 +01:00
v8.md
vm.md doc: improve wording in vm.md 2020-03-24 10:24:37 -07:00
wasi.md wasi: add returnOnExit option 2020-03-08 11:05:23 -04:00
worker_threads.md 2020-04-14, Version 13.13.0 (Current) 2020-04-14 20:22:41 +02:00
zlib.md doc: fix typo in zlib.md 2020-04-20 18:54:46 -05:00