鸿蒙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 接口

相关推荐
右耳朵猫AI2 分钟前
Web前端周刊2026W36 | pnpm 12 Rust 重写、Remix 3 RC、Node.js 26.8.0、htmx 4.0 大版本
前端·rust·node.js
统计学小王子6 分钟前
数学建模国赛倒计时 2 天 ——《异常值的处理(R语言)》
开发语言·数学建模·r语言
lqj_本人8 分钟前
Flutter 鸿蒙实战:用 wakelock_plus 三方库给阅读页加上屏幕常亮
flutter·华为·harmonyos
平头哥~17 分钟前
Day 21 | animation 与 keyframes:把动画从 A 到 B 变成多点编排
前端·css·css3·css学习
z落落3 小时前
C# WinForm Socket 转串口设备服务器+Modbus CRC16校验+Socket 客户端
服务器·开发语言·c#
小灰灰搞电子9 小时前
Rust+Slint 实现动态消息提示框源码分享
开发语言·后端·rust
宿67410 小时前
vue3-包管理器
前端·vue.js
@PHARAOH10 小时前
WHAT - Remix 入门和基本实践:理解两套产物
前端·remix
传奇开心果编程10 小时前
【Rust入门知识点学与练】第21课:Trait 进阶 Advanced Traits
开发语言·学习·rust
新时代牛马10 小时前
字符设备驱动完整篇:从 cdev_add、file_operations 到chrdev_open 与排障
开发语言·python