目录

使用扩展的Node-API接口加速属性访问

从API 24版本开始,HarmonyOS提供了基于调用点缓存的快速属性访问接口。通过为每个调用点创建napi_callsite_info句柄,在重复访问相同键名属性时,可以缓存对象的结构信息,从而加速属性访问,显著提升属性访问性能。

  • 每个不同的调用点应创建独立的napi_callsite_info句柄,同一句柄可在多次调用中复用。
  • napi_callsite_info不支持跨线程使用,每个句柄只能在创建它的线程中使用。
  • 当不再需要时,必须调用napi_delete_callsite_info释放napi_callsite_info句柄。
  • napi_get_property_with_callsite_info和napi_set_property_with_callsite_info的info参数可以传入NULL,此时行为等同于普通的napi_get_property/napi_set_property。
  • napi_get_property_with_callsite_info和napi_set_property_with_callsite_info支持可为NULL的hit输出参数(bool*):true表示命中(快速路径),false表示未命中。

场景介绍

当需要对相同的属性键名进行大量重复的属性读写操作时(例如在热点循环中批量处理对象数组),使用调用点缓存可以提升性能。

性能特征:

适用场景:

不适用场景:

接口描述

接口 描述
napi_create_callsite_info 创建调用点信息句柄,用于缓存属性访问信息。
napi_delete_callsite_info 删除调用点信息句柄,释放关联的缓存资源。
napi_get_property_with_callsite_info 使用调用点信息快速获取对象属性值。
napi_set_property_with_callsite_info 使用调用点信息快速设置对象属性值。

示例代码