ProseMirror中Node.toJSON()方法的属性对象浅拷贝问题解析

在ProseMirror文档处理过程中，开发者经常需要将节点(Node)转换为JSON格式进行操作。最近发现一个值得注意的技术细节：Node.toJSON()方法返回的对象中，attrs属性采用的是浅拷贝方式。

问题现象

当开发者使用Node.toJSON()方法获取节点的JSON表示时，返回的对象中attrs属性实际上是对原始节点属性对象的引用。这意味着：

1. 如果直接修改返回的JSON对象中的attrs属性
2. 原始节点的属性也会被意外修改
3. 后续再次调用toJSON()会得到被修改后的结果

技术原理

ProseMirror在设计toJSON()方法时，出于性能考虑，对于已经是JSON可序列化的属性对象(attrs)没有进行深拷贝。这是因为：

1. 属性对象本身已经是纯JavaScript对象
2. 深拷贝会带来额外的性能开销
3. 设计初衷是认为返回的JSON应该只用于序列化，不应该被修改

解决方案

如果需要修改返回的JSON对象中的属性，正确的做法是：

1. 先对attrs对象进行深拷贝
2. 然后在新对象上进行修改
3. 最后使用修改后的新对象

示例代码：

// 错误做法：直接修改toJSON()返回的对象
const json = node.toJSON()
delete json.attrs.id // 这会同时影响原始节点

// 正确做法：先拷贝再修改
const json = node.toJSON()
const newAttrs = {...json.attrs} // 创建新对象
delete newAttrs.id
const modifiedJson = {...json, attrs: newAttrs}

最佳实践建议

1. 将toJSON()返回的对象视为只读
2. 任何修改操作都应该在新对象上进行
3. 对于需要频繁修改的场景，考虑封装工具函数
4. 注意JSONContent类型的处理要保持不可变性

总结

理解ProseMirror中toJSON()方法的这一特性非常重要，特别是在需要操作节点JSON表示的场景下。通过遵循先拷贝后修改的原则，可以避免意外的副作用，确保文档处理的正确性和一致性。这一设计体现了ProseMirror在性能和安全性之间的平衡考量，开发者需要在使用时保持这一意识。