HarmonyOS:Node-API实现跨语言交互(2)Node-API支持的数据类型和接口

news/2025/3/16 22:30:29/文章来源:https://www.cnblogs.com/strengthen/p/18503983

★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★
➤博客园地址:为敢技术(https://www.cnblogs.com/strengthen/ )
➤GitHub地址:https://github.com/strengthen
➤原文地址:https://www.cnblogs.com/strengthen/p/18502733
➤如果链接不是为敢技术的博客园地址,则可能是爬取作者的文章。
➤原文已修改更新!强烈建议点击原文地址阅读!支持作者!支持原创!
★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★

Node-API的数据类型

napi_status

是一个枚举数据类型,表示Node-API接口返回的状态信息。

每当调用一个Node-API函数,都会返回该值,表示操作成功与否的相关信息。

  1. typedef enum {
  2. napi_ok,
  3. napi_invalid_arg,
  4. napi_object_expected,
  5. napi_string_expected,
  6. napi_name_expected,
  7. napi_function_expected,
  8. napi_number_expected,
  9. napi_boolean_expected,
  10. napi_array_expected,
  11. napi_generic_failure,
  12. napi_pending_exception,
  13. napi_cancelled,
  14. napi_escape_called_twice,
  15. napi_handle_scope_mismatch,
  16. napi_callback_scope_mismatch,
  17. napi_queue_full,
  18. napi_closing,
  19. napi_bigint_expected,
  20. napi_date_expected,
  21. napi_arraybuffer_expected,
  22. napi_detachable_arraybuffer_expected,
  23. napi_would_deadlock, /* unused */
  24. napi_no_external_buffers_allowed,
  25. napi_cannot_run_js
  26. } napi_status;

napi_extended_error_info

一个结构体,在调用函数不成功时存储了较为详细的错误信息。

 
 
  1. typedef struct {
  2. const char *error_message;
  3. void *engine_reserved;
  4. uint32_t engine_error_code;
  5. napi_status error_code;
  6. } napi_extended_error_info;

napi_value

napi_value是一个C的结构体指针,表示一个JavaScript对象的引用。napi_value持有了JS对象,同时,napi_value受handle_scope管理,scope中napi_value持有的JS对象不会被释放;出scope后,napi_value将失效,不再持有对应的JS对象。

napi_env

  • 用于表示Node-API执行时的上下文,Native侧函数入参,并传递给函数中的Node-API接口。

  • napi_env与JS线程绑定,JS线程退出后,napi_env将失效。

  • 禁止缓存napi_env,禁止在不同Worker中传递napi_env。

napi_threadsafe_function

napi_threadsafe_function用来创建一个线程安全的JavaScript函数,可以在不同的线程中调用。可以用于将异步操作的结果传递给JavaScript环境,例如从另一个线程中读取数据或执行计算密集型操作。此外,它还可以用于从JavaScript环境中调用C++代码中的函数,以便在另一个线程中执行。通过使用napi_threadsafe_function,可以实现JavaScript和C++之间的高效通信,同时保持线程安全性。

napi_threadsafe_function_release_mode

该枚举类型定义了两个常量,用于指定在何时释放线程安全函数的回调函数。

 
 
  1. typedef enum {
  2. napi_tsfn_release,
  3. napi_tsfn_abort
  4. } napi_threadsafe_function_release_mode;

该值会传给napi_release_threadsafe_function。

 
 
  1. napi_release_threadsafe_function(napi_threadsafe_function func,
  2. napi_threadsafe_function_release_mode mode);
  • mode值为napi_tsfn_release时:表示当前线程不再调用此tsfn。

  • mode值为napi_tsfn_abort时:表示除了当前线程,其他线程不能再调用此tsfn。

    如果设置为napi_tsfn_abort,利用napi_call_threadsafe_function接口调用此tsfn时将返回napi_closing,tsfn函数并不会被放入queue中。

napi_threadsafe_function_call_mode

该枚举类型定义了两个常量,用于指定线程安全函数的调用模式。

数据结构如下所示:

 
 
  1. typedef enum {
  2. napi_tsfn_nonblocking,
  3. napi_tsfn_blocking
  4. } napi_threadsafe_function_call_mode;
  • napi_tsfn_nonblocking:napi_call_threadsafe_function是非阻塞的,如果队列已满,则返回napi_queue_full,从而阻止数据添加到队列中。

  • napi_tsfn_blocking:napi_call_threadsafe_function是阻塞的,直至队列中有空间可用。

内存管理类型

Node-API包含以下内存管理类型:

napi_handle_scope

napi_handle_scope数据类型是用来管理JavaScript对象的生命周期的。它允许JavaScript对象在一定范围内保持活动状态,以便在JavaScript代码中使用。在创建napi_handle_scope时,所有在该范围内创建的JavaScript对象都会保持活动状态,直到结束。这样可以避免在JavaScript代码中使用已经被释放的对象,从而提高代码的可靠性和性能。

napi_escapable_handle_scope

  • 由napi_open_escapable_handle_scope接口创建,由napi_close_escapable_handle_scope接口关闭。

  • 表示一种特殊类型的句柄范围,用于将在escapable_handle_scope范围内创建的值返回给父scope。

  • 用于napi_escape_handle接口,将escape_handle_scope提升到JS对象,以便在外部作用域使用。

napi_ref

指向napi_value,允许用户管理JavaScript值的生命周期。

napi_type_tag

该结构体定义了一个包含两个无符号64位整数的类型标签,用于标识一个Node-API值的类型信息。

 
 
  1. typedef struct {
  2. uint64_t lower;
  3. uint64_t upper;
  4. } napi_type_tag;
  • 存储了两个无符号64位整数的128位值,用它来标记JavaScript对象,确保它们属于某种类型。

  • 比napi_instanceof更强的类型检查,如果对象的原型被操纵,napi_instanceof可能会报告误报。

  • type_tag与napi_wrap结合非常有用,因为它确保从包装对象检索的指针可以安全地转换为与先前应用于JavaScript对象的类型标记相对应的Native类型。

napi_async_cleanup_hook_handle

napi_async_cleanup_hook_handle用于注册异步操作的回调函数。它主要用于在异步操作完成或被取消时执行清理操作,例如释放资源或撤销操作。使用napi_async_cleanup_hook_handle可以确保在异步操作完成或被取消时,相关资源得到正确的释放和清理,从而避免内存泄漏等问题。

回调类型

Node-API包含以下回调类型:

napi_callback_info

Native侧获取JS侧参数信息,传递给napi_get_cb_info,用于获取JS侧入参信息。

napi_callback

表示用户定义的Native函数,暴露给JavaScript,即JS侧调用的接口;一般不在此callback中创建handle或者callback scope。

基本用法如下:

 
 
  1. typedef napi_value (*napi_callback)(napi_env, napi_callback_info);

napi_finalize

函数指针,用于传入napi_create_threadsafe_function和napi_set_instance_data接口。napi_finalize在对象被回收时会被调用。

napi_async_execute_callback

函数指针,用于napi_create_async_work接口。

  • 异步执行的Native函数,从工作池线程调用,可与主事件循环线程并行执行。

  • 函数实现中必须避免执行JavaScript或与JavaScript对象交互的Node-API调用。

  • Node-API调用可以在napi_async_complete_callback中执行。

napi_async_complete_callback

napi_async_complete_callback用于异步操作完成后的回调。当需要进行异步操作时,可以使用napi_create_async_work函数创建一个异步操作任务,并指定一个napi_async_complete_callback回调函数,在异步操作完成后会自动调用该回调函数,以便进行后续的处理。该回调函数的参数包括当前异步操作任务的状态和返回值等信息,可以根据这些信息进行相应的处理。

napi_threadsafe_function_call_js

函数指针,在主线程中与独立线程中的JavaScript代码进行交互,从而实现更加复杂的功能,用于napi_create_threadsafe_function(napi_env env,…,napi_threadsafe_function_call_js call_js_cb,...)接口。

napi_cleanup_hook

函数指针,用于napi_add_env_cleanup_hook接口,当环境销毁时会被执行。

napi_async_cleanup_hook

函数指针,用于napi_add_async_cleanup_hook接口,当环境销毁时会被执行。

调度优先级

QoS决定了线程调度的优先级,等级定义如下:

 
 
  1. typedef enum {
  2. napi_qos_background = 0,
  3. napi_qos_utility = 1,
  4. napi_qos_default = 2,
  5. napi_qos_user_initiated = 3,
  6. } napi_qos_t;
QoS等级适用场景
napi_qos_background 低等级,用户不可见任务,例如数据同步、备份。
napi_qos_utility 中低等级,不需要立即看到响应效果的任务,例如下载或导入数据。
napi_qos_default 默认。
napi_qos_user_initiated 高等级,用户触发并且可见进展,例如打开文档。

事件循环模式

napi提供了运行底层事件循环的两种模式, 其定义如下:

 
 
  1. typedef enum {
  2. napi_event_mode_default = 0,
  3. napi_event_mode_nowait = 1,
  4. } napi_event_mode;
事件循环运行模式解释说明
napi_event_mode_default 阻塞式的运行底层事件循环,直到循环中没有任何任务时退出事件循环。
napi_event_mode_nowait 非阻塞式的运行底层事件循环,尝试去处理一个任务,处理完之后退出事件循环;如果事件循环中没有任务,立刻退出事件循环。

线程安全任务优先级

napi提供了线程安全任务的优先级, 底层任务队列中的任务会根据其优先级被依次执行, 优先级的定义如下:

 
 
  1. typedef enum {
  2. napi_priority_immediate = 0,
  3. napi_priority_high = 1,
  4. napi_priority_low = 2,
  5. napi_priority_idle = 3,
  6. } napi_task_priority;
任务优先级解释说明
napi_priority_immediate 该优先级的级别最高。
napi_priority_high 该优先级的级别低于napi_priority_immediate。
napi_priority_low 该优先级的级别低于napi_priority_immediate和napi_priority_high。
napi_priority_idle 该优先级的级别最低。

支持的Node-API接口

Node-API接口在Node.js提供的原生模块基础上扩展,目前支持部分接口,具体可见下文。

异步安全线程相关

接口功能说明
napi_create_threadsafe_function 创建线程安全函数。
napi_get_threadsafe_function_context 获取线程安全函数中的context。
napi_call_threadsafe_function 调用线程安全函数。
napi_acquire_threadsafe_function 指示线程安全函数可以开始使用。
napi_release_threadsafe_function 指示线程安全函数将停止使用。
napi_ref_threadsafe_function 指示在主线程上运行的事件循环在线程安全函数被销毁之前不应退出。
napi_unref_threadsafe_function 指示在主线程上运行的事件循环可能会在线程安全函数被销毁之前退出。

buffer相关

接口功能说明
napi_create_buffer 创建并获取一个指定大小的JS Buffer。
napi_create_buffer_copy 创建并获取一个指定大小的JS Buffer,并以给定数据进行初始化。
napi_create_external_buffer 创建并获取一个指定大小的JS Buffer,并以给定数据进行初始化,该接口可为Buffer附带额外数据。
napi_get_buffer_info 获取JS Buffer底层data及其长度。
napi_is_buffer 判断给定JS value是否为Buffer对象。
napi_create_external_arraybuffer 分配一个附加有外部数据的JS ArrayBuffer。

string相关

接口功能说明
napi_create_string_utf16 通过UTF16编码的C字符串数据创建JS String。
napi_get_value_string_utf16 获取给定JS vaule对应的UTF16编码的字符串。
napi_create_string_latin1 通过ISO-8859-1编码的C字符串数据创建JS String。
napi_create_string_utf8 通过UTF8编码的C字符串数据创建JS String。
napi_get_value_string_latin1 获取给定JS vaule对应的ISO-8859-1编码的字符串。
napi_get_value_string_utf8 获取给定JS vaule对应的UTF8编码的字符串。

date相关

接口功能说明
napi_create_date 通过一个C的double数据创建JS Date。
napi_get_date_value 获取给定JS Date对应的C double值。
napi_is_date 判断给定JS value是否为JS Date对象。

arraybuffer相关

接口功能说明
napi_get_arraybuffer_info 获取ArrayBuffer的底层data buffer及其长度。
napi_is_arraybuffer 判断给定JS value是否为ArrayBuffer。
napi_detach_arraybuffer 分离给定ArrayBuffer的底层数据。
napi_is_detached_arraybuffer 判断给定的ArrayBuffer是否已被分离。
napi_create_arraybuffer 创建并获取一个指定大小的JS ArrayBuffer。

module相关

接口功能说明
napi_module_register native模块注册接口。

生命周期相关

接口功能说明
napi_open_handle_scope 创建一个上下文环境使用。需要使用napi_close_handle_scope进行关闭。
napi_close_handle_scope 关闭传入的上下文环境,关闭后,全部在其中声明的引用都将被关闭。
napi_open_escapable_handle_scope 创建出一个可逃逸的handle scope,可将范围内声明的值返回到父作用域。需要使用napi_close_escapable_handle_scope进行关闭。
napi_close_escapable_handle_scope 关闭传入的可逃逸的handle scope。
napi_escape_handle 提升传入的JS Object的生命周期到其父作用域。
napi_create_reference 为Object创建一个reference,以延长其生命周期。调用者需要自己管理reference生命周期。
napi_delete_reference 删除传入的reference。
napi_reference_ref 增加传入的reference的引用计数,并获取新的计数。
napi_reference_unref 减少传入的reference的引用计数,并获取新的计数。
napi_get_reference_value 获取与reference相关联的JS Object。
napi_add_finalizer 当js Object中的对象被垃圾回收时调用注册的napi_finalize回调。

promise相关

接口功能说明
napi_create_promise 创建一个promise对象。
napi_resolve_deferred 对promise关联的deferred对象进行resolve。
napi_reject_deferred 对promise关联的deferred对象进行reject。
napi_is_promise 判断给定napi_value是否为promise对象。

array相关

接口功能说明
napi_create_array 创建并获取一个JS Array。
napi_create_array_with_length 创建并获取一个指定长度的JS Array。
napi_get_array_length 获取array的length。
napi_is_array 判断给定JS value是否为array。
napi_set_element 在给定Object的指定索引处,设置元素。
napi_get_element 获取给定Object指定索引处的元素。
napi_has_element 若给定Object的指定索引处拥有属性,获取该元素。
napi_delete_element 尝试删除给定Object的指定索引处的元素。
napi_create_typedarray 通过现有的ArrayBuffer创建一个JS TypeArray。
napi_is_typedarray 判断给定JS value是否为TypeArray。
napi_get_typedarray_info 获取给定TypedArray的各种属性。
napi_create_dataview 通过现有的ArrayBuffer创建一个JS DataView。
napi_is_dataview 判断给定JS value是否为DataView。
napi_get_dataview_info 获取给定DataView的各种属性。

primitive相关

接口功能说明
napi_get_boolean 根据给定的C boolean值,获取JS Boolean对象。
napi_get_global 获取global对象。
napi_get_null 获取null对象。
napi_get_undefined 获取undefined对象。
napi_coerce_to_bool 将给定的JS value强转成JS Boolean。
napi_coerce_to_number 将给定的JS value强转成JS Number。
napi_coerce_to_object 将给定的JS value强转成JS Object。
napi_coerce_to_string 将给定的JS value强转成JS String。

class相关

接口功能说明
napi_new_instance 通过给定的构造函数,构建一个实例。
napi_get_new_target 获取构造函数调用的new.target。
napi_define_class 定义与C++类相对应的JavaScript类。
napi_wrap 在ArkTS对象上绑定一个Node-API模块对象实例。这个函数通常在将Node-API模块对象与ArkTS对象进行绑定时使用,以便在ArkTS中使用本地对象的方法和属性。
napi_unwrap 从ArkTS对象上获取之前绑定的Node-API模块对象实例。
napi_remove_wrap 从ArkTS对象上获取之前绑定的Node-API模块对象实例,并解除绑定。

object相关

接口功能说明
napi_get_prototype 获取给定JS Object的prototype。
napi_create_object 创建一个默认的JS Object。
napi_object_freeze 冻结给定的对象。
napi_object_seal 密封给定的对象。
napi_typeof 获取给定JS value的JS Type。
napi_instanceof 判断给定object是否为给定constructor的实例。
napi_type_tag_object 将tag指针的值与Object关联。
napi_check_object_type_tag 判断给定的tag指针是否被关联到了JS Object上。

bigint相关

接口功能说明
napi_create_bigint_int64 通过一个C的int64数据创建JS BigInt。
napi_create_bigint_uint64 通过一个C的uint64数据创建JS BigInt。
napi_create_bigint_words 通过一个C的uint64数组创建单个JS BigInt。
napi_get_value_bigint_int64 获取给定JS BigInt对应的C int64值。
napi_get_value_bigint_uint64 获取给定JS BigInt对应的C uint64值。
napi_get_value_bigint_words 获取给定JS BigInt对应的信息,包括符号位、64位小端序数组和数组中的元素个数。

异常和错误相关

接口功能说明
napi_throw 抛出一个JS value。
napi_throw_error 用于抛出一个带文本信息的ArkTS Error。
napi_throw_type_error 抛出一个带文本信息的JS TypeError。
napi_throw_range_error 抛出一个带文本信息的JS RangeError。
napi_is_error 判断napi_value是否表示为一个error对象。
napi_create_error 创建并获取一个带文本信息的JS Error。
napi_create_type_error 创建并获取一个带文本信息的JS TypeError。
napi_create_range_error 创建并获取一个带文本信息的JS RangeError。
napi_get_and_clear_last_exception 获取并清除最近一次出现的异常。
napi_is_exception_pending 判断是否出现了异常。
napi_fatal_error 引发致命错误以立即终止进程。
napi_get_last_error_info 获取napi_extended_error_info结构体,其中包含最近一次出现的error信息。
napi_fatal_exception 抛出一个致命异常并终止进程, 同时产生相应的crash日志。

属性相关

接口功能说明
napi_get_property_names 以字符串数组的形式获取对象的可枚举属性的名称。
napi_set_property 对给定Object设置属性。
napi_get_property 获取给定Object的给定属性。
napi_has_property 判断给定对象中是否存在给定属性。
napi_delete_property 尝试从给定Object中删除给定key属性。
napi_has_own_property 判断给定Object中是否有名为key的own property。
napi_set_named_property 对给定Object设置一个给定名称的属性。
napi_get_named_property 获取给定Object中指定名称的属性。
napi_has_named_property 判断给定Object中是否有给定名称的属性。
napi_define_properties 批量的向给定Object中定义属性。
napi_get_all_property_names 获取一个数组,其中包含此对象过滤后的属性名称。

异步任务相关

接口功能说明
napi_create_async_work 创建一个异步工作对象。
napi_delete_async_work 释放先前创建的异步工作对象。
napi_queue_async_work 将异步工作对象加到队列,由底层去调度执行。
napi_cancel_async_work 取消入队的异步任务。

自定义异步操作

接口功能说明
napi_async_init 创建一个异步资源上下文环境(不支持与async_hook相关能力)。
napi_make_callback 在异步资源上下文环境中回调JS函数(不支持与async_hook相关能力)。
napi_async_destroy 销毁先前创建的异步资源上下文环境(不支持与async_hook相关能力)。
napi_open_callback_scope 创建一个回调作用域(不支持与async_hook相关能力)。
napi_close_callback_scope 关闭先前创建的回调作用域(不支持与async_hook相关能力)。

判断给定的两个JS value是否严格相等

接口功能说明
napi_strict_equals 判断给定的两个JS value是否严格相等。

uv相关

接口功能说明
napi_get_uv_event_loop 获取当前libuv loop实例。

函数调用

接口功能说明
napi_call_function 在C/C++侧调用JS方法。
napi_get_cb_info 从给定的callback info中获取有关调用的详细信息,如参数和this指针。

扩展能力

Node-API组件扩展的符号列表

接口功能说明
napi_queue_async_work_with_qos 将异步工作对象加到队列,由底层根据传入的qos优先级去调度执行。
napi_run_script_path 运行指定abc文件。
napi_load_module 将abc文件作为模块加载,返回模块的命名空间。
napi_load_module_with_info 将abc文件作为模块加载,返回模块的命名空间, 可在新创建的ArkTS基础运行时环境中使用。
napi_create_object_with_properties 使用给定的napi_property_descriptor创建js Object。descriptor的键名必须为 string,且不可转为number。
napi_create_object_with_named_properties 使用给定的napi_value和键名创建js Object。键名必须为 string,且不可转为number。
napi_coerce_to_native_binding_object 强制将js Object和Native对象绑定。
napi_create_ark_runtime 创建基础运行时环境。
napi_destroy_ark_runtime 销毁基础运行时环境。
napi_run_event_loop 触发底层的事件循环。
napi_stop_event_loop 停止底层的事件循环。
napi_serialize 将ArkTS对象转换为native数据。
napi_deserialize 将native数据转为ArkTS对象。
napi_delete_serialization_data 删除序列化数据。
napi_call_threadsafe_function_with_priority 将指定优先级和入队方式的任务投递到ArkTS主线程。
napi_is_sendable 判断给定JS value是否是Sendable的。
napi_define_sendable_class 创建一个sendable类。
napi_create_sendable_object_with_properties 使用给定的napi_property_descriptor创建一个sendable对象。
napi_create_sendable_array 创建一个sendable数组。
napi_create_sendable_array_with_length 创建一个指定长度的sendable数组。
napi_create_sendable_arraybuffer 创建一个sendable ArrayBuffer。
napi_create_sendable_typedarray 创建一个sendable TypedArray。
napi_wrap_sendable 包裹一个native实例到ArkTS对象中。
napi_wrap_sendable_with_size 包裹一个native实例到ArkTS对象中并指定大小。
napi_unwrap_sendable 获取ArkTS对象包裹的native实例。
napi_remove_wrap_sendable 移除并获取ArkTS对象包裹的native实例。

napi_queue_async_work_with_qos

 
 
  1. napi_status napi_queue_async_work_with_qos(napi_env env,
  2. napi_async_work work,
  3. napi_qos_t qos);

用法同napi_queue_async_work,但可以指定QoS等级。

napi_run_script_path

 
 
  1. napi_status napi_run_script_path(napi_env env,
  2. const char* abcPath,
  3. napi_value* result);

napi_load_module

 
 
  1. napi_status napi_load_module(napi_env env,
  2. const char* path,
  3. napi_value* result);

napi_create_object_with_properties

 
 
  1. napi_status napi_create_object_with_properties(napi_env env,
  2. napi_value* result,
  3. size_t property_count,
  4. const napi_property_descriptor* properties);

napi_create_object_with_named_properties

 
 
  1. napi_status napi_create_object_with_named_properties(napi_env env,
  2. napi_value* result,
  3. size_t property_count,
  4. const char** keys,
  5. const napi_value* values);

napi_coerce_to_native_binding_object

 
 
  1. napi_status napi_coerce_to_native_binding_object(napi_env env,
  2. napi_value js_object,
  3. napi_native_binding_detach_callback detach_cb,
  4. napi_native_binding_attach_callback attach_cb,
  5. void* native_object,
  6. void* hint);

napi_run_event_loop

 
 
  1. napi_status napi_run_event_loop(napi_env env, napi_event_mode mode);

napi_stop_event_loop

 
 
  1. napi_status napi_stop_event_loop(napi_env env);

napi_serialize

 
 
  1. napi_status napi_serialize(napi_env env,
  2. napi_value object,
  3. napi_value transfer_list,
  4. napi_value clone_list,
  5. void** result);

napi_deserialize

 
 
  1. napi_status napi_deserialize(napi_env env, void* buffer, napi_value* object);

napi_delete_serialization_data

 
 
  1. napi_status napi_delete_serialization_data(napi_env env, void* buffer);

napi_call_threadsafe_function_with_priority

 
 
  1. napi_status napi_call_threadsafe_function_with_priority(napi_threadsafe_function func,
  2. void *data,
  3. napi_task_priority priority,
  4. bool isTail);

napi_is_sendable

 
 
  1. napi_status napi_is_sendable(napi_env env, napi_value value, bool* result);

napi_define_sendable_class

 
 
  1. napi_status napi_define_sendable_class(napi_env env,
  2. const char* utf8name,
  3. size_t length,
  4. napi_callback constructor,
  5. void* data,
  6. size_t property_count,
  7. const napi_property_descriptor* properties,
  8. napi_value parent,
  9. napi_value* result);

napi_create_sendable_object_with_properties

 
 
  1. napi_status napi_create_sendable_object_with_properties(napi_env env,
  2. size_t property_count,
  3. const napi_property_descriptor* properties,
  4. napi_value* result);

napi_create_sendable_array

 
 
  1. napi_status napi_create_sendable_array(napi_env env, napi_value* result);

napi_create_sendable_array_with_length

 
 
  1. napi_status napi_create_sendable_array_with_length(napi_env env, size_t length, napi_value* result);

napi_create_sendable_arraybuffer

 
 
  1. napi_status napi_create_sendable_arraybuffer(napi_env env, size_t byte_length, void** data, napi_value* result);

napi_create_sendable_typedarray

 
 
  1. napi_status napi_create_sendable_typedarray(napi_env env,
  2. napi_typedarray_type type,
  3. size_t length,
  4. napi_value arraybuffer,
  5. size_t byte_offset,
  6. napi_value* result);

napi_wrap_sendable

 
 
  1. napi_status napi_wrap_sendable(napi_env env,
  2. napi_value js_object,
  3. void* native_object,
  4. napi_finalize finalize_cb,
  5. void* finalize_hint);

napi_wrap_sendable_with_size

 
 
  1. napi_status napi_wrap_sendable_with_size(napi_env env,
  2. napi_value js_object,
  3. void* native_object,
  4. napi_finalize finalize_cb,
  5. void* finalize_hint,
  6. size_t native_binding_size);

napi_unwrap_sendable

 
 
  1. napi_status napi_unwrap_sendable(napi_env env, napi_value js_object, void** result);

napi_remove_wrap_sendable

 
 
  1. napi_status napi_remove_wrap_sendable(napi_env env, napi_value js_object, void** result);

环境生命周期

接口功能说明
napi_set_instance_data 绑定与当前运行的环境相关联的数据项。
napi_get_instance_data 检索与当前运行的环境相关联的数据项。

对象生命周期管理

接口功能说明
napi_add_env_cleanup_hook 注册环境清理钩子函数。
napi_remove_env_cleanup_hook 取消环境清理钩子函数。
napi_add_async_cleanup_hook 注册清理异步钩子函数。
napi_remove_async_cleanup_hook 取消清理异步钩子函数。

ArkTS基础运行时环境

接口功能说明
napi_create_ark_runtime 创建基础运行时环境
napi_destroy_ark_runtime 销毁基础运行时环境

其他实用工具

接口功能说明
node_api_get_module_file_name 用于获取加载项加载位置的绝对路径。

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.hqwc.cn/news/822316.html

如若内容造成侵权/违法违规/事实不符,请联系编程知识网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

【小记】探探学习平台的字体混淆

这篇笔记主要记录了个人对某学习平台字体混淆(防复制)的基本分析和反混淆思路。字体混淆有时候也被用作反爬机制。正在某学习平台做题,想着把题目复制出来和搜索娘深入探讨一下,却发现:嗯?怎么是一坨火星文? 实际上有好几个学习平台都引入了这种字体混淆机制以防止复制,…

KEIL闪退

现象:1.KEIL使用正常,突然出现打开报错,确认后闪退2.打开,在点击project想新建工程时,程序闪退解决办法1.Windows+R 进入注册表2.如图,删除除第一个外的其余Project条目(第一个好像也删不掉)问题解决!

C# 字符串内插

代码 // 字符串内插 Console.Write("字符串内插打印:"); Console.WriteLine($"Hello,{aFriend}");输出若是本人原创文章,请标明:本文来自博客园,作者:huiy_小溪,转载请注明原文链接:https://www.cnblogs.com/huiy/p/18503945。反之,请标明原创作者…

C# 定义一个变量 (2)

代码 // 向控制台打印hello,world! Console.WriteLine("Hello, World!"); // 定义一个变量来进行输出 String aFriend = "Bill"; Console.WriteLine("定义变量后打印:{0}", aFriend);输出若是本人原创文章,请标明:本文来自博客园,作者:huiy…

Free5GC源码研究(7) - NSSF研究

本文研究 Network Slice Selection Function(NSSF)主要实现的功能NSSF的概念 NSSF,也就是网络切片选择功能,负责根据用户请求和网络的配置来选择最合适的网络切片实例(Network Slice Instance, NSI)来服务用户设备。 所谓网络切片,是5G核心网的重要概念,允许运营商在同…

Windows11 24H2系统跳过硬件检测安装

1、下载Windows11系统镜像访问微软官网地址

HarmonyOS:Node-API实现跨语言交互(1)Node-API简介

★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★➤博客园地址:为敢技术(https://www.cnblogs.com/strengthen/ )➤GitHub地址:https://github.com/strengthen➤原文地址:https://www.cnblogs.com/strengthen/p/18503923➤如果链接不是为敢技术的博客园…

如何把一个python列表(有很多个元素)变成一个excel表格的第一列?

大家好,我是Python进阶者。 一、前言 前几天在Python最强王者群有个叫【麦当】的粉丝问了一个关于Python如何把一个python列表(有很多个元素)变成一个excel表格的第一列的问题,这里拿出来给大家分享下,一起学习。二、解决过程 这里给出【dcpeng】和【德善堂小儿推拿-瑜亮老师…

vsftp的三种用户详解

vsfp上有三种用户类型: annoymous 匿名用户 local_user 本地用户 virtual_user 虚拟用户 1、使用匿名用户 不需要认证 主配置文件中配置:anonymous_enable=YES 2、使用本地用户 本地用户,就是linux上的系统用户,满足下面两点就可以使用。 1、用户的bash是/bin/bash 2、主配…

USB协议详解第21讲(USB包-令牌类包)

1.令牌类包的分类 令牌类包有SETUP令牌包、IN令牌包、OUT令牌包。 2.令牌类包的组成 我们今天看令牌类包的详细结构,令牌包的内容由PID域+地址域+5bit CRC域,下图为令牌类包包各个域和抓包协议的对应图。3.令牌类包的功能 所有令牌包都是主机发起的,作用就是告诉设备主机要干…

Vmware关于桥接网络【关于安装虚拟机】

桥接网络:在你当前网络环境下,再分配一个ip地址 桥接就是让虚拟机和你的宿主机处于同一个局域网段 网络地址转换:NAT就是在你宿主机的网络环境下 再生成一个虚拟局域网,和宿主机不是同一个网段的 主机模式:虚拟机就是单机模式了,无法和他人通信