From b08c7321bd014ca8fe46aecf35eea66f2aea5b3b Mon Sep 17 00:00:00 2001
From: Cody Deckard <cjdeckard@gmail.com>
Date: Wed, 25 Oct 2017 12:11:10 -0700
Subject: [PATCH] internal: add emitExperimentalWarning function
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

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>
---
 lib/internal/util.js | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/lib/internal/util.js b/lib/internal/util.js
index c0050c930b4142..4b5fa21e7ac474 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,