鸿蒙Harmony开发实战:线程异步JS 机制总结

背景介绍

回调函数是 JavaScript 中常见的一种编程模式,它在异步编程中起到了重要作用。在 NAPI (Node.js API)中,回调函数也被广泛应用,用于处理各种异步操作,例如文件读写、网络请求等。按照触发源或目的线程分为 JS 线程、C++ 线程,按照回调方式分为同步回调、异步回调,本文重点介绍 C++ 线程异步回调 JS 的机制。

C++ 异步回调 JS 机制

机制一 Async Work

首先需要进行数据定义,如下所示

接着调用 napi_create_async_work 接口

机制二 Threadsafe Function

JS 函数只能被 JS 主线程调用。如果 native 创建的其他线程需要调用 JS 函数,则需要拿到 JS 主线程的 napi_env 来调用 N-API 函数。

若 native 创建的其他线程必须与 JS 主线程进行通信,线程安全函数 API 提供了 native 创建的其他线程调用 JS 函数的方法。

使用样例

回调函数定义,如下所示

应用调用

使用步骤

线程安全函数的使用步骤是,先 napi_create_threadsafe_function 创建函数引用, napi_call threadsafe_function 通过这个函数引用调用线程安全函数。

机制说明

napi create threadsafe_function 是通过创建 uv _async 实例 &async 并绑定 AsyncCb, 再在其他线程中调用 napi_call_threadsafe_function(tsfn) 后 (tsfn 数据结构包含&async),使用 uv_async_send(&async) 唤醒持有 async 的 JS 主线程消息队列,并调用 async 的回调 AsyncCb->call js_cb()。

注意事项

1.napi_release_threadsafe_function 最后一个参数为 napi_tsfn_abort 时,会立即关闭线程安全函数,导致 JS 主线程无法回调函数;

2.如果创建的线程安全函数的最大队列大小为 0,则 Napi_call_threadsafe_function()永远不会阻塞。

3.napi_call_threadsafe_function()不应该在 JS 线程的 napi_tsfn_blocking 中调用,因为如果队列满了,它可能会导致 JavaScript 线程死锁。

机制三 uv_queue_work

首先需要进行数据定义,如下所示

接着调用 uv_queue_work 接口

相关推荐
天平5 小时前
油猴脚本创建webworker踩坑记录
前端·javascript·typescript
原则猫6 小时前
前端基础大厦
前端
陈随易7 小时前
编程语言级别的Skill市场,AI Agent 的未来形态
前端·后端·程序员
SoaringHeart8 小时前
Flutter进阶:基于 EasyRefresh 的下拉刷新封装 n_easy_refresh_mixin.dart
前端·flutter
IT_陈寒10 小时前
Vite的热更新突然不香了,排查三小时差点砸键盘
前端·人工智能·后端
子兮曰11 小时前
Agency-Agents 深度解析:400+ AI 专家的"梦之队"如何重塑开发工作流
前端·后端·vibecoding
竹林81811 小时前
用 The Graph 查询链上数据实战:从手搓 RPC 到 Subgraph,我的 NFT 项目数据加载快了 10 倍
前端·javascript
妙码生花12 小时前
从 PHP 到 AI + Golang,程序员自救转型手记(十九):点选验证码代码逐行目检
前端·后端·go
Awu122712 小时前
⚡从零开发 Agent CLI(五)实现一个可治理、可扩展的工具系统
前端·人工智能·claude
咪库咪库咪13 小时前
Vue3-生命周期
前端