structuredClone()能深度克隆可序列化数据,避免异步任务中原始数据被意外修改;它支持Object、Array、Map、Set等类型,但不支持函数、Symbol、DOM节点等,需提前清洗或降级处理。

用 structuredClone() 复制数据包,能确保异步任务执行时操作的是独立副本,原始数据不会被后续修改影响。
为什么需要 structuredClone() 而不是浅拷贝
JavaScript 中直接赋值或展开运算符(...)只能做浅拷贝,嵌套对象、数组、Map/Set 等仍共享引用。异步任务若在延时后修改深层字段,可能意外改写原始数据包。而 structuredClone() 是深度克隆,支持大多数可序列化类型(Object、Array、Date、RegExp、ArrayBuffer、TypedArray、DataView、Map、Set、Blob、File、ImageData 等),且不触发 getter/setter 或循环引用错误(会抛出异常提示)。
在任务入队时立即克隆数据包
不要等到任务执行时再克隆——那样无法防止入队后、执行前的原始数据被改写。应在创建任务并推入队列前完成克隆:
- 把原始数据包传给封装好的任务生成函数
- 函数内部调用
structuredClone(input)得到干净副本 - 将副本与处理逻辑一起构造成 Promise 或任务对象
例如:
const taskQueue = [];
function enqueueTask(originalPacket, handler) {
// 入队瞬间就克隆,锁定此刻状态
const safeCopy = structuredClone(originalPacket);
const task = () => handler(safeCopy);
taskQueue.push(task);
}
// 后续即使 originalPacket.name = "hacked",也不影响已入队任务
注意边界:哪些不能克隆?
structuredClone() 不支持函数、undefined、Symbol、WeakMap、WeakSet、Error 对象、DOM 节点等。如果数据包含这些,克隆会失败并抛出 DataCloneError。应对策略包括:
- 提前清洗数据包:移除或序列化函数/Symbol(如转为字符串 ID)
- 对不可克隆字段做特殊处理(如用
JSON.stringify+JSON.parse替代,但会丢失类型和原型) - 捕获错误并降级处理,避免静默失败
结合 Promise 队列控制执行顺序
克隆解决数据隔离,但不保证执行时机。若需严格串行执行多个克隆后的任务,可用 Promise 链式排队:
let queuePromise = Promise.resolve();
function serialEnqueue(originalPacket, handler) {
const safeCopy = structuredClone(originalPacket);
queuePromise = queuePromise.then(() => handler(safeCopy));
}
这样每个任务都在前一个完成后才开始,且都基于各自独立的克隆副本运行,彻底解耦。

















