node-api: add warning for NAPI_EXPERIMENTAL

Author: miguelmarcondesf

src/js_native_api.h

@@ -536,6 +536,8 @@ node_api_post_finalizer(node_api_basic_env env,
                         void* finalize_data,
                         void* finalize_hint);
 
+#warning "NAPI_EXPERIMENTAL is enabled. Experimental features may be unstable."
+
 #endif  // NAPI_EXPERIMENTAL
 
 #if NAPI_VERSION >= 6

src/node_api.h

@@ -266,4 +266,10 @@ node_api_get_module_file_name(node_api_basic_env env, const char** result);
 
 EXTERN_C_END
 
+#ifdef NAPI_EXPERIMENTAL
+
+#warning "NAPI_EXPERIMENTAL is enabled. Experimental features may be unstable."
+
+#endif  // NAPI_EXPERIMENTAL
+
 #endif  // SRC_NODE_API_H_

test/addons/hello-world/binding.gyp

@@ -9,6 +9,12 @@
       'target_name': 'binding2',
       'sources': [ 'binding2.cc' ],
       'includes': ['../common.gypi'],
+    },
+    {
+      'target_name': 'binding_experimental',
+      'sources': [ 'binding_experimental.cc' ],
+      'includes': ['../common.gypi'],
+      'defines': [ 'NAPI_EXPERIMENTAL' ],
     }
   ]
 }

test/addons/hello-world/binding_experimental.cc

@@ -0,0 +1,17 @@
+#include <node_api.h>
+
+static napi_value Method(const napi_env env,
+       const napi_callback_info info) {
+  napi_value result;
+  napi_create_string_utf8(env, "world", NAPI_AUTO_LENGTH, &result);
+  return result;
+}
+
+static napi_value InitModule(napi_env env, napi_value exports) {
+  napi_value hello;
+  napi_create_function(env, "hello", NAPI_AUTO_LENGTH, Method, nullptr, &hello);
+  napi_set_named_property(env, exports, "hello", hello);
+  return exports;
+}
+
+NAPI_MODULE(NODE_GYP_MODULE_NAME, InitModule)

test/addons/hello-world/test.js

@@ -14,3 +14,7 @@ delete require.cache[bindingPath];
 const rebinding = require(bindingPath);
 assert.strictEqual(rebinding.hello(), 'world');
 assert.notStrictEqual(binding.hello, rebinding.hello);
+
+const binding_experimental = require(require.resolve(`./build/${common.buildType}/binding_experimental`));
+assert.strictEqual(binding_experimental.hello(), 'world');
+console.log('binding_experimental.hello() =', binding_experimental.hello());