异步数据处理
趋势、报警和大量变量使页面变慢时,优先使用 window.darra 提供的订阅模式和取消函数,再考虑浏览器 Worker 或本地缓存。
订阅模式
darra.subscribe() 支持三种推送策略:
| 模式 | 行为 | 适用 |
|---|---|---|
onChange | 值变化时推送,默认模式 | 状态、报警、开关量 |
periodic:N | 每 N 毫秒推送一次 | 趋势和仪表 |
onDemand | 不主动推送,通过 read() 读取 | 很少查看的低优先级值 |
周期范围为 100 到 60000 ms。
const stopTrend = darra.subscribe(
'DB1.Temperature',
{ pushRate: 'periodic:500' },
(value, meta) => renderTrend(value, meta.timestamp)
);
const stopState = darra.subscribe(
'DB1.Running',
{ pushRate: 'onChange' },
value => renderState(value)
);
stopTrend();
stopState();
read() 在未连接时立即拒绝,超时 5 秒。不要用浏览器定时器去轮询已订阅变量。
合并订阅
一组值需要同时刷新时使用 bindGroup();整个 DB 页面使用 bindDB()。不要为同一变量在多个组件中反复创建未清理的订阅。
const stop = darra.bindGroup(
['DB1.Setpoint', 'DB1.Actual', 'DB1.Output'],
values => renderLoop(values)
);
写入节流
滑块和文本输入不要在每次键盘事件中写 PLC。停止输入后再提交,并等待终态回执:
let timer;
function queueWrite(value) {
clearTimeout(timer);
timer = setTimeout(async () => {
const receipt = await darra.write('DB1.Setpoint', value);
if (!darra.isCommittedReceipt(receipt)) {
throw new Error('写入未完整提交');
}
}, 300);
}
批量参数必须使用 writeGroup(),让同组写入在一个事务中提交。当前公开 API 不提供原子脉冲,darra.pulse() 会明确拒绝,不能用两次延时写入伪造脉冲边沿。
同时未完成写入有上限。被拒绝后应提示操作员,不要静默重试打满队列。
大数据页面
- 图表只保留可见时间窗口。
- 报警和表格使用虚拟滚动。
- DOM 更新集中到
requestAnimationFrame()。 - 重采样或统计量较大时可使用 Web Worker。
- IndexedDB 只用于页面缓存,不作为运行时真相。
- 非活动页暂停订阅和计时器。
Worker、OffscreenCanvas 和 IndexedDB 是浏览器能力,不是 HMI 内置数据合同。使用前应在目标 WebView2 和移动浏览器上实测。
断线与恢复
监听 offline 后冻结页面显示、标注最后更新时间并禁用写入;监听 ready 后重新同步当前值。不要把离线期间缓存的操作在重连后自动补写。
性能检查
- 每个订阅都有对应取消函数。
- 不可见页面不持续绘图。
- 趋势采样间隔与画面需求匹配。
- 大列表启用虚拟滚动。
- 写入使用防抖并等待终态回执。
- 长时间运行后内存没有持续增长。