html5的web worker怎么用_后台线程处理任务操作【详解】

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 操作 —— documentwindowlocalStorage 全部不可用,只能用 selffetchsetTimeoutIndexedDB 等有限 API

传递数据别传大对象,用 transferable 避免拷贝

默认情况下,postMessage() 会对参数做结构化克隆(structured clone),遇到 ArrayBufferTypedArrayImageBitmapOffscreenCanvas 等类型时,如果没显式转移,会完整复制一份 —— 处理几十 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 等)、MessagePortImageBitmap 支持 transfer
  • transfer 后原变量变成 ArrayBuffer{ byteLength: 0 },继续访问会静默失败
  • JSON 对象、普通数组、字符串等仍走克隆,无法避免拷贝 —— 大量文本处理建议先压缩或分块

错误捕获要监听 onerroronmessageerror

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-originCross-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 + 设计无状态任务,更稳、更易调试。