Web Worker 必须分离为独立 JS 文件且通过 HTTP/HTTPS 加载,file:// 协议报错;路径需同源,推荐 new Worker(new URL('./worker.js', import.meta.url));通信依赖 postMessage/onmessage,注意消息监听时机、转移 ArrayBuffer、错误捕获;Worker 无 DOM/BOM,仅支持有限 API;Chrome 调试需在 Sources → Page → workers 中操作。
Web Worker 不能直接写在 HTML 文件里,必须分离成独立的 .js 文件,且页面必须通过 HTTP/HTTPS 协议加载——本地双击打开的 file:// 协议会直接报错。
浏览器对 new Worker() 的脚本路径有硬性限制:只接受同源 URL(含 data:、Blob:),不支持字符串代码或内联函数。常见失败原因包括:
file:// 协议下运行:错误信息是 Failed to construct 'Worker': Script at 'file:///' cannot be accessed from origin 'null';必须用 npx http-server、VS Code Live Server 或任意本地服务启动./worker.js 在某些构建工具(如 Vite、Webpack)中可能解析失败;ESM 环境下最稳写法是 new Worker(new URL('./worker.js', import.meta.url))
new Worker() 仍拒绝非同源 URL;不能用 CDN 上的 https://cdn.example.com/worker.js
Blob 构造更可靠:new Worker(URL.createObjectURL(new Blob(['self.onmessage = ...'], {type: 'application/javascript'})))
通信只能靠 postMessage() + onmessage,没有共享内存,所有数据走结构化克隆(structured clone)。容易出问题的地方:
worker.onmessage = e => {...} 必须在 postMessage() 之前设置,否则第一次消息就丢了;推荐用 worker.addEventListener('message', ...) 更健壮self.onmessage:写了 console.log(self) 不代表逻辑跑起来了,必须显式绑定才能收消息Array 或 Object,会深拷贝;10MB 数组可能卡顿几百毫秒;可转移对象(如 ArrayBuffer)要加到 postMessage() 第二个参数:worker.postMessage(data, [data.buffer])
error:Worker 内未捕获的异常默认静默;主线程需监听 worker.onerror,Worker 内建议加 self.onerror = e => self.postMessage({type: 'error', ...})
Worker 是纯计算环境,没有 DOM、BOM 和部分存储 API。以下操作会直接抛 ReferenceError:
立即学习“前端免费学习笔记(深入)”;
document.getElementById、document.body、alert、localStorage、sessionStorage(但可用 indexedDB)window、parent、top、frames 全部不存在;只能用 self(等价于 globalThis)fetch 和 XMLHttpRequest 可用,但 WebSocket 在部分旧版 Safari 中不可用requestAnimationFrame、getComputedStyle、CSSStyleSheet 均不可用;如需 Canvas 渲染,得配合 OffscreenCanvas
DevTools 不在 “Application → Service Workers” 里找普通 Worker,那个标签页只显示 service worker。正确路径是:
console.log)默认出现在主线程控制台,但前缀带 [Worker];想过滤,可在 Console 输入 Filter: [Worker]
self.onerror 是否透传了错误,否则异常被吞掉,根本看不到报错位置最常被忽略的一点:Worker 实例一旦终止(worker.terminate()),就不能再复用;每次需要新任务,都得新建一个 Worker 实例——除非你用 SharedWorker,但它有额外的连接管理成本,普通场景别乱切。