diff options
author | Cody Deckard <cjdeckard@gmail.com> | 2017-10-25 12:11:10 -0700 |
---|---|---|
committer | Michaël Zasso <targos@protonmail.com> | 2017-11-23 15:10:11 +0100 |
commit | b08c7321bd014ca8fe46aecf35eea66f2aea5b3b (patch) | |
tree | 838fcb26d39bffae014b7d3904e2b1a0f4a32f79 /lib | |
parent | e5d4aeb6ac37385e7aaa90020ea786be126a827a (diff) | |
download | android-node-v8-b08c7321bd014ca8fe46aecf35eea66f2aea5b3b.tar.gz android-node-v8-b08c7321bd014ca8fe46aecf35eea66f2aea5b3b.tar.bz2 android-node-v8-b08c7321bd014ca8fe46aecf35eea66f2aea5b3b.zip |
internal: add emitExperimentalWarning function
Adds a new emitExperimentalWarning function to internal/util to warn
users that they are using an experimental feature and that feature can
change at any time.
PR-URL: https://github.com/nodejs/node/pull/16497
Refs: https://github.com/nodejs/node/issues/9036
Reviewed-By: Michael Dawson <michael_dawson@ca.ibm.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Ruben Bridgewater <ruben@bridgewater.de>
Reviewed-By: Michaël Zasso <targos@protonmail.com>
Diffstat (limited to 'lib')
-rw-r--r-- | lib/internal/util.js | 11 |
1 files changed, 11 insertions, 0 deletions
diff --git a/lib/internal/util.js b/lib/internal/util.js index c0050c930b..4b5fa21e7a 100644 --- a/lib/internal/util.js +++ b/lib/internal/util.js @@ -15,6 +15,8 @@ const { const noCrypto = !process.versions.openssl; +const experimentalWarnings = new Set(); + function isError(e) { return objectToString(e) === '[object Error]' || e instanceof Error; } @@ -127,6 +129,14 @@ function normalizeEncoding(enc) { } } +function emitExperimentalWarning(feature) { + if (experimentalWarnings.has(feature)) return; + const msg = `${feature} is an experimental feature. This feature could ` + + 'change at any time'; + experimentalWarnings.add(feature); + process.emitWarning(msg, 'ExperimentalWarning'); +} + function filterDuplicateStrings(items, low) { const map = new Map(); for (var i = 0; i < items.length; i++) { @@ -297,6 +307,7 @@ module.exports = { createClassWrapper, decorateErrorStack, deprecate, + emitExperimentalWarning, filterDuplicateStrings, getConstructorOf, isError, |