您现在的位置是：亿华云 > 数据库

你不知道的 JSON.stringify！！！

亿华云2025-10-03 18:10:58【数据库】3人已围观

简介JSON.stringify是我们经常用到的的一个方法，它主要作用是将 JavaScript 值和对象转换为字符串。如：JSON.stringify({foo:"bar"});//=>{"foo

JSON.stringify是不知我们经常用到的的一个方法，它主要作用是不知将 JavaScript 值和对象转换为字符串。如：

JSON.stringify({ foo: "bar" }); // => { "foo":"bar"} JSON.stringify(123); // => 123

但是不知JS 的许多地方都有问题，这个函数也不例外。不知我们可能会想象一个叫做 "stringify "的不知函数总是返回一个字符串......但它并没有!

例如，如果你尝试 stringify undefined，不知它返回 undefined ，不知而不是不知一个字符串。

JSON.stringify(undefined); // => undefined

接下来，不知我将分两部分讲：

列举 JSON.stringify 不返回字符串的不知情况我们将如何避免这些陷阱

什么时候 JSON.stringify 不返回字符串?

undefined、任意的不知函数以及 symbol 值，在序列化过程中会被忽略(出现在非数组对象的不知属性值中时)或者被转换成 null(出现在数组中时)。函数、不知undefined 被单独转换时，不知会返回 undefined。不知

对包含循环引用的对象(对象之间相互引用，形成无限循环)执行此方法，会抛出错误

我认为 JSON.stringify 能够返回字符串以外的东西是挺惊讶的。云服务器但在6种情况下，它可以返回undefined:

试图在顶层对 undefined 进行序列化，会返回 undefined。

JSON.stringify(undefined); // => undefined

尝试序列化函数也会返回 undefined。对于常规函数、箭头函数、异步函数和生成器函数都是如此。

JSON.stringify(function foo() { }); // => undefined JSON.stringify(() => { }); // => undefined function bar() { } bar.someProperty = 123; JSON.stringify(bar); // => undefined

尝试序列化symbol 也会返回 undefined。

JSON.stringify(Symbol("computers were a mistake")); // => undefined

在浏览器中，试图序列化被废弃的document.all 也会返回 undefined。

// => undefined

这只影响到浏览器，因为document.all在其他环境中是不可用的，比如Node。

带有 toJSON 函数的对象将被运行，而不是试图正常地序列化它们。但是如果 toJSON 返回上面的一个值，试图在顶层序列化它将导致 JSON.stringify 返回undefined。

JSON.stringify({ toJSON: () => undefined }); // => undefined JSON.stringify({ ignored: true, toJSON: () => undefined }); // => undefined JSON.stringify({ toJSON: () => Symbol("heya") }); // => undefined

你可以传递第二个参数，称为 "replacer"，它可以改变序列化的逻辑。如果这个函数为顶层返回上述值之一，JSON.stringify 将返回undefined。

JSON.stringify({ ignored: true }, () => undefined); // => undefined JSON.stringify(["ignored"], () => Symbol("hello")); // => undefined

需要注意的是亿华云，其中的许多东西实际上只影响到顶层的序列化。例如，JSON.stringify({ foo: undefined})，返回字符串"{ }"，这并不令人惊讶。

我还想提一下，TypeScript的类型定义在这里是不正确的。例如，下面的代码类型的校验可以通过：

const result: string = JSON.stringify(undefined);

在第2部分中，我们将讨论如何更新 TypeScript 的定义以确保其正确性。

JSON.stringify 也可能遇到问题，导致它抛出一个错误。在正常情况下，有四种情况会发生：

循环引用会导致抛出一个类型错误。

const b = { a }; a.b = b; JSON.stringify(a); // => TypeError: cyclic object value

注意，这些错误消息在不同浏览器可能提示是不样的，例如，Firefox 的错误信息与Chrome的不同。

BigInts不能用JSON.stringify 进行序列化，这些也会导致一个TypeError。网站模板

JSON.stringify(12345678987654321n); // => TypeError: BigInt value cant be serialized in JSON JSON.stringify({ foo: 456n }); // => TypeError: BigInt value cant be serialized in JSON

带有 toJSON 函数的对象将被运行。如果这些函数抛出错误，它将冒泡到调用者。

const obj = { foo: "ignored", toJSON() { throw new Error("Oh no!"); }, }; JSON.stringify(obj); // => Error: Oh no!

你可以传递第二个参数，称为 replacer。如果这个函数抛出一个错误，它将冒泡。

JSON.stringify({ }, () => { throw new Error("Uh oh!"); }); // => Error: Uh oh!

现在我们已经看到了 JSON.stringify 不返回字符串的情况，接下来，我们来看看如何避免这些问题。