Web Worker 必须使用外部JS文件启动，不支持data URL或内联脚本；需同源、可fetch加载，禁用file://协议；不支持DOM操作；传大对象应使用transferable避免拷贝；需分别监听worker.onerror、onmessageerror及self.onerror捕获错误；共享内存需SharedArrayBuffer+Atomics并启用COOP/COEP跨域隔离。
Web Worker 必须用外部 JS 文件启动，不能内联
直接在 里写 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
};- 路径必须可被 fetch 加载（不能是
file://协议下的本地双击打开，需起本地服务） - 若用构建工具（如 Vite、Webpack），注意它们可能对
Worker构造函数有特殊处理（比如 Vite 要写new Worker(new URL('./worker.js', import.meta.url), { type: 'module' })） - 不支持 DOM 操作 ——
document、window、localStorage全部不可用，只能用self、fetch、setTimeout、IndexedDB等有限 API
传递数据别传大对象，用 transferable 避免拷贝
默认情况下，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支持 transfer - transfer 后原变量变成
ArrayBuffer{ byteLength: 0 }，继续访问会静默失败 - JSON 对象、普通数组、字符串等仍走克隆，无法避免拷贝 —— 大量文本处理建议先压缩或分块
错误捕获要监听 onerror 和 onmessageerror
Worker 内抛出未捕获异常不会冒泡到主线程 window.onerror，也不会触发 console.error（除非 DevTools 打开）。不加监听，bug 就静默消失。
必须分别处理三类错误：
-
worker.onerror：Worker 初始化失败（如脚本 404、语法错误、CSP 拦截） -
worker.onmessageerror：收到无法反序列化的消息（比如传了函数或循环引用对象） - Worker 内部的
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 });
};
多个 Worker 共享数据只能靠 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 + 设计无状态任务，更稳、更易调试。
