使用结构化克隆算法(structured clone algorithm)传输数据可以解决循环引用报错。web worker 的 `postmessage` 方法在序列化对象时,会自动处理并保留循环引用结构,只要对象中不包含函数、dom 节点或不可序列化的特殊类型即可。

postMessage 如何序列化循环对象
浏览器引擎在调用 postMessage 时,会遍历对象图并构建一个内部映射表。遇到已访问过的节点时,它不会再次复制,而是记录一个引用指针。这种机制确保了接收端收到的对象结构与发送端完全一致,包括环状连接。

const data = { name: 'root' };
data.self = data; // 创建循环引用
worker.postMessage(data); // 成功发送,无 TypeError
上述代码展示了最简单的自引用场景。当主线程执行 postMessage 时,序列化器识别到 self 属性指向的对象已在栈中,因此将其标记为引用而非新对象。Worker 端通过 onmessage 接收到的对象同样具备 data.self === data 的特性。
复杂嵌套与数组中的循环引用
循环引用不仅存在于对象属性中,也可能出现在数组元素或深层嵌套结构中。序列化算法对这两种情况的处理逻辑相同,均依赖深度优先搜索和 visited set 来避免无限递归。只要根对象可达且无非法属性,传输即成功。
FilePond 是一个 JavaScript 文件上传库,支持通过拖拽、粘贴和 API 方式处理文件、目录、URL 和 Data URI。它包含内置的图像优化功能、异步分块上传功能,并提供了适用于 React、Vue、Angular 和 Svelte 的适配器。

const list = [1, 2]; list.push(list); // 数组包含自身 worker.postMessage(list); // 成功发送
该示例中,数组 list 的最后一个元素是其自身。序列化过程会先处理前两个数字,然后遇到第三个元素时发现它是当前数组的引用,从而建立链接。接收端的数组长度仍为 3,且索引 2 的值等于数组本身。
基于 structuredClone 的本地验证问题
如果需要在主线程模拟 Worker 的传输行为,可以使用 structuredClone() 函数。它遵循相同的克隆规则,允许开发者在不启动 Worker 的情况下测试循环引用是否会被正确保留或抛出异常。
const obj = { a: 1 };
obj.b = obj;
const cloned = structuredClone(obj);
console.log(cloned.b === cloned); // true
这段代码验证了本地克隆也能正确处理环。如果对象中包含 Map 或 Set,它们也会被转换为对应的深拷贝版本,保持原有的循环关系。若对象包含函数,structuredClone 会直接抛出错误,这与 Worker 传输时的行为一致。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










