跳到主要内容

异步数据处理

趋势、报警和大量变量使页面变慢时,优先使用 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 后重新同步当前值。不要把离线期间缓存的操作在重连后自动补写。

性能检查​

  • 每个订阅都有对应取消函数。
  • 不可见页面不持续绘图。
  • 趋势采样间隔与画面需求匹配。
  • 大列表启用虚拟滚动。
  • 写入使用防抖并等待终态回执。
  • 长时间运行后内存没有持续增长。

相关文档​