手机网站修改,手机设计软件有哪些,nike定制在哪个app,做个简单的网站Node-API的数据类型
napi_status
是一个枚举数据类型#xff0c;表示Node-API接口返回的状态信息。
每当调用一个Node-API函数#xff0c;都会返回该值#xff0c;表示操作成功与否的相关信息。
typedef enum {napi_ok,napi_invalid_arg,napi_object_expected,napi_stri…Node-API的数据类型
napi_status
是一个枚举数据类型表示Node-API接口返回的状态信息。
每当调用一个Node-API函数都会返回该值表示操作成功与否的相关信息。
typedef enum {napi_ok,napi_invalid_arg,napi_object_expected,napi_string_expected,napi_name_expected,napi_function_expected,napi_number_expected,napi_boolean_expected,napi_array_expected,napi_generic_failure,napi_pending_exception,napi_cancelled,napi_escape_called_twice,napi_handle_scope_mismatch,napi_callback_scope_mismatch,napi_queue_full,napi_closing,napi_bigint_expected,napi_date_expected,napi_arraybuffer_expected,napi_detachable_arraybuffer_expected,napi_would_deadlock, /* unused */napi_no_external_buffers_allowed,napi_cannot_run_js
} napi_status;napi_extended_error_info
一个结构体在调用函数不成功时存储了较为详细的错误信息。
typedef struct {const char *error_message;void *engine_reserved;uint32_t engine_error_code;napi_status error_code;
} napi_extended_error_info;napi_value
在C代码中表示一个JavaScript值。
napi_env 用于表示Node-API执行时的上下文Native侧函数入参并传递给函数中的Node-API接口。 退出Native侧插件时napi_env将失效该事件通过回调传递给napi_add_env_cleanup_hook和napi_set_instance_data。 禁止缓存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
该枚举类型定义了两个常量用于指定在何时释放线程安全函数的回调函数。
typedef enum {napi_tsfn_release,napi_tsfn_abort
} napi_threadsafe_function_release_mode;该值会传给napi_release_threadsafe_function。
napi_release_threadsafe_function(napi_threadsafe_function func,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_closingtsfn函数并不会被放入queue中。
napi_threadsafe_function_call_mode
该枚举类型定义了两个常量用于指定线程安全函数的调用模式。
数据结构如下所示
typedef enum {napi_tsfn_nonblocking,napi_tsfn_blocking
} napi_threadsafe_function_call_mode;napi_tsfn_nonblockingnapi_call_threadsafe_function是非阻塞的如果队列已满则返回napi_queue_full从而阻止数据添加到队列中。 napi_tsfn_blockingnapi_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值的类型信息。
typedef struct {uint64_t lower;uint64_t upper;
} 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。
基本用法如下
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决定了线程调度的优先级等级定义如下
typedef enum {napi_qos_background 0,napi_qos_utility 1,napi_qos_default 2,napi_qos_user_initiated 3,
} napi_qos_t;QoS等级适用场景napi_qos_background低等级用户不可见任务例如数据同步、备份。napi_qos_utility中低等级不需要立即看到响应效果的任务例如下载或导入数据。napi_qos_default默认napi_qos_user_initiated高等级用户触发并且可见进展例如打开文档。
事件循环模式
napi提供了运行底层事件循环的两种模式, 其定义如下
typedef enum {napi_event_mode_default 0,napi_event_mode_nowait 1,
} napi_event_mode;事件循环运行模式解释说明napi_event_mode_default阻塞式的运行底层事件循环直到循环中没有任何任务时退出事件循环。napi_event_mode_nowait非阻塞式的运行底层事件循环尝试去处理一个任务处理完之后退出事件循环如果事件循环中没有任务立刻退出事件循环。
支持的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_registernative模块注册接口。
生命周期相关
接口功能说明napi_open_handle_scope创建一个上下文环境使用。需要使用napi_close_handle_scope进行关闭。napi_close_handle_scope关闭传入的上下文环境关闭后全部在其中声明的引用都将被关闭。napi_open_escapable_handle_scope创建出一个可逃逸的handel scope可将范围内声明的值返回到父作用域。需要使用napi_close_escapable_handle_scope进行关闭。napi_close_escapable_handle_scope关闭传入的可逃逸的handel 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_create_typedarray通过现有的ArrayBuffer创建一个JS TypeArray。napi_create_dataview通过现有的ArrayBuffer创建一个JS DataView。napi_get_array_length获取array的length。napi_get_typedarray_info获取给定TypedArray的各种属性。napi_get_dataview_info获取给定DataView的各种属性。napi_is_array判断给定JS value是否为array。napi_set_element在给定Object的指定索引处设置元素。napi_get_element获取给定Object指定索引处的元素。napi_has_element若给定Object的指定索引处拥有属性获取该元素。napi_delete_element尝试删除给定Object的指定索引处的元素。
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_get_new_target获取构造函数调用的new.target。napi_define_class定义与C类相对应的JavaScript类。napi_new_instance通过给定的构造函数构建一个实例。
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_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_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指针。
扩展能力
接口功能说明napi_queue_async_work_with_qos将异步工作对象加到队列由底层根据传入的qos优先级去调度执行。napi_run_script_path运行指定abc文件。napi_load_module将abc文件作为模块加载返回模块的命名空间。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_run_event_loop触发底层的事件循环。napi_stop_event_loop停止底层的事件循环。
napi_queue_async_work_with_qos
napi_status napi_run_script_path(napi_env env,const char* abcPath,napi_value* result);用法同napi_queue_async_work但可以指定QoS等级。
napi_run_script_path
napi_status napi_run_script_path(napi_env env,const char* abcPath,napi_value* result);napi_load_module
napi_status napi_load_module(napi_env env,const char* path,napi_value* result);napi_create_object_with_properties
napi_status napi_create_object_with_properties(napi_env env,napi_value* result,size_t property_count,const napi_property_descriptor* properties);napi_create_object_with_named_properties
napi_status napi_create_object_with_named_properties(napi_env env,napi_value* result,size_t property_count,const char** keys,const napi_value* values);napi_coerce_to_native_binding_object
napi_status napi_coerce_to_native_binding_object(napi_env env,napi_value js_object,napi_native_binding_detach_callback detach_cb,napi_native_binding_attach_callback attach_cb,void* native_object,void* hint); napi_run_event_loop
napi_status napi_run_event_loop(napi_env env, napi_event_mode mode);napi_stop_event_loop
napi_status napi_stop_event_loop(napi_env env);环境生命周期
接口功能说明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用于获取加载项加载位置的绝对路径。
为了能让大家更好的学习鸿蒙HarmonyOS NEXT开发技术这边特意整理了《鸿蒙开发学习手册》共计890页希望对大家有所帮助https://qr21.cn/FV7h05
《鸿蒙开发学习手册》
如何快速入门https://qr21.cn/FV7h05
基本概念构建第一个ArkTS应用…… 开发基础知识https://qr21.cn/FV7h05
应用基础知识配置文件应用数据管理应用安全管理应用隐私保护三方应用调用管控机制资源分类与访问学习ArkTS语言…… 基于ArkTS 开发https://qr21.cn/FV7h05
Ability开发UI开发公共事件与通知窗口管理媒体安全网络与链接电话服务数据管理后台任务(Background Task)管理设备管理设备使用信息统计DFX国际化开发折叠屏系列…… 鸿蒙开发面试真题含参考答案https://qr18.cn/F781PH 鸿蒙开发面试大盘集篇共计319页https://qr18.cn/F781PH
1.项目开发必备面试题 2.性能优化方向 3.架构方向 4.鸿蒙开发系统底层方向 5.鸿蒙音视频开发方向 6.鸿蒙车载开发方向 7.鸿蒙南向开发方向