
`structuredclone()` 是现代 javascript 提供的原生深度克隆方案,能完整保留 date、regexp、map、set、arraybuffer 等内置类型实例,生成全新引用,彻底避免浅拷贝导致的嵌套对象共享问题。
在 JavaScript 中,克隆数组看似简单,但真正实现“内容完全一致 + 所有嵌套值均为新引用”却极具挑战。常见方法如展开运算符([...a])、slice()、Array.from()、map(x => x) 等,仅执行浅拷贝:它们创建了新数组,但数组内引用类型的元素(如 Date、普通对象、正则表达式等)仍指向原始内存地址。这意味着修改 b[3].date 会同步影响 a[3].date——这显然不符合“完全独立副本”的需求。
而 JSON.parse(JSON.stringify(a)) 虽能实现深度克隆,却存在严重局限:它会丢失原型链、函数、undefined、Symbol、Date 对象(转为 ISO 字符串)、RegExp、Map/Set 等,且无法处理循环引用。正如提问者所观察到的,new Date() 变成了字符串,丧失了 Date 实例的方法与行为,已非“identical result”。
✅ 正确解法:使用原生 structuredClone()
structuredClone() 是 ECMAScript 标准与 WHATWG 规范定义的安全、深度、类型保真的克隆 API,自 Chrome 98、Firefox 94、Safari 15.4 起全面支持(Node.js 17.0+ 启用 --experimental-structured-cloning,Node.js 18.16+ / 20.6+ 已稳定支持):
立即学习“Java免费学习笔记(深入)”;
const a = [1, new Date(), false, { date: new Date(), name: "John Doe" }];
// ✅ 深度克隆:新数组 + 新 Date 实例 + 新对象 + 新属性引用
const b = structuredClone(a);
console.log(a === b); // false —— 数组本身是不同引用
console.log(a[1] === b[1]); // false —— Date 实例彼此独立
console.log(a[3] === b[3]); // false —— 嵌套对象也是不同引用
// 修改副本不影响原数组
b[3].date = null;
console.log(a[3].date); // 仍为原始 Date 实例(未被修改)
console.log(b[3].date); // null? 关键优势:
- 完整保留 Date、RegExp、Map、Set、ArrayBuffer、TypedArray、Error、BigInt、Blob、File、ImageData 等可结构化数据类型;
- 支持嵌套对象、数组、混合类型;
- 自动处理循环引用(不会栈溢出或无限递归);
- 无 JSON 序列化副作用(不丢失类型、不转换 Date 为字符串);
- 同步、零依赖、浏览器与 Node.js 原生支持。
⚠️ 注意事项:
- 不支持函数、undefined、Symbol、WeakMap、WeakSet、Promise、window 等不可结构化值(尝试克隆会抛出 DataCloneError);
- 若需兼容旧环境(如 IE 或早期 Node.js),可回退至成熟库(如 Lodash 的 _.cloneDeep()),但需注意其对 Date 等类型的处理是否满足业务精度要求;
- 在 Web Worker 中亦可安全使用,适用于跨线程数据传递场景。
总结:对于现代 JavaScript 开发,structuredClone() 是克隆含复杂嵌套对象(尤其是 Date、RegExp 等)数组的首选且最可靠方案。它无需手动递归实现,规避了手写深克隆的边界陷阱(如循环引用、不可枚举属性、原型污染),真正做到了“identical result with new references”。










