news 2026/5/5 18:34:28

vue3中DataCloneError: Failed to execute ‘structuredClone‘ on ‘Window‘: #<Object> could not be cloned

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
vue3中DataCloneError: Failed to execute ‘structuredClone‘ on ‘Window‘: #<Object> could not be cloned
// 监视信息对话框状态,同步数据 watch(infoDialogVisible, (newValue) => { if (newValue) { // 对话框打开时,从store复制数据到本地副本 const sourceData = capitalInfoStore.currentSelectedCapitalInfo || emptyCapitalInfo; // Object.assign(localCapitalInfo, sourceData); // ❌浅拷贝:直接引用源对象,修改源数据可能影响目标,修改localCapitalInfo会影响sourceData,从而影响emptyCapitalInfo // Object.assign(localCapitalInfo, { ...sourceData }); // ✅浅拷贝:创建新对象,与源对象解耦,与源数据隔离,更安全,修改localCapitalInfo不会影响sourceData和emptyCapitalInfo // Object.assign(localCapitalInfo, JSON.parse(JSON.stringify(sourceData))); // ✅深拷贝:因为localCapitalInfo为reactive对象,不能直接赋值,如果是ref对象,可以 localCapitalInfo.value = JSON.parse(JSON.stringify(sourceData)); Object.assign(localCapitalInfo, structuredClone(sourceData)); // ✅深拷贝:现代浏览器原生方法 // 文件选择器实例清空资源,以便可以继续选择文件,不然会提示文件限制 baseFileSelectorRef.value?.cleanupResources(); } }); 报错:CapitalInfo.vue:415 Uncaught (in promise) DataCloneError: Failed to execute 'structuredClone' on 'Window': #<Object> could not be cloned. at CapitalInfo.vue:415:1

这个错误是因为structuredClone无法克隆某些特殊类型的对象。在你的场景中,sourceData很可能包含:

  1. Vue3 的响应式代理对象(reactive/proxy)

  2. 函数或方法

  3. Symbol 类型的属性

  4. 循环引用

  5. 特殊的 DOM 对象

解决方案

方案1:使用JSON.parse(JSON.stringify())(推荐)

typescript

watch(infoDialogVisible, (newValue) => { if (newValue) { const sourceData = capitalInfoStore.currentSelectedCapitalInfo || emptyCapitalInfo; // ✅ 使用 JSON 方法进行深拷贝 Object.assign(localCapitalInfo, JSON.parse(JSON.stringify(sourceData))); baseFileSelectorRef.value?.cleanupResources(); } });

方案2:使用toRaw()剥离响应式代理

typescript

import { toRaw } from 'vue'; watch(infoDialogVisible, (newValue) => { if (newValue) { const sourceData = capitalInfoStore.currentSelectedCapitalInfo || emptyCapitalInfo; // ✅ 先剥离响应式代理,再使用 structuredClone const rawData = sourceData === emptyCapitalInfo ? sourceData : toRaw(sourceData); Object.assign(localCapitalInfo, structuredClone(rawData)); baseFileSelectorRef.value?.cleanupResources(); } });

方案3:使用lodash.cloneDeep

typescript

import { cloneDeep } from 'lodash-es'; watch(infoDialogVisible, (newValue) => { if (newValue) { const sourceData = capitalInfoStore.currentSelectedCapitalInfo || emptyCapitalInfo; // ✅ 使用 lodash 的深拷贝 Object.assign(localCapitalInfo, cloneDeep(sourceData)); baseFileSelectorRef.value?.cleanupResources(); } });

方案4:安全的structuredClone封装

typescript

function safeStructuredClone(obj: any): any { try { // 尝试使用 structuredClone return structuredClone(obj); } catch (error) { console.warn('structuredClone failed, falling back to JSON:', error); // 降级到 JSON 方法 return JSON.parse(JSON.stringify(obj)); } } watch(infoDialogVisible, (newValue) => { if (newValue) { const sourceData = capitalInfoStore.currentSelectedCapitalInfo || emptyCapitalInfo; // ✅ 使用安全的深拷贝函数 Object.assign(localCapitalInfo, safeStructuredClone(sourceData)); baseFileSelectorRef.value?.cleanupResources(); } });

方案5:处理函数和特殊类型的深拷贝

typescript

function deepCloneForVue(obj: any): any { // 处理基本类型 if (obj === null || typeof obj !== 'object') { return obj; } // 处理数组 if (Array.isArray(obj)) { return obj.map(item => deepCloneForVue(item)); } // 处理普通对象(剥离 Vue 的响应式代理) const rawObj = toRaw(obj); const cloned = {}; for (const key in rawObj) { // 跳过 Vue 的内部属性 if (key.startsWith('__v_')) continue; const value = rawObj[key]; // 处理函数 if (typeof value === 'function') { // 可以保留函数引用,或者创建一个新的绑定 cloned[key] = value.bind(cloned); } // 处理 Date else if (value instanceof Date) { cloned[key] = new Date(value.getTime()); } // 递归处理对象 else if (value && typeof value === 'object') { cloned[key] = deepCloneForVue(value); } // 基本类型 else { cloned[key] = value; } } return cloned; } watch(infoDialogVisible, (newValue) => { if (newValue) { const sourceData = capitalInfoStore.currentSelectedCapitalInfo || emptyCapitalInfo; // ✅ 使用自定义的 Vue 友好深拷贝 Object.assign(localCapitalInfo, deepCloneForVue(sourceData)); baseFileSelectorRef.value?.cleanupResources(); } });

针对你代码的最佳实践

考虑到你的数据类型CapitalInfo主要是基本类型和数组,推荐使用方案1方案3

推荐方案1:JSON 方法(最简单)

typescript

watch(infoDialogVisible, (newValue) => { if (newValue) { const sourceData = capitalInfoStore.currentSelectedCapitalInfo || emptyCapitalInfo; // ✅ 简单可靠,适用于你的数据结构 Object.assign(localCapitalInfo, JSON.parse(JSON.stringify(sourceData))); baseFileSelectorRef.value?.cleanupResources(); } });

推荐方案3:使用 lodash(最专业)

typescript

import { cloneDeep } from 'lodash-es'; watch(infoDialogVisible, (newValue) => { if (newValue) { const sourceData = capitalInfoStore.currentSelectedCapitalInfo || emptyCapitalInfo; // ✅ 专业可靠的深拷贝 Object.assign(localCapitalInfo, cloneDeep(sourceData)); baseFileSelectorRef.value?.cleanupResources(); } });

为什么structuredClone会失败?

在你的情况下,最可能的原因是:

  1. sourceData 是 Vue 的响应式代理对象

    • structuredClone无法克隆 Proxy 对象

    • 需要使用toRaw()先获取原始对象

  2. 对象中包含 Vue 的内部属性

    • __v_skip__v_isRef

    • 这些是 Vue 内部使用的,不可克隆

  3. 可能有循环引用

    • 虽然你的数据结构看起来没有,但 Vue 的响应式系统可能会创建

完整修复示例

typescript

import { watch } from 'vue'; import { cloneDeep } from 'lodash-es'; // 监视信息对话框状态,同步数据 watch(infoDialogVisible, (newValue) => { if (newValue) { // 对话框打开时,从store复制数据到本地副本 const sourceData = capitalInfoStore.currentSelectedCapitalInfo || emptyCapitalInfo; // ✅ 最佳方案:使用 lodash 的 cloneDeep Object.assign(localCapitalInfo, cloneDeep(sourceData)); // 或者使用 JSON 方法(如果确定没有函数、Date等特殊类型) // Object.assign(localCapitalInfo, JSON.parse(JSON.stringify(sourceData))); // 文件选择器实例清空资源,以便可以继续选择文件,不然会提示文件限制 baseFileSelectorRef.value?.cleanupResources(); } });

总结

方案优点缺点推荐度
JSON.parse(JSON.stringify())简单、无需依赖、处理大部分基本类型丢失函数、Date、undefined等⭐⭐⭐⭐
lodash.cloneDeep功能全面、可靠、保留更多类型需要引入第三方库⭐⭐⭐⭐⭐
toRaw + structuredClone浏览器原生、性能好需要处理Vue代理、可能仍有兼容问题⭐⭐
自定义深拷贝函数完全可控、可定制实现复杂、容易出错⭐⭐

根据你的错误信息和数据结构,推荐用lodash.cloneDeepJSON.parse(JSON.stringify())

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/5/5 18:34:27

轻量级CAD解决方案:免费开源工具的全方位测评

轻量级CAD解决方案&#xff1a;免费开源工具的全方位测评 【免费下载链接】LitCAD A very simple CAD developed by C#. 项目地址: https://gitcode.com/gh_mirrors/li/LitCAD 在CAD设计领域&#xff0c;专业软件往往伴随着高昂的授权费用和复杂的学习曲线&#xff0c;这…

作者头像 李华
网站建设 2026/5/3 6:15:02

探索TVBoxOSC:解锁电视盒子的复古游戏潜能

探索TVBoxOSC&#xff1a;解锁电视盒子的复古游戏潜能 【免费下载链接】TVBoxOSC TVBoxOSC - 一个基于第三方项目的代码库&#xff0c;用于电视盒子的控制和管理。 项目地址: https://gitcode.com/GitHub_Trending/tv/TVBoxOSC 在数字娱乐多元化的今天&#xff0c;如何将…

作者头像 李华
网站建设 2026/5/3 3:40:15

Qwen3-VL-4B Pro效果展示:旅游景点照→文化背景解读+游览建议

Qwen3-VL-4B Pro效果展示&#xff1a;旅游景点照→文化背景解读游览建议 1. 这不是“看图说话”&#xff0c;而是真正读懂一张旅行照片 你有没有试过拍下一座古塔、一扇雕花木门、或是一处人迹罕至的石窟&#xff0c;却对它背后的故事一无所知&#xff1f;手机相册里存着上百…

作者头像 李华
网站建设 2026/5/5 12:40:40

4个维度掌握Unity海洋渲染技术:Ceto进阶实战指南

4个维度掌握Unity海洋渲染技术&#xff1a;Ceto进阶实战指南 【免费下载链接】Ceto Ceto: Ocean system for Unity 项目地址: https://gitcode.com/gh_mirrors/ce/Ceto Unity海洋渲染技术是现代游戏开发中打造沉浸式水环境的核心环节。Ceto作为专为Unity设计的开源海洋系…

作者头像 李华
网站建设 2026/5/1 12:01:25

从零到一:Vivado与Vitis协同开发的五大实战技巧

从零到一&#xff1a;Vivado与Vitis协同开发的五大实战技巧 在FPGA和嵌入式系统开发领域&#xff0c;Xilinx的Vivado和Vitis工具链已经成为行业标准。但对于初学者而言&#xff0c;这两个工具的协同工作流程常常令人望而生畏。本文将分享五个关键实战技巧&#xff0c;帮助开发者…

作者头像 李华