structuredClone() 无法克隆 Error 实例，因其内部状态（如 stack、cause、原型链）不可枚举且不可序列化，违反 HTML 结构化克隆算法规范；推荐预先将 Error 替换为普通对象再克隆。
structuredClone() 本身无法直接克隆 Error 实例，调用时会抛出 DataCloneError（例如 “TypeError: Error: An object could not be cloned.”）。这不是 bug，而是规范限制——Error 对象含有不可枚举、不可序列化的内部状态（如 stack、cause 的某些形态、绑定的原型链等），不在 structuredClone 支持的可转移类型列表中。
为什么 Error 实例无法被 structuredClone()
structuredClone 基于 HTML 结构化克隆算法，只支持特定类型的值：基本类型、普通对象、数组、Map、Set、Date、RegExp、ArrayBuffer 及其视图、Blob、File、ImageData 等。而 Error 及其子类（SyntaxError、TypeError 等）**明确被排除在外**。即使对象只是“包含”一个 Error 实例（如 { err: new Error('oops') }），整个克隆操作也会失败。
推荐方案：预先剥离或替换 Error 实例
在调用 structuredClone 前，遍历原始对象，将所有 Error 实例替换成可克隆的轻量表示（如 plain object），克隆完成后再按需恢复（如仅用于日志或调试，通常不需要真正恢复为 Error 实例）：
- 对简单场景，可用递归函数提取
name、message、stack（注意 stack 在某些环境可能不可读）生成 POJO - 使用
JSON.parse(JSON.stringify(obj, (k, v) => v instanceof Error ? { name: v.name, message: v.message, stack: v.stack } : v ))是常见替代，但有缺陷（丢失函数、undefined、循环引用、正则、日期精度等） - 更健壮的做法是手写一个兼容 structuredClone 输入要求的“净化”函数，只处理 Error，其余结构保持原样供后续 structuredClone 使用
示例：安全封装的 cloneWithErrorsHandled()
以下函数在克隆前将 Error 实例序列化为普通对象，不改变其他值，确保 structuredClone 成功：
function cloneWithErrorsHandled(obj) {
function walk(value) {
if (value instanceof Error) {
return {
__isError: true,
name: value.name,
message: value.message,
stack: value.stack,
cause: value.cause ? walk(value.cause) : undefined
};
}
if (value && typeof value === 'object') {
if (Array.isArray(value)) {
return value.map(walk);
}
const result = {};
for (const [k, v] of Object.entries(value)) {
result[k] = walk(v);
}
return result;
}
return value;
}
const sanitized = walk(obj);
return structuredClone(sanitized);
}
// 使用
const data = { user: 'Alice', error: new TypeError('Invalid input') };
const cloned = cloneWithErrorsHandled(data);
// → { user: 'Alice', error: { __isError: true, name: 'TypeError', message: 'Invalid input', stack: '...', cause: undefined } }
补充说明：何时真需要克隆 Error？
绝大多数情况下，你并不需要运行时“克隆”一个 Error 实例。Error 主要用于抛出和捕获，其堆栈追踪依赖创建时的调用栈。若目标是持久化错误信息（如上报、记录），序列化为 plain object 完全足够；若需在另一上下文中重新 throw，应新建 Error 实例，而非试图复用旧实例。因此，规避 structuredClone 报错的本质，是明确数据用途并选择合适的数据形态，而非强行绕过限制。
