devalue错误处理完全指南如何准确定位和解决序列化问题【免费下载链接】devalueGets the job done when JSON.stringify cant项目地址: https://gitcode.com/gh_mirrors/de/devaluedevalue 是一个 JavaScript 数据序列化库当JSON.stringify搞不定时循环引用、Date、Map/Set、BigInt、甚至 Promise它能接管工作。它的devalue 错误处理同样贴心——序列化失败时抛出的错误自带path属性能帮你毫秒级定位问题值藏在哪里。1. 认识 DevalueErrordevalue 错误处理的定位器uneval/stringify遇到无法序列化的数据时会抛出专门错误类型DevalueError错误对象上带有 4 个内置属性属性含义示例message人类可读的错误原因Cannot stringify a functionpath问题值在输入数据中的完整路径.foo.array[0]value无法被序列化的那个具体值出错的函数本身root正在序列化的根数据你传入的整个对象import { uneval, DevalueError } from devalue; try { uneval({ object: { array: [new Map([[key, function invalid() {}]])] } }); } catch (e) { if (e instanceof DevalueError) { console.log(e.path); // .object.array[0].get(key) } }path的格式很有讲究对象属性写成.foo或[string-key]数组下标写成[0]Map 条目写成.get(key)。你可以在 test/index.test.js 中看到各种path的真实断言。DevalueError的完整定义见 src/utils.js官方还导出了它供catch中做instanceof判断见 index.js。2. 六大常见序列化错误清单devalue 会在以下 6 种情况抛出DevalueError先对照表格判断自己踩中了哪一条错误信息触发原因快速解法Cannot stringify a function数据里含函数用 reducer 只保留可序列化字段Cannot stringify a Symbol primitive数据含裸Symbol换成字符串或数字Cannot stringify a Promise or thenable用stringify传了 Promise改用stringifyAsyncCannot stringify arbitrary non-POJOs有未注册的类实例添加对应 reducerCannot stringify POJOs with symbolic keys对象含 Symbol 键移除 Symbol 键Cannot stringify objects with __proto__ keys对象含__proto__键移除该键安全防护机制这些错误统一从序列化核心 src/stringify.js 和 uneval 实现 src/uneval.js 中抛出。3. 四种快速解决方法3.1 用 reducer 给自定义类型注册户口大多数non-POJOs错误都因为 devalue 不认识你的类。给stringify传第二个参数即可const stringified devalue.stringify(new Vector(30, 40), { Vector: (value) value instanceof Vector [value.x, value.y] });⚠️ 注意reducer 返回 truthy 值才被视为命中。上面的写法保证了非Vector实例返回false不会误伤普通数组。3.2 Promise 交给 stringifyAsyncstringify是同步的天然无法等待 Promise——报错时它会直接告诉你use stringifyAsync instead。let stringified await devalue.stringifyAsync({ quick: data, slow: fetch(/api/slow).then((r) r.json()) });Promise 会被等待并序列化其解析值输出格式与stringify完全一致parse无需任何改动。3.3 uneval 用 replacer 处理自定义类型走uneval路线时用 replacer 返回可直接eval的 JS 代码devalue.uneval(vector, (value, uneval) { if (value instanceof Vector) { return new Vector(${value.x},${value.y}); } }); // new Vector(30,40)注意replacer 中引用的变量如Vector必须在代码执行时处于作用域内。3.4 用 instanceof 统一错误上报把DevalueError接入你的监控体系e.path就是现成的报错定位信息try { devalue.stringify(data); } catch (e) { if (e instanceof devalue.DevalueError) { reportError({ path: e.path, message: e.message }); } throw e; }更多使用姿势可参考 README.md 的 Custom types 与 Error handling 章节。4. 反序列化parse阶段的错误处理parse/unflatten遇到非法数据时抛出的是普通Error而非DevalueError常见信息包括Invalid input—— 结构不符合 devalue 编码格式Invalid circular reference—— 循环引用索引非法Cannot parse an object with aprotoproperty—— 安全防护Invalid ArrayBuffer encoding—— Base64 编码损坏相关校验逻辑集中在 src/parse.js。 特别提醒devalue 官方明确表示不保证不同版本间的序列化格式兼容。跨版本新库序列化 旧库解析或反之可能直接报错请保持序列化端与反序列化端使用同一版本。5. devalue 错误处理自查清单✅ 用e instanceof DevalueError而不是字符串匹配来捕获错误✅ 打印e.path而不是整个e.root日志更干净✅ 自定义类都配好了 reducerstringify reviverparse一对✅ 数据含 Promise 时切换到了stringifyAsync✅ 序列化端与反序列化端的 devalue 版本一致照着这份清单排查绝大多数 devalue 序列化报错都能在 5 分钟内定位并修复 【免费下载链接】devalueGets the job done when JSON.stringify cant项目地址: https://gitcode.com/gh_mirrors/de/devalue创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考