Web Worker 必须使用外部JS文件启动,不支持data URL或内联脚本;需同源、可fetch加载,禁用file://协议;不支持DOM操作;传大对象应使用transferable避免拷贝;需分别监听worker.onerror、onmessageerror及self.onerror捕获错误;共享内存需SharedArrayBuffer+Atomics并启用COOP/COEP跨域隔离。
直接在 里写 new Worker("data:text/javascript,...") 或用 Blob URL 在部分浏览器(尤其是 Safari 和旧版 Edge)会失败,报 SecurityError: Failed to construct 'Worker'。规范要求 Worker 脚本必须满足同源且不能是 data URL
或 inline script。
正确做法是把逻辑拆到单独文件:
/* worker.js */
self.onmessage = function(e) {
const result = e.data * e.data;
self.postMessage(result);
};主页面中这样调用:
const worker = new Worker('worker.js');
worker.postMessage(123);
worker.onmessage = function(e) {
console.log('计算结果:', e.data); // 15129
};file:// 协议下的本地双击打开,需起本地服务)Worker 构造函数有特殊处理(比如 Vite 要写 new Worker(new URL('./worker.js', import.meta.url), { type: 'module' }))document、window、localStorage 全部不可用,只能用 self、fetch、setTimeout、IndexedDB 等有限 API默认情况下,postMessage() 会对参数做结构化克隆(structured clone),遇到 ArrayBuffer、TypedArray、ImageBitmap、OffscreenCanvas 等类型时,如果没显式转移,会完整复制一份 —— 处理几十 MB 图片像素或音频 buffer 时,卡顿立刻出现。
立即学习“前端免费学习笔记(深入)”;
正确做法是用 transfer 参数移交所有权:
const buffer = new ArrayBuffer(1024 * 1024 * 10); // 10MB
worker.postMessage({ data: buffer }, [buffer]); // buffer 被移走,主线程不能再读Worker 内接收后可直接使用:
self.onmessage = function(e) {
const buf = e.data.data; // 类型仍是 ArrayBuffer,但已无拷贝开销
const view = new Uint8Array(buf);
// …处理逻辑
};ArrayBuffer 及其视图(Uint8Array 等)、MessagePort、ImageBitmap 支持 transferArrayBuffer{ byteLength: 0 },继续访问会静默失败onerror 和 onmessageerror
Worker 内抛出未捕获异常不会冒泡到主线程 window.onerror,也不会触发 console.error(除非 DevTools 打开)。不加监听,bug 就静默消失。
必须分别处理三类错误:
worker.onerror:Worker 初始化失败(如脚本 404、语法错误、CSP 拦截)worker.onmessageerror:收到无法反序列化的消息(比如传了函数或循环引用对象)self.onerror:运行时异常(需在 worker.js 里写)示例:
// 主线程
worker.onerror = function(e) {
console.error('Worker 初始化失败:', e.filename, e.lineno, e.message);
};
worker.onmessageerror = function(e) {
console.error('消息解析失败:', e.data);
};
// worker.js 内
self.onerror = function(e) {
self.postMessage({ error: e.message });
};
SharedArrayBuffer + Atomics
普通 Worker 之间完全隔离,postMessage 是唯一通信方式,不适合高频共享状态(比如实时音视频帧同步、游戏物理模拟)。想让两个 Worker 直接读写同一块内存,得用 SharedArrayBuffer。
但注意:现代浏览器默认禁用 SAB,需开启跨域隔离(COOP/COEP header)才能启用:
Cross-Origin-Opener-Policy: same-origin 和 Cross-Origin-Embedder-Policy: require-corp
new SharedArrayBuffer() 会抛 TypeError: SharedArrayBuffer is not supported
启用后,Worker 可这样协作:
// 主线程分配共享内存 const sab = new SharedArrayBuffer(1024); const int32 = new Int32Array(sab);// 传给两个 Worker worker1.postMessage({ buffer: sab }, [sab]); worker2.postMessage({ buffer: sab }, [sab]);
// Worker 内 self.onmessage = function(e) { const shared = new Int32Array(e.data.buffer); Atomics.add(shared, 0, 1); // 原子加,避免竞态 };
没加 Atomics 直接读写,结果不可预测 —— 这点极易被忽略。
实际项目中,除非真需要微秒级同步,否则优先用 postMessage + 设计无状态任务,更稳、更易调试。