Wasm-worker 是简化 WebAssembly 多线程并行计算的轻量库，封装 Worker 管理、SharedArrayBuffer 零拷贝、Promise 接口等细节，提升图像处理等密集计算效率。
WebAssembly（Wasm）本身不直接支持多线程，但结合 Web Workers 和 SharedArrayBuffer，可在浏览器中实现真正的并行计算。Wasm-worker 是一个轻量级工具库，它简化了将 Wasm 模块分发到 Worker 线程、传递数据和同步结果的过程，显著提升密集型计算（如图像处理、加密、物理模拟）的执行效率。
为什么需要 Wasm-worker 而非手动管理 Worker？
原生使用 Web Worker + Wasm 需要手动处理模块加载、内存共享、消息序列化/反序列化、错误边界和线程生命周期，容易出错且代码冗长。Wasm-worker 封装了这些细节：
- 自动在 Worker 中编译并实例化 Wasm 模块（支持 `.wasm` 二进制或 wasm 字节码）
- 内置基于
SharedArrayBuffer的零拷贝内存交互（需启用跨域策略） - 提供 Promise 风格的调用接口，避免回调地狱
- 支持函数导出调用、批量任务分发和结果聚合
基础用法：启动一个带 Wasm 的 Worker
假设你有一个编译好的 `math.wasm`（含导出函数 add 和 fibonacci），使用方式如下：
import { createWorker } from 'wasm-worker';
// 创建 worker 实例（自动加载并初始化 wasm）
const worker = await createWorker('./math.wasm');
// 直接调用 wasm 导出函数（参数自动序列化，返回值 Promise）
const result = await worker.fibonacci(40); // 返回 Promise<number>
console.log(result); // 102334155
// 支持批量并发调用
const [a, b] = await Promise.all([
worker.add(123, 456),
worker.fibonacci(35)
]);
关键性能优化点
真正提升效率依赖以下配置与实践：
立即学习“前端免费学习笔记（深入）”；
-
启用 SharedArrayBuffer：需确保服务端设置
Cross-Origin-Embedder-Policy: require-corp和Cross-Origin-Opener-Policy: same-origin，否则 fallback 到结构化克隆（有拷贝开销） -
复用 Worker 实例：避免频繁创建/销毁；Wasm-worker 内部缓存模块实例，多次
await worker.xxx()复用同一线程 - 合理拆分任务粒度：过细（如每次只算一个像素）增加通信开销；过粗（单个任务耗时数秒）无法发挥多核优势；建议单任务执行 5–50ms
-
使用 TypedArray 直接读写共享内存：对大数据（如图像像素数组），通过
worker.getMemoryView()获取Uint8Array视图，实现零拷贝操作
注意事项与兼容性
Wasm-worker 并非“开箱即用”：
- 仅支持现代浏览器（Chrome 92+、Firefox 94+、Safari 16.4+），旧版需降级为普通 Worker + ArrayBuffer 传输
- Wasm 模块必须导出函数，且参数/返回值类型限于基本类型（
i32,f64,externref等）；复杂结构需自行序列化 - 调试较困难：Worker 中的 Wasm 错误堆栈不直接映射到源码；建议开启
.wasm的 DWARF 调试信息并配合 Chrome DevTools 的 “Workers” 标签页 - 不支持动态导入多个不同 Wasm 模块到同一 Worker；如需混合逻辑，应提前静态链接或使用 Wasm 插件机制
