web worker 必须用外部js文件启动且不支持dom操作;通信依赖postmessage/onmessage;传大数组或buffer必须用transfer移交所有权,否则卡死;file://协议下不可用,需http服务或esm的new url()写法;数据通过结构化克隆传递,无共享内存;错误需显式onerror捕获。

Web Worker 必须用外部 JS 文件启动,不能内联;不支持 DOM 操作;通信靠 postMessage() 和 onmessage;传大数组或 buffer 时必须用 transfer 参数移交所有权,否则卡死。
Worker 构造失败:路径、协议、模块写法全踩坑点
直接写 new Worker('worker.js') 在 Vite、Webpack 或本地双击打开时大概率报错:SecurityError: Failed to construct 'Worker' 或 net::ERR_FILE_NOT_FOUND。
- file:// 协议下绝对不行——必须起 HTTP 服务(
npx http-server或 VS Code Live Server) - ESM 环境(如 Vite)要写成
new Worker(new URL('./worker.js', import.meta.url), { type: 'module' }),否则加载失败 - 动态生成逻辑?用
Blob更稳:new Worker(URL.createObjectURL(new Blob(['self.onmessage = ...'], {type: 'application/javascript'}))) - 路径别写
./worker.js这种相对路径——构建工具可能解析错,优先用new URL()显式定位
主线程与 Worker 通信:只认消息,不认引用
Worker 和主线程之间没有共享内存,所有数据都走结构化克隆(structured clone),不是传引用,也不能调对方函数。
- 主线程发消息:
worker.postMessage({id: 1, value: 42});Worker 收:self.onmessage = e => { console.log(e.data.value) } - 忘了加
self.onmessage或worker.onmessage,消息就静默丢弃——这是最常被忽略的“没反应”原因 -
postMessage()第二个参数[buffer]只对ArrayBuffer、TypedArray、MessagePort有效;传普通对象、数组、字符串仍会深拷贝 - Worker 内不能用
document、window、alert,一用就ReferenceError;能用的只有self、fetch、setTimeout、IndexedDB等有限 API
大对象传输卡顿:transfer 不是可选项,是必选项
处理图片像素、音频 buffer、几十 MB 的 JSON 解析结果时,不移交所有权,主线程和 Worker 都得扛一份完整拷贝,瞬间卡住。
- 正确做法:
const buf = new ArrayBuffer(10 * 1024 * 1024); worker.postMessage({buf}, [buf]); - 移交后,主线程的
buf变成ArrayBuffer{ byteLength: 0 },再读会静默失败——不是报错,是读不到 - Worker 内接收后可直接用:
const view = new Uint8Array(e.data.buf);,零拷贝 - JSON 对象、Date、RegExp、普通数组……这些统统不支持
transfer,只能克隆;真要传大结构,先JSON.stringify()+Uint8Array编码再移交 buffer
错误捕获和调试:默认静默,不报等于没跑
Worker 内部未捕获的异常(比如 fetch 失败、setTimeout 里抛错)不会冒泡到主线程控制台,看起来就像“没执行”。
- Worker 内必须显式加:
self.onerror = e => self.postMessage({type: 'error', message: e.message}) - 主线程监听:
worker.addEventListener('message', e => { if (e.data.type === 'error') console.error('[Worker]', e.data.message) }) -
try/catch捕不到异步错误,onerror是兜底唯一手段 - Chrome 调试不要去 “Application → Service Workers”,要去 “Sources → Page → workers”,右键 “Open in Debugger” 才能单步
真正难的不是写两行 postMessage,而是判断哪些数据该 transfer、哪些错误该透传、哪些路径在构建后会失效——这些细节一旦漏掉,Worker 就变成一个黑盒,跑没跑、卡在哪、错在哪,全靠猜。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











