structuredclone能直接处理循环引用，是其最不可替代的优势之一；它用图遍历重建引用关系，一行代码即可实现完全隔离的深拷贝，无需手动缓存或递归逻辑。
structuredClone 能否直接处理循环引用对象
能，而且是它最不可替代的优势之一。JSON 方法遇到 obj.self = obj 这类结构会直接抛 TypeError: Converting circular structure to JSON，而 structuredClone 内部用图遍历而非树遍历，天然支持循环引用重建。
实操时只需一行：
const original = { name: "user" }; original.ref = original;
const clone = structuredClone(original);
console.log(clone.ref === clone); // true
- 无需手动维护
WeakMap缓存，不用写递归逻辑 - 克隆后
clone.ref指向的是新对象自身，不是原对象，完全隔离 - 但注意：如果原始对象有 getter/setter，其逻辑不会被调用，属性值按当前状态拷贝
TypedArray（如 Uint8Array）拷贝后还能正常使用吗
能，且比 JSON 方案强得多——它保留类型、长度、内容，甚至支持底层内存转移优化。
常见错误是误以为 Uint8Array 被转成普通数组或丢失精度：
const arr = new Uint8Array([1, 2, 3]); const clone = structuredClone(arr); console.log(clone instanceof Uint8Array); // true console.log(clone[0] === arr[0]); // true
- 不加
transfer选项时，是完整复制（深拷贝），原arr.buffer仍可用 - 若需高性能转移（比如大文件上传前预处理），可传
{ transfer: [arr.buffer] }，此时原arr.buffer变为 detached，必须确保后续不再读写 - transfer 只接受
ArrayBuffer、MessagePort等可转移对象，传Uint8Array本身会报错
哪些“看似正常”的值会导致 structuredClone 报错
它不报错才奇怪——遇到不支持类型会立即抛 DataCloneError，而不是静默丢弃。最容易踩坑的是这三类：
-
function：哪怕只是对象里一个方法字段，structuredClone({ fn() {} })直接失败 -
undefined或Symbol（包括Symbol('key')，但Symbol.for('key')可克隆） -
Error实例：属性能拷贝，但stack、原型链、cause字段全丢失，且某些环境可能抛错
业务中常混在配置对象或响应数据里，建议提前过滤或降级：
try {
return structuredClone(data);
} catch (err) {
if (err.name === 'DataCloneError') {
return JSON.parse(JSON.stringify(data)); // 仅限纯数据场景
}
throw err;
}
兼容性 fallback 怎么写才不翻车
不能只靠 typeof structuredClone === 'function' 判断——Node.js 17+ 和现代浏览器支持，但 Safari 15.4 之前、Firefox 94 之前等旧版本不支持，且部分 Electron 或 WebView 环境可能未启用。
- 检测必须带实际调用测试，因为有些 polyfill 会挂空函数导致假阳性
- 推荐用最小可信对象验证：
structuredClone({ a: 1, b: new Date() })，Date 是 JSON 不支持但 structuredClone 支持的典型信号 - fallback 到
JSON.parse(JSON.stringify())前，务必确认数据不含Date、RegExp、BigInt，否则结果不可控
真正复杂的业务对象，往往同时含循环引用 + TypedArray + 部分不可克隆字段——这种时候，没有银弹。要么清洗输入（剔除函数/undefined），要么接受降级损失，要么引入轻量 polyfill（如基于 postMessage 的跨 context 克隆）。
