提交 c4223eba 编写于 作者: H huangzhenghua

新增node-api 接口功能描述

issue: https://gitee.com/openharmony/docs/issues/I6AHBTSigned-off-by: Nhuangzhenghua <huangzhenghua3@huawei.com>
Change-Id: I092bef7bf6a5bfa9752ea06305d0e3067218a23a
上级 943e91d6
......@@ -13,113 +13,113 @@ OpenHarmony的Native API组件对Node-API的接口进行了重新实现,底层
## Native API组件扩展的符号列表
|符号类型|符号名|备注|
|符号类型|符号名|说明|
| --- | --- | --- |
|FUNC|napi_run_script_path|运行JavaScript文件|
|FUNC|napi_run_script_path|运行JavaScript文件|
**标准库中导出的符号列表**
|符号类型|符号名|备注|
|符号类型|符号名|说明|
| --- | --- | --- |
|FUNC|napi_module_register||
|FUNC|napi_get_last_error_info||
|FUNC|napi_throw||
|FUNC|napi_throw_error||
|FUNC|napi_throw_type_error||
|FUNC|napi_throw_range_error||
|FUNC|napi_is_error||
|FUNC|napi_create_error||
|FUNC|napi_create_type_error||
|FUNC|napi_create_range_error||
|FUNC|napi_get_and_clear_last_exception||
|FUNC|napi_is_exception_pending||
|FUNC|napi_fatal_error||
|FUNC|napi_open_handle_scope||
|FUNC|napi_close_handle_scope||
|FUNC|napi_open_escapable_handle_scope||
|FUNC|napi_close_escapable_handle_scope||
|FUNC|napi_escape_handle||
|FUNC|napi_create_reference||
|FUNC|napi_delete_reference||
|FUNC|napi_reference_ref||
|FUNC|napi_reference_unref||
|FUNC|napi_get_reference_value||
|FUNC|napi_create_array||
|FUNC|napi_create_array_with_length||
|FUNC|napi_create_arraybuffer||
|FUNC|napi_create_external||
|FUNC|napi_create_external_arraybuffer||
|FUNC|napi_create_object||
|FUNC|napi_create_symbol||
|FUNC|napi_create_typedarray||
|FUNC|napi_create_dataview||
|FUNC|napi_create_int32||
|FUNC|napi_create_uint32||
|FUNC|napi_create_int64||
|FUNC|napi_create_double||
|FUNC|napi_create_string_latin1||
|FUNC|napi_create_string_utf8||
|FUNC|napi_get_array_length||
|FUNC|napi_get_arraybuffer_info||
|FUNC|napi_get_prototype||
|FUNC|napi_get_typedarray_info||
|FUNC|napi_get_dataview_info||
|FUNC|napi_get_value_bool||
|FUNC|napi_get_value_double||
|FUNC|napi_get_value_external||
|FUNC|napi_get_value_int32||
|FUNC|napi_get_value_int64||
|FUNC|napi_get_value_string_latin1||
|FUNC|napi_get_value_string_utf8||
|FUNC|napi_get_value_uint32||
|FUNC|napi_get_boolean||
|FUNC|napi_get_global||
|FUNC|napi_get_null||
|FUNC|napi_get_undefined||
|FUNC|napi_coerce_to_bool||
|FUNC|napi_coerce_to_number||
|FUNC|napi_coerce_to_object||
|FUNC|napi_coerce_to_string||
|FUNC|napi_typeof||
|FUNC|napi_instanceof||
|FUNC|napi_is_array||
|FUNC|napi_is_arraybuffer||
|FUNC|napi_is_typedarray||
|FUNC|napi_is_dataview||
|FUNC|napi_is_date||
|FUNC|napi_strict_equals||
|FUNC|napi_get_property_names||
|FUNC|napi_set_property||
|FUNC|napi_get_property||
|FUNC|napi_has_property||
|FUNC|napi_delete_property||
|FUNC|napi_has_own_property||
|FUNC|napi_set_named_property||
|FUNC|napi_get_named_property||
|FUNC|napi_has_named_property||
|FUNC|napi_set_element||
|FUNC|napi_get_element||
|FUNC|napi_has_element||
|FUNC|napi_delete_element||
|FUNC|napi_define_properties||
|FUNC|napi_call_function||
|FUNC|napi_create_function||
|FUNC|napi_get_cb_info||
|FUNC|napi_get_new_target||
|FUNC|napi_new_instance||
|FUNC|napi_define_class||
|FUNC|napi_wrap||
|FUNC|napi_unwrap||
|FUNC|napi_remove_wrap||
|FUNC|napi_create_async_work||
|FUNC|napi_delete_async_work||
|FUNC|napi_queue_async_work||
|FUNC|napi_cancel_async_work||
|FUNC|napi_get_node_version||
|FUNC|napi_get_version||
|FUNC|napi_create_promise||
|FUNC|napi_resolve_deferred||
|FUNC|napi_reject_deferred||
|FUNC|napi_is_promise||
|FUNC|napi_run_script||
|FUNC|napi_get_uv_event_loop||
\ No newline at end of file
|FUNC|napi_module_register|napi native模块注册接口。|
|FUNC|napi_get_last_error_info|获取`napi_extended_error_info`结构体,其中包含最近一次出现的error信息。|
|FUNC|napi_throw|抛出一个js value。|
|FUNC|napi_throw_error|抛出一个带文本信息的js `Error`。|
|FUNC|napi_throw_type_error|抛出一个带文本信息的js `TypeError`。|
|FUNC|napi_throw_range_error|抛出一个带文本信息的js `RangeError`。|
|FUNC|napi_is_error|判断`napi_value`是否表示为一个error对象。|
|FUNC|napi_create_error|创建并获取一个带文本信息的js `Error`。|
|FUNC|napi_create_type_error|创建并获取一个带文本信息的js `TypeError`。|
|FUNC|napi_create_range_error|创建并获取一个带文本信息的js `RangeError`。|
|FUNC|napi_get_and_clear_last_exception|获取并清除最近一次出现的异常。|
|FUNC|napi_is_exception_pending|判断是否出现了异常。|
|FUNC|napi_fatal_error|引发致命错误以立即终止进程。|
|FUNC|napi_open_handle_scope|创建一个上下文环境使用。|
|FUNC|napi_close_handle_scope|关闭传入的上下文环境,关闭后,全部在其中声明的引用都将被关闭。|
|FUNC|napi_open_escapable_handle_scope|创建出一个可逃逸的handel scope,可将范围内声明的值返回到父作用域。|
|FUNC|napi_close_escapable_handle_scope|关闭传入的可逃逸的handel scope。|
|FUNC|napi_escape_handle|提升传入的js object的生命周期到其父作用域。|
|FUNC|napi_create_reference|为`Object`创建一个reference,以延长其生命周期。调用者需要自己管理reference生命周期。|
|FUNC|napi_delete_reference|删除传入的reference。|
|FUNC|napi_reference_ref|增加传入的reference的引用计数,并获取该计数。|
|FUNC|napi_reference_unref|减少传入的reference的引用计数,并获取该计数。|
|FUNC|napi_get_reference_value|获取与reference相关联的js `Object`。|
|FUNC|napi_create_array|创建并获取一个js `Array`。|
|FUNC|napi_create_array_with_length|创建并获取一个指定长度的js `Array`。|
|FUNC|napi_create_arraybuffer|创建并获取一个指定大小的js `ArrayBuffer`。|
|FUNC|napi_create_external|分配一个附加有外部数据的js value。|
|FUNC|napi_create_external_arraybuffer|分配一个附加有外部数据的js `ArrayBuffer`。|
|FUNC|napi_create_object|创建一个默认的js `Object`。|
|FUNC|napi_create_symbol|创建一个js `Symbol`。|
|FUNC|napi_create_typedarray|通过现有的`ArrayBuffer`创建一个js `TypeArray`。|
|FUNC|napi_create_dataview|通过现有的`ArrayBuffer`创建一个js `DataView`。|
|FUNC|napi_create_int32|通过一个C的`int32_t`数据创建js `Number`。|
|FUNC|napi_create_uint32|通过一个C的`uint32_t`数据创建js `Number`。|
|FUNC|napi_create_int64|通过一个C的`int64_t`数据创建js `Number`。|
|FUNC|napi_create_double|通过一个C的`double`数据创建js `Number`。|
|FUNC|napi_create_string_latin1|通过ISO-8859-1编码的C字符串数据创建js `String`。|
|FUNC|napi_create_string_utf8|通过UTF8编码的C字符串数据创建js `String`。|
|FUNC|napi_get_array_length|获取array的length。|
|FUNC|napi_get_arraybuffer_info|获取`ArrayBuffer`的底层data buffer及其长度。|
|FUNC|napi_get_prototype|获取给定js `Object``prototype`。|
|FUNC|napi_get_typedarray_info|获取给定`TypedArray`的各种属性。|
|FUNC|napi_get_dataview_info|获取给定`DataView`的各种属性。|
|FUNC|napi_get_value_bool|获取给定js `Boolean`对应的C bool值。|
|FUNC|napi_get_value_double|获取给定js `Number`对应的C double值。|
|FUNC|napi_get_value_external|获取先前通过napi_create_external()传递的外部数据指针。|
|FUNC|napi_get_value_int32|获取给定js `Number`对应的C int32值。|
|FUNC|napi_get_value_int64|获取给定js `Number`对应的C int64值。|
|FUNC|napi_get_value_string_latin1|获取给定js vaule对应的ISO-8859-1编码的字符串。|
|FUNC|napi_get_value_string_utf8|获取给定js vaule对应的UTF8编码的字符串。|
|FUNC|napi_get_value_uint32|获取给定js `Number`对应的C uint32值。|
|FUNC|napi_get_boolean|根据给定的C boolean值,获取js bool对象。|
|FUNC|napi_get_global|获取`global`对象。|
|FUNC|napi_get_null|获取`null`对象。|
|FUNC|napi_get_undefined|获取`undefined`对象。|
|FUNC|napi_coerce_to_bool|将给定的js value强转成js `Boolean`。|
|FUNC|napi_coerce_to_number|将给定的js value强转成js `Number`。|
|FUNC|napi_coerce_to_object|将给定的js value强转成js `Object`。|
|FUNC|napi_coerce_to_string|将给定的js value强转成js `String`。|
|FUNC|napi_typeof|获取给定js value的js type。|
|FUNC|napi_instanceof|判断给定object是否为给定constructor的实例。|
|FUNC|napi_is_array|判断给定js value是否为array。|
|FUNC|napi_is_arraybuffer|判断给定js value是否为`ArrayBuffer`。|
|FUNC|napi_is_typedarray|判断给定js value是否表示一个`TypedArray`。|
|FUNC|napi_is_dataview|判断给定js value是否表示一个`DataView`。|
|FUNC|napi_is_date|判断给定js value是否为js `Date`对象。|
|FUNC|napi_strict_equals|判断给定的两个js value是否严格相等。|
|FUNC|napi_get_property_names|以字符串数组的形式获取对象的可枚举属性的名称。|
|FUNC|napi_set_property|对给定`Object`设置属性。|
|FUNC|napi_get_property|获取给定`Object`的给定属性。|
|FUNC|napi_has_property|判断给定对象中是否存在给定属性。|
|FUNC|napi_delete_property|尝试从给定`Object`中删除给定`key`属性。|
|FUNC|napi_has_own_property|判断给定`Object`中是否有名为`key`的own property。|
|FUNC|napi_set_named_property|对给定`Object`设置一个给定名称的属性。|
|FUNC|napi_get_named_property|获取给定`Object`中指定名称的属性。|
|FUNC|napi_has_named_property|判断给定`Object`中是否有给定名称的属性。|
|FUNC|napi_set_element|在给定`Object`的指定索引处,设置元素。|
|FUNC|napi_get_element|获取给定`Object`指定索引处的元素。|
|FUNC|napi_has_element|若给定`Object`的指定索引处拥有属性,获取该元素。|
|FUNC|napi_delete_element|尝试删除给定`Object`的指定索引处的元素。|
|FUNC|napi_define_properties|批量的向给定`Object`中定义属性。|
|FUNC|napi_call_function|在Native方法中调用js function,即native call js。|
|FUNC|napi_create_function|创建native方法给js使用,以便于js call native。|
|FUNC|napi_get_cb_info|从给定的callback info中获取有关调用的详细信息,如参数和this指针。|
|FUNC|napi_get_new_target|获取构造函数调用的`new.target`。|
|FUNC|napi_new_instance|通过给定的构造函数,构建一个实例。|
|FUNC|napi_define_class|定义与C++类相对应的JavaScript类。|
|FUNC|napi_wrap|在js object上绑定一个native对象实例。|
|FUNC|napi_unwrap|从js object上获取先前绑定的native对象实例。|
|FUNC|napi_remove_wrap|从js object上获取先前绑定的native对象实例,并解除绑定。|
|FUNC|napi_create_async_work|创建一个异步工作对象。|
|FUNC|napi_delete_async_work|释放先前创建的异步工作对象。|
|FUNC|napi_queue_async_work|将异步工作对象加到队列,由底层去调度执行。|
|FUNC|napi_cancel_async_work|取消入队的异步任务。|
|FUNC|napi_get_node_version|获取node的版本信息。|
|FUNC|napi_get_version|获取Node运行时支持的最高 N-API 版本。|
|FUNC|napi_create_promise|创建一个延迟对象和js promise。|
|FUNC|napi_resolve_deferred|resolve与js promise对象关联的延迟函数。|
|FUNC|napi_reject_deferred|reject与js promise对象关联的延迟函数。|
|FUNC|napi_is_promise|判断给定js value是否为promise对象。|
|FUNC|napi_run_script|执行一段js代码。|
|FUNC|napi_get_uv_event_loop|获取当前libuv loop实例。|
\ No newline at end of file
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册