展开本页目录
开始前准备什么
- Node.js 24 和 npm。
- 下载并解压本页的复现包。样例在本机运行。
- 准备样例
- 运行脚本
- 对照结果
- 核对自己的应用
下载脚本和完整输出
包含版本锁定文件、操作说明、运行脚本和原始输出。
操作步骤
- 解压样例,在解压目录执行 npm ci,再执行 node univer.cjs。脚本使用 Univer Sheets Node preset 1.0.4 和 Node.js 24。
- A1 录入 12,A2 录入 18,B1 设置 =SUM(A1:A2)。先计算一次,确认 B1 为 30。
- 把 A2 改成 21,记录 B1 的第一次直接读取,再执行并等待公式计算。对照 recalc.immediate 和 recalc.applied。
- 把等待步骤放在后台导出、保存汇总、调用下游之前。多次并发修改同一个工作簿时,将写入和读取结果的验收按任务顺序执行。
关键代码
univer.cjs
javascript
range('A2').setValue(21);
const formula = api.getFormula();
const applied = formula.onCalculationResultApplied();
formula.executeCalculation();
await applied;
assert.equal(range('B1').getValue(), 33);实测结果
| 操作 | B1 读取值 |
|---|---|
| 首次计算完成 | 30 |
| A2 改成 21 后立即读取 | 30 |
| 本轮计算结果应用后 | 33 |
- 操作
- 首次计算完成
- B1 读取值
- 30
- 操作
- A2 改成 21 后立即读取
- B1 读取值
- 30
- 操作
- 本轮计算结果应用后
- B1 读取值
- 33
怎样确认已经完成
- B1 的公式文本保持 =SUM(A1:A2)。
- 确认结果应用成功后再保存汇总。
- 给批处理设置超时,避免无限等待。
常见问题
可以用固定 500 毫秒延时替代计算完成事件吗?
公式量、设备和队列变化都会影响计算时间。使用计算结果事件和可诊断的超时处理。
