structuredClone()可直接替代jQuery.extend(true,{},obj)的深拷贝逻辑,前提是环境支持且数据不含函数、Promise等受限类型;它更轻量、安全,无需依赖库,能正确处理Date、RegExp、Map、Set、循环引用等JSON方案无法覆盖的结构。

structuredClone() 可以直接替代 jQuery.extend(true, {}, obj) 的深拷贝逻辑,前提是环境支持且数据不含函数、Promise 等受限类型。它更轻量、更安全、无需依赖库,还能正确处理 Date、RegExp、Map、Set、循环引用等 JSON 方案无法覆盖的结构。
为什么 structuredClone() 比 $.extend(true, ...) 更合适
jQuery 的 $.extend(true, {}, source) 是手动递归实现的深拷贝,虽支持函数和部分特殊对象(如 DOM 节点),但存在明显短板:
- 无法识别或跳过循环引用,深层嵌套时易栈溢出
- 对 Map/Set/TypedArray/Date/RegExp 等只做浅层复制或丢失原型信息(例如 new Date() 变成普通对象)
- 不支持 Symbol 属性、不可枚举属性、getter/setter
- 引入 jQuery 库增加包体积,而现代项目普遍已移除 jQuery
哪些场景能直接替换
只要你的数据是纯前端业务对象(不含函数、DOM 节点、window/document、WeakMap),structuredClone 就能无缝替代:
jQuery 1.12.4是jQuery 1.x系列的最后一个正式稳定版本,由jQuery团队于2016年发布。该版本主要面向需要兼容旧版浏览器环境的网站和Web应用,尤其适用于仍需支持Internet Explorer 6、Internet Explorer 7、Internet Explorer 8等老旧浏览器的项目。
- 状态管理中的 reducer 返回新对象(如 Redux Toolkit 已默认用 structuredClone 做 devtools 快照)
- 配置合并:const finalConfig = structuredClone(defaults); Object.assign(finalConfig, userConfig);
- 表单数据快照、撤销/重做缓存
- Worker 线程间传递复杂数据(原生支持 Transferable,比 postMessage + JSON 更高效)
兼容性与降级方案
Chrome 98+、Firefox 97+、Safari 15.4+、Node.js 17+ 已原生支持。生产环境建议加一层检测:
function safeDeepClone(obj) {
if (typeof structuredClone === 'function') {
try {
return structuredClone(obj);
} catch (e) {
// 如遇 transfer 错误或不支持类型,回退
}
}
// 降级:JSON 方案(仅限简单数据)或轻量 polyfill(如 via MessageChannel)
return JSON.parse(JSON.stringify(obj));
}
注意不能直接替换的边界情况
如果旧代码中 $.extend 复制了以下内容,structuredClone 会静默丢弃或报错:
- 函数(method: () => {})、箭头函数、class 方法
- Promises、async 函数返回值
- DOM 元素、document、window、XMLHttpRequest 实例
- undefined、NaN、Infinity(structuredClone 支持这些值,但 JSON 不支持;注意 undefined 在对象属性中会被忽略)
- 带 getter/setter 的对象属性(值不会被读取,setter 不触发)
遇到这类数据,需提前剥离逻辑,或保留 jQuery.extend 仅用于特定模块,而非全局替换。

















