目录

使用扩展的Node-API接口创建和销毁临界区作用域及访问字符串内容

Node-API扩展接口napi_open_critical_scope用于打开临界区作用域,napi_close_critical_scope用于关闭临界区作用域。

非临界接口不能在临界区作用域使用,且同一执行环境中只能打开一个临界区作用域。打开临界区会阻塞gc,长时间保持临界区打开状态可能会造成内存不足、卡顿等现象,建议仅在需要临界接口时打开临界区作用域,使用后应及时关闭。

场景介绍

调用临界接口前,必须通过napi_open_critical_scope打开临界区作用域,并在临界区作用域内进行调用。

关闭临界区作用域后,请勿使用临界接口及其返回结果,否则可能导致程序崩溃或数据损坏。

临界区作用域的打开、关闭及临界接口的使用

接口 描述 临界区作用域外执行的状态码
napi_open_critical_scope 打开临界区作用域 NA
napi_close_critical_scope 关闭临界区作用域 napi_generic_failure
napi_get_buffer_string_utf16_in_critical_scope 获取ArkTS String的UTF-16编码内存缓冲区数据 napi_generic_failure
  1. 当ArkTS String以UTF-16编码存储时,napi_get_buffer_string_utf16_in_critical_scope才能正确获取其内存缓冲区,否则该函数返回错误。

  2. napi_create_string_utf16和napi_create_string_utf8的功能是将输入数据以指定编码传递给虚拟机。这些函数不控制字符串在虚拟机的内部存储编码方式。

示例代码