JSON.stringify 会导致值消失吗?通过安全的数据验证 undefined、NaN 以及日期的变化

プログラミング・Web開発カテゴリを表すパンダのイラスト 编程・Web开发

关于本文
本文是通过利用生成式 AI 的自动化生成流程创建的。我们将 JavaScript 的 JSON 转换规范与官方文档进行了核对,并在 JavaScript 运行环境中确认了使用虚拟数据的转换结果。尚未确认教材中包含的 Node.js 测试文件本身以及在 WordPress 上的显示效果。

验证状态:🧪 已确认虚拟数据的转换结果。Node.js 教材测试及正式环境界面尚未确认。

“保存时好好的配置值,重新读取后却消失了”。如果发生了这种现象,在怀疑文件写入失败之前,请先观察一下转换为 JSON 的那一刻。JavaScript 对象和 JSON 虽然相似,但并非完全相同。因为 JSON 是可以作为字符串传递的数据格式,但它并不能原封不动地表现 JavaScript 中的所有值。

这次我们不使用实际的配置文件或 API,而是转换虚拟的订单号和数值。乍看之下 JSON 似乎正常生成了,但只有值的含义发生了变化然而这是一个重要的观察点。

首先尝试:对比转换前后

无需安装额外软件包。我们将假定基于 Node.js 20 及更高版本的教材放置在了Daily Code 的完成版与 README中。预计会在下载的教材文件夹中执行 node app.mjs。这里使用的所有输入均为虚拟数据,既不会向外部发送也不会修改实际文件。

教材中包含 app.mjs、test.mjs、README.md,它将实现与检查分离开来。无需粘贴实际的业务数据。程序首先会显示转换后的 JSON 字符串,然后用布尔值展示原始值与重新读取的值之间的差异。

以下摘录即为作为观察对象的输入。

const input = {
  id: "DUMMY-001",
  optional: undefined,
  score: NaN,
  limit: Infinity,
  at: new Date("2026-01-01T00:00:00.000Z"),
  items: ["A", undefined, "C"]
};
const json = JSON.stringify(input);
const restored = JSON.parse(json);
console.log(json);

在 JavaScript 运行环境中确认的 JSON 字符串形态如下。这并不是美化过后的说明用虚拟示例,而是转换上述值的结果。

{"id":"DUMMY-001","score":null,"limit":null,"at":"2026-01-01T00:00:00.000Z","items":["A",null,"C"]}

这里有了第一个发现。optional 连同键一起消失了。另一方面,位于数组中间的 undefined 已变为 null。即使是相同的 undefined,输出结果也会因所处位置的不同而有所差异。

在哪里发生了变化?通过图示了解处理流程

下图并非描绘存储端的故障。数值发生变化,是因为经历了保存前的字符串化以及之后的读取还原这两个分界点。从左到右追踪会发现,丢失的类型和值仅凭 JSON.parse 是无法恢复的。

flowchart LR
  A["JavaScriptの値"] --> B["JSON.stringify"]
  B --> C["JSON文字列: 省略・null・文字列"]
  C --> D["JSON.parse"]
  D --> E["別のJavaScript値"]

图的最右侧并非最左侧的完整副本。例如日期 Date 对象会作为表示日期时间的 ISO 格式字符串进入 JSON 中。即使读回也依然是字符串,因此在使用日期方法之前需要进行显式转换。但是,如果将接收到的任意字符串无条件转换为日期,则会引发另一个问题。预先设计好哪些字段应当转换为日期至关重要。

逐一理解数值消失的原因

JSON.stringify 当对象的属性值为 undefined 时,该属性会从输出中省略。也就是说,optional: undefined 在 JSON 中会变成“不存在 optional 这一项本身”的状态。将其视为与 optional: null 相同的含义是有风险的。因为在 API 的更新处理中,“不指定”和“明确清空”可能会被设计为具有不同的含义。

数组的情况则有所不同。["A", undefined, "C"] 的中间元素会作为 null 保留下来。这是为了保持数组位置的行为,但这样一来,“值曾是未定义”的信息就丢失了。不能仅仅因为元素数量没有改变就判断它是正确的。在与 CSV 列或屏幕行号进行核对的处理中,不仅需要检查数量,还必须确认各个元素的含义。

NaN 是一个特殊值,表示数值计算未能得出有效数字。Infinity 是一个表示无穷大的数值。由于这两者都无法作为 JSON 中的常规数值来表示,因此JSON.stringify 那么 null 将变为。即使读回的一方查看 null,也无法区分原本是 NaN 还是 Infinity,抑或是从一开始就是 null。如果是监控数据或聚合值,在其他字段中保留缺失原因会更安全。

Date 内部是一个包含日期的对象,但在 JSON 中通常会变成字符串。此处的 at 将变为 "2026-01-01T00:00:00.000Z"。末尾的 Z 表示 UTC。如果需要将其转换为日本时间显示,则还需要处理时区,因此仅仅重新显示字符串并不一定符合用户期望的时间表达方式。

只更改一个条件进行比较

将最初的 score: NaN 修改为 score: 0,然后再次进行 JSON.stringify。这次 JSON 中的 score 将不再是 null,而是变为 0。零是测量出的数值,而 NaN 是无法计算的值,两者的业务含义完全不同。例如,在销售统计中,需要避免混淆到底是销售额为零件,还是由于输入异常而无法进行统计。

接下来将 optional: undefined 替换为 optional: null 后,optional 的键将会保留。这表明,即使“没有数据”的外观相同,传达给接收方的信息也是不同的。不过,究竟该采用哪种方式取决于 API 或存储格式的约定。将值一概替换为 null 并不一定总是正确的。

在进行比较时,请勿同时修改多个项目。首先只更改一个项目并观察差异,这样更容易追溯是由哪个转换规则引起的。教材中的 audit 函数是用作分别判断消失的属性、特殊数值、日期以及数组变化的辅助工具。

隔离失败与边界条件

到目前为止的例子都是生成 JSON 字符串的情况。然而,并非所有输入都会成功。例如,以常规方式包含 BigInt 将会引发 TypeError。包含循环引用的对象也无法直接转换为 JSON。如果发生异常,请不要断定是文件或通信问题,而应首先检查输入的类型和引用结构。

JSON.stringify(undefined) 的返回值是 JavaScript 的 "undefined",而不是字符串 undefined。如果直接将其传递给 JSON.parse,将无法进行解析。这与对象中未定义的值被省略的行为也有所不同。确认整个输入是否为可转换为 JSON 的值非常重要。

此外,JSON.parse 的结果中并没有自动还原 Date 或 NaN 的功能。所需的类型应通过架构和转换处理明确指定。在保存或通信前的检查中,不仅要检查转换是否不抛出异常,还要检查重要字段的缺失、数值的有效性以及读回后的类型。

如何在业务中进行区分使用

在记录日志或通过API发送数据之前,仅凭“已成功转换为JSON所以是安全的”这一判断未免为时过早。我们应当列出诸如订单号、金额、期限、缺失原因等一旦丢失就会带来麻烦的项目,并在发送前检查数值的类型和范围。特别是对于金额,Number.isFinite需要制定个性化规则,例如使用它来仅接受有限的数值;对于日期,则需确定输入格式并验证其有效性。

另一方面,对于屏幕显示等临时信息,undefined省略某些项目有时正是符合预期的做法。关键不在于避开JSON转换本身,而在于设计一份关于保留哪些数值的契约。只要发送方和接收方理解相同的架构,事后就不需要再去猜测“消失的数值”了。本教材旨在通过小型输入来观察JSON的基本数据丢失现象。它不提供加密、敏感信息掩码、完全复制或数据库事务。在将其应用于实际系统之前,请另外确认目标API的规范、异常值的处理、日志中混入敏感信息的防范以及多个版本间的兼容性。

官方信息与验证范围

MDN: JSON.stringify

本次虚构输入的字符串化与读取操作已在JavaScript执行环境中进行了比较。这并不意味着在Node.js中执行了Node.js专用的教材测试文件,也不意味着已在Windows/macOS或浏览器屏幕上进行了确认,更不意味着已在WordPress中进行了显示。请同时注意官方资料链接中的规范与实际实现环境之间的差异。

文档信息

文章??
JSON.stringify 会导致值消失吗?通过安全的数据验证 undefined、NaN 以及日期的变化
?布日期
更新日期
来源
https://papanda925.com/?p=18641&lang=zh

?可: ?于本站?有相??利的正文及原??表,除非?有?明,可依据 CC BY 4.0 使用。本文可能包含使用生成式AI?建或??的内容。若代??有?可声明,或?接的GitHub???定了?可,?代?以??可?准。引用内容、第三方?料、?片及商?不在本?可范?内。 使用政策

标题和URL已复制