当前位置：首页 > 文章列表 > 文章 > 前端 > 使用structuredClone拷贝BigInt对象的完整方法如下：1.了解structuredClone的限制structuredClone是浏览器提供的用于深拷贝对象的方法，但它不支持BigInt类型。尝试拷贝包含BigInt的对象时，会抛出错误。constobj={value:BigInt(123)};constclone=structuredClone(obj);//报错：TypeErr

使用structuredClone拷贝BigInt对象的完整方法如下：1.了解structuredClone的限制structuredClone是浏览器提供的用于深拷贝对象的方法，但它不支持BigInt类型。尝试拷贝包含BigInt的对象时，会抛出错误。constobj={value:BigInt(123)};constclone=structuredClone(obj);//报错：TypeErr

2026-05-08 20:10:08 0浏览收藏

structuredClone() 是现代 JavaScript 中唯一原生支持 BigInt 深拷贝的可靠方案，不仅能精准保留 BigInt、Date、RegExp、Map、Set 及嵌套结构的类型和值，还避免了 JSON 方案因无法序列化 BigInt 而导致的崩溃或类型丢失问题；尽管它不支持函数、Symbol、循环引用等非结构化值，且需注意浏览器和 Node.js 版本兼容性（Chrome 98+、Firefox 94+、Safari 15.4+、Node.js 17.0+），但通过简单的存在性检测即可优雅降级为官方 polyfill 或 JSON 备选方案——对于金融计算、区块链 ID、高精度计数等强类型敏感场景，它是当前最简洁、安全、高效的深拷贝选择。

如何利用 structuredClone() 拷贝包含 BigInt 原始类型的现代化业务对象

structuredClone() 是现代 JavaScript 中最直接支持 BigInt 深拷贝的原生方法，无需手动遍历或第三方库。它能安全复制包含 BigInt、Date、RegExp、Map、Set、嵌套对象和数组等结构的业务对象，前提是运行环境支持（Chrome 98+、Firefox 94+、Safari 15.4+、Node.js 17.0+）。

确认运行环境是否支持 structuredClone()

老旧环境（如 Node.js < 17 或 IE/旧版 Safari）不支持该 API。建议先做兼容性检查：

用 typeof structuredClone === 'function' 判断是否存在
若不支持，可降级为 JSON.parse(JSON.stringify())（但会丢失 BigInt、undefined、函数、循环引用等）
更稳健的降级方案是使用 structured-clone（官方 polyfill，npm 包名同名）

直接拷贝含 BigInt 的业务对象

只要对象结构可被“结构化克隆算法”处理（即不包含函数、Promise、Window 等非可序列化值），structuredClone() 就能保留 BigInt 类型：

const order = {
  id: 123n, // BigInt 字段
  total: 999999999999999999999999999999n,
  items: [{ sku: 'A001', qty: 2n }],
  metadata: new Map([['createdBy', 1001n]])
};

const clone = structuredClone(order);
console.log(clone.id === order.id); // false（新引用）
console.log(typeof clone.id); // 'bigint'
console.log(clone.items[0].qty); // 2n
console.log(clone.metadata.get('createdBy')); // 1001n

注意不可克隆的类型和边界情况

structuredClone() 有明确的类型白名单。以下内容会抛出 DataCloneError 或被静默忽略：

函数、async function、箭头函数 —— 不允许克隆
undefined、Symbol、WeakMap、WeakSet —— 不在克隆范围内
带有循环引用的对象（如 obj.self = obj）—— 直接报错
Error 实例、HTMLElement 等宿主对象 —— 不支持

若业务对象中混入了上述类型，需提前清洗，例如剥离方法、替换 Symbol 键为字符串，或用自定义序列化逻辑预处理。

与 JSON 方案对比：为什么优先选 structuredClone()

传统 JSON.stringify() + JSON.parse() 在涉及 BigInt 时会直接失败：

JSON.stringify({ x: 123n }) 抛出 TypeError: Do not know how to serialize a BigInt
即使加 replacer 转为字符串，也会丢失原始类型（无法还原为 BigInt）
structuredClone() 自动保持类型 fidelity，且语义清晰、性能更好、无额外依赖

对现代化业务系统（尤其金融、高精度计数、区块链 ID 处理等场景），只要环境达标，structuredClone() 应作为含 BigInt 对象深拷贝的默认选择。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~