JavaScript 兼容性 | AIUI | Rokid

AIUI 运行时使用 QuickJS JavaScript 引擎。

JavaScript 兼容性

AIUI 运行时使用 QuickJS JavaScript 引擎。

QuickJS 是一个轻量级且完全支持 ES2023 规范的 JavaScript 引擎。了解它的特性和限制,有助于编写更健壮的智能体代码。

支持的 ECMAScript 特性

QuickJS 提供了非常现代的 JavaScript 语法支持,你可以在智能体开发中安全地使用以下特性:

1. 异步编程 (Async / Await)

原生支持 Promise 和 async/await,无需引入 Polyfill。

async function fetchAgentData() {
  try {
    const response = await wx.request({ url: '...' });
    return response.data;
  } catch (error) {
    console.error(error);
  }
}

2. 现代数据结构

全面支持 Map、Set、WeakMap 和 WeakSet,以及最新的数组/对象方法。

const agentState = new Map();
agentState.set('status', 'active');

// 可选链 (Optional Chaining) 与 空值合并 (Nullish Coalescing)
const userName = user?.profile?.name ?? 'Guest';

3. ES Modules

支持标准的 import 和 export 模块化语法。

import { formatTime } from '../../utils/util.js';
export const config = { timeout: 5000 };

4. BigInt

原生支持大整数运算,这在处理高精度时间戳或硬件标识符时非常有用。

const timestamp = 9007199254740991n;

同步执行预算

从 AIUI 0.20 起,每个实例默认具有 2,000 ms 的同步 JavaScript 执行预算。超过预算会中断脚本运行环境并请求销毁实例;不要依赖超时后继续执行清理逻辑。异步等待在 JavaScript 交还控制权后不计入预算;单纯把计算放入 async 函数不会自动让出控制权。

拆分长计算,在批次之间通过计时器让出事件循环;不要使用忙等循环,也不要把 await Promise.resolve() 当作可靠的事件循环让出方式。

async function processInBatches(items, processItem) {
  for (let start = 0; start < items.length; start += 100) {
    for (const item of items.slice(start, start + 100)) {
      processItem(item);
    }
    await new Promise((resolve) => setTimeout(resolve, 0));
  }
}

批次大小应根据单项耗时调整,确保每批同步执行都足够短。部署环境可设置不同预算;应用不能在运行中修改此策略。

WebAssembly 计算模块

可通过 WebAssembly 运行计算模块并绑定 JavaScript 导入。同步构造器和导出函数调用仍应避免长时间阻塞。支持范围、资源配额及 Module 复用方式见 WebAssembly。