structuredclone 在主流浏览器中基本可用但需运行时检测并降级：chrome 98+、firefox 94+、safari 15.4+、node.js 18.12+ 原生支持；ie、android webview、safari ≤15.3 等不支持；推荐用 typeof + try 验证，优先分层降级而非 polyfill。
structuredClone 在主流浏览器中已基本可用，但不是“开箱即用”，必须运行时检测并配合降级策略使用。
当前主流环境支持情况（截至2026年6月）
✅ 原生支持的环境：
- Chrome 98+、Edge 98+
- Firefox 94+（97 起更稳定）
- Safari 15.4+（注意：15.3 及更早版本会直接抛 ReferenceError: structuredClone is not defined）
- Node.js 18.12+ 默认启用；17.0+ 需启动参数 --experimental-structured-cloning
- Web Worker、Service Worker、Extension 的 content script / background 中均可直接调用
❌ 明确不支持的环境：
- IE 全系
- Android WebView（尤其旧版系统自带浏览器）
- Safari ≤15.3、部分国产安卓浏览器内核
- 低版本 Electron（取决于所打包的 Chromium 版本）
运行时检测比 UA 判断更可靠
不要依赖浏览器版本字符串，用最小成本验证 API 是否真实可用：
- 先检查函数是否存在：typeof structuredClone === 'function'
- 再加行为验证（防某些 WebView 声称支持却实际报错）：
try { structuredClone({}); } catch { /* 不可用 */ }
不推荐盲目引入 polyfill
目前没有被广泛采纳、能 100% 复刻原生行为（尤其是 transfer 选项和完整类型边界）的 polyfill。但有轻量实用的替代方案：
- @ungap/structured-clone：零依赖、自动检测原生支持，对 Map/Set/Date/RegExp/ArrayBuffer 等做合理模拟，不支持 transfer，适合大多数业务场景
- core-js-pure/actual/structured-clone：可按需导入，支持挂载到全局，兼容性覆盖更广（含部分老 Safari），体积略大
- 不建议自己写完整 polyfill —— 结构化克隆涉及对象图遍历、循环引用缓存、类型边界判断，极易遗漏边缘 case
更推荐：分层降级而非强行补全
根据数据特征和上下文需求，选择最匹配的替代方案：
-
纯 JSON 可序列化数据 → JSON.parse(JSON.stringify(obj))
✅ 兼容所有浏览器｜❌ 丢弃 undefined、Date 变字符串、RegExp 变空对象、不支持循环引用 -
需保留 Date/Map/undefined/循环引用，且允许异步 → MessageChannel
✅ 支持 Date 实例、Map/Set、undefined、循环引用｜❌ 异步、不支持函数/Symbol/WeakMap -
需同步 + 类型保真度中等 → 手动递归克隆（配 WeakMap 处理循环引用）
✅ 同步｜✅ 可定制处理 Date/RegExp/ArrayBuffer 等｜⚠️ 需自行管理引用缓存
关键边界类型必须提前清洗
无论是否使用原生或降级方案，以下类型均无法安全克隆，务必在调用前处理：
- 函数、DOM 节点（Element、document）、window、console —— 所有方案均不支持，建议剔除或转为标识符（如 { type: 'function', name: 'onClick' }）
- undefined —— JSON 方案会丢弃，MessageChannel 可保留，但接收方需确认语义是否允许
- 循环引用 —— JSON 方案必报错，递归方案需 WeakMap 缓存，MessageChannel 自动处理
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
