JavaScript 函数 JSON.stringify

JSON.stringify 函数 (JavaScript)

将 JavaScript 值转换为 JavaScript 对象表示法 (Json) 字符串。

语法

JSON.stringify(value [, replacer] [, space])

参数

value

必需。  要转换的 JavaScript 值（通常为对象或数组）。  

replacer

可选。  用于转换结果的函数或数组。  

如果 replacer 为函数，则 JSON.stringify 将调用该函数，并传入每个成员的键和值。  使用返回值而不是原始值。  如果此函数返回undefined，则排除成员。  根对象的键是一个空字符串：""。  

如果 replacer 是一个数组，则仅转换该数组中具有键值的成员。  成员的转换顺序与键在数组中的顺序一样。  当value 参数也为数组时，将忽略 replacer 数组。  

space

可选。  向返回值 JSON 文本添加缩进、空格和换行符以使其更易于读取。  

如果省略 space，则将生成返回值文本，而没有任何额外空格。

如果 space 是一个数字，则返回值文本在每个级别缩进指定数目的空格。  如果space 大于 10，则文本缩进 10 个空格。  

如果 space 是一个非空字符串（例如“\t”），则返回值文本在每个级别中缩进字符串中的字符。

如果 space 是长度大于 10 个字符的字符串，则使用前 10 个字符。

返回值

一个包含 JSON 文本的字符串。