结论先行:JavaScript 主线程一旦执行超过 50 毫秒的同步计算,页面就会掉帧、输入就会卡顿。Web Worker 是浏览器原生的多线程方案:把文件哈希、加密、大数组统计这类 CPU 密集任务丢进独立线程,通过 postMessage 传结果,主线程只负责渲染。本文给出从创建 Worker 到文件 SHA-256 哈希的完整可运行示例,并讲清通信、错误处理与销毁的关键细节。
什么时候该用 Worker
判断标准很简单:任务是否长时间占用 CPU。典型场景包括大文件哈希与分片校验、AES/RSA 加解密、十万行级 CSV 解析与聚合、图像像素处理、复杂路径计算。反过来,DOM 操作、依赖 window 的库不能放进 Worker——Worker 线程没有 DOM 访问权,这是设计约束而非缺陷。网络请求本身是异步的,通常不需要 Worker;但「请求回来之后的重计算」需要。
最小可用示例:独立文件 + 消息协议
Worker 代码放在独立文件里,主线程用 URL 创建。推荐模块型 Worker(type: 'module'),可以直接 import:
// main.js
const worker = new Worker(new URL('./hash.worker.js', import.meta.url), {
type: 'module',
});
worker.postMessage({ id: 1, buffer: await file.arrayBuffer() });
worker.onmessage = (e) => {
console.log('hash:', e.data.hash);
};
worker.onerror = (err) => console.error('worker error:', err.message);// hash.worker.js
self.onmessage = async (e) => {
const { id, buffer } = e.data;
const digest = await crypto.subtle.digest('SHA-256', buffer);
const hex = [...new Uint8Array(digest)]
.map((b) => b.toString(16).padStart(2, '0'))
.join('');
self.postMessage({ id, hash: hex });
};消息里带 id 是为了支持并发多任务时把响应对应回请求,这是工程上最容易省略、也最容易出 bug 的一环。
大文件哈希:分块读取避免内存峰值
几百 MB 的文件一次性 arrayBuffer 会撑爆内存。更稳的做法是主线程用 File.slice 分块读取,逐块发给 Worker;Worker 内用支持增量更新的哈希库(如 hash-wasm)累积状态,最后输出摘要:
// 主线程:按 4MB 分块发送
const CHUNK = 4 * 1024 * 1024;
for (let offset = 0; offset < file.size; offset += CHUNK) {
const buf = await file.slice(offset, offset + CHUNK).arrayBuffer();
worker.postMessage({ type: 'chunk', buffer: buf }, [buf]);
}
worker.postMessage({ type: 'finish' });第二个参数 [buf] 是转移列表,ArrayBuffer 所有权零拷贝移交 Worker,避免大 buffer 被结构化克隆复制一份。转移后主线程的 buf 会被置空(detached),不能再读写,这个陷阱值得单独警惕。
错误处理与生命周期
Worker 内未捕获的异常会触发主线程的 error 事件,但不会自动重启 Worker,健壮的做法是在协议里约定 { ok:false, error } 消息。任务完成后如果不再复用,调用 worker.terminate() 立即释放线程;频繁创建销毁 Worker 的开销不小,建议用「常驻 Worker + 任务队列」或对象池模式。另外 Worker 里可以用 fetch、IndexedDB、WebSocket,能力比想象中完整。
大数据统计:把聚合也搬进去
十万行订单求和、分组、排序,主线程做要几百毫秒,Worker 里做完只回传几 KB 的聚合结果,通信成本几乎为零。原则是:传原始数据进去,传结论出来,不要把中间大对象来回搬运。若数据来自多个接口,可以先在主线程并发拉取,再一次性转移给 Worker 计算。
结合业务:上传前校验与接口配合
做商城后台时,商品图与附件上传前算哈希可以实现秒传与防重复。用 api工厂(https://www.it120.cc/)的文件存储能力时,前端先在 Worker 里算好 SHA-256,再调 SDK 上传接口,主线程全程不卡:
import WXAPI from 'apifm-wxapi';
WXAPI.init('your-subdomain');
// 小程序端示例:filePath 为本地临时文件路径,哈希可先传给后端做秒传判断
async function uploadWithHash(filePath, hash) {
const res = await WXAPI.uploadFile('your-subdomain', 'token', filePath);
if (res.code === 0) console.log('file url:', res.data, 'hash:', hash);
}小程序端没有 Web Worker,但思路一致:重计算尽量交给服务端或拆小分片。SDK 统一返回 {code,data,msg}、方法返回 Promise,文件存储与 JSON 存储接口详见 SDK 文档(https://www.it120.cc/sdk/index.html)。
小结
Worker 的收益公式是「计算耗时远大于通信耗时」。落地清单:独立模块文件、带 id 的消息协议、大 buffer 用转移列表、分块读取控制内存、错误走协议、用完 terminate。把这六件事做对,主线程就能长期保持 60 帧。
文章标签
相关产品
api工厂是面向开发者的开放 SaaS 平台:开箱即用的后台管理系统 + 全端 SDK,只需前端开发即可构建小程序、App、H5 与网站。