napi_get_reference_value 函数

napi_get_reference_value 是 Node.js 的 N-API 中的一个函数，其作用是将一个 N-API 的引用转换为对应的 JavaScript 值。这个函数的原型如下：

napi_status napi_get_reference_value(napi_env env, napi_ref ref, napi_value* result);

参数说明：

- env：N-API 的环境对象。
- ref：N-API 引用。
- result：用于存储转换后的 JavaScript 值的指针。

函数返回值为一个枚举值 napi_status，表示函数执行的状态，如果状态为 napi_ok，则表示函数执行成功。

使用 napi_get_reference_value 函数时，需要先创建一个 N-API 的引用，然后将这个引用传给函数，函数就会将引用转换为对应的 JavaScript 值。这个函数主要用于在 C++ 中访问 JavaScript 对象或函数。

相关问题

napi_get_cb_info napi_get_reference_value(env, classRef_, &constructor); 函数中如何获取JS层的的参数

在 Node.js C++ Addon 中，我们可以通过 `napi_get_cb_info` 函数获取到当前函数被调用时的回调信息，并且从回调信息中获取到传入该函数的所有参数。具体来说，其函数签名如下：

napi_status napi_get_cb_info(napi_env env,
                             napi_callback_info cbinfo,
                             size_t* argc,
                             napi_value* argv,
                             napi_value* this_arg,
                             void** data);

其中，`env` 表示当前的 Node.js 运行环境，`cbinfo` 表示当前函数被调用时的回调信息，`argc` 表示传入该函数的参数个数，`argv` 数组则表示传入该函数的所有参数，`this_arg` 表示函数被调用时的 `this` 值，`data` 表示一个指向数据的指针，可以用来传递自定义的数据。

例如，我们可以通过以下代码获取到第一个参数的值：

napi_value firstArg;
napi_get_cb_info(env, cbinfo, &argc, argv, nullptr, nullptr);
napi_get_value_int32(env, argv[0], &firstArg);

这里，`napi_get_value_int32` 函数用于将 JS 层传入的第一个参数转换为 C++ 中的 `int32_t` 类型。

接下来，我们可以通过 `napi_get_reference_value` 函数获取到类的构造函数。例如，以下代码可以获取到 `MyClass` 类的构造函数：

napi_value constructor;
napi_status status = napi_get_reference_value(env, classRef_, &constructor);

这里，`classRef_` 表示 `MyClass` 类的 N-API 引用。

需要注意的是，在获取参数值和获取类的构造函数时，都需要先通过 `napi_get_cb_info` 函数获取参数个数和参数数组，以及类的 N-API 引用，否则会导致获取参数值或类的构造函数时出现错误。

openharmony的napi_create_int32、napi_get_reference_value、napi_call_function、NAPI_CALL_BASE、AsyncTask::Schedule参数介绍及使用注意

1. napi_create_int32: 用于创建一个 int32 类型的 JavaScript 数值。函数原型为：napi_status napi_create_int32(napi_env env, int32_t value, napi_value *result)。其中，env 表示当前的 napi 环境，value 表示要创建的 int32 类型的数值，result 用于存储创建的 JavaScript 数值。

2. napi_get_reference_value: 用于从一个 napi 引用中获取对应的 JavaScript 对象。函数原型为：napi_status napi_get_reference_value(napi_env env, napi_ref ref, napi_value *result)。其中，env 表示当前的 napi 环境，ref 表示要获取的引用对象，result 用于存储获取到的 JavaScript 对象。

3. napi_call_function: 用于调用一个 JavaScript 函数。函数原型为：napi_status napi_call_function(napi_env env, napi_value recv, napi_value func, size_t argc, const napi_value *argv, napi_value *result)。其中，env 表示当前的 napi 环境，recv 表示函数的接收者，func 表示要调用的 JavaScript 函数，argc 表示参数个数，argv 表示参数列表，result 用于存储函数调用的结果。

4. NAPI_CALL_BASE: 用于检查 napi 方法返回的错误码，如果出现错误则将错误信息打印到日志中。函数原型为：#define NAPI_CALL_BASE(env, call) \ do { \ napi_status status = (call); \ if (status != napi_ok) { \ const napi_extended_error_info* error_info = 0; \ napi_get_last_error_info((env), &error_info); \ const char* error_message = (error_info->error_message != NULL) ? \ error_info->error_message : "empty error message"; \ printf("NAPI_CALL_BASE failed at %s:%d status=%d, error_message=%s\n", \ __FILE__, __LINE__, status, error_message); \ } \ } while(0)

5. AsyncTask::Schedule: 用于将一个异步任务添加到事件循环中执行。函数原型为：napi_status AsyncTask::Schedule(napi_env env, AsyncTaskExecuteCallback execute, AsyncTaskCompleteCallback complete, void *data, napi_async_context *context)。其中，env 表示当前的 napi 环境，execute 表示异步任务的执行函数，complete 表示异步任务执行完成后的回调函数，data 表示异步任务的数据，context 表示异步任务的上下文。

使用注意：

1. napi_create_int32 和 napi_get_reference_value 的返回值应该被检查，以确保正确地创建和获取 JavaScript 对象。

2. 在调用 napi_call_function 之前，需要确保传入的参数正确，包括函数接收者、函数本身和参数列表。

3. 需要注意异步任务的执行时间，以免阻塞主线程。

4. 在使用 NAPI_CALL_BASE 宏时，需要注意错误信息的输出方式，可以根据需要进行修改。

5. 在使用 AsyncTask::Schedule 时，需要注意异步任务的数据，以确保异步任务可以正确地访问和修改数据。