JSON.parse

JSON.parse()方法用来解析JSON字符串，构造由字符串描述的JavaScript值或对象。提供可选的reviver函数用以在返回之前对所得到的对象执行变换(操作)。

语法

JSON.parse(text[, reviver])

参数

text要被解析成JavaScript值的字符串，查看JSON对象学习的JSON 语法的说明。reviver可选如果是一个函数，则规定了原始值如何被解析改造，在被返回之前。

返回值

在Object对应于给定JSON text。

异常

SyntaxError如果要解析的字符串不是有效的JSON，则会引发异常。

示例

使用 JSON.parse()

JSON.parse('{}'              // {}
JSON.parse('true'            // true
JSON.parse('"foo"'           // "foo"
JSON.parse('[1, 5, "false"]' // [1, 5, "false"]
JSON.parse('null'            // null

使用reviver参数

如果指定了reviver 函数，则解析出的 JavaScript 值（解析值）会经过一次转换后才将被最终返回（返回值）。更具体点讲就是：解析值本身以及它所包含的所有属性，会按照一定的顺序（从最最里层的属性开始，一级级往外，最终到达顶层，也就是解析值本身）分别的去调用reviver函数，在调用过程中，当前属性所属的对象会作为this值，当前属性名和属性值会分别作为第一个和第二个参数传入reviver中。如果reviver返回undefined，则当前属性会从所属对象中删除，如果返回了其他值，则返回的值会成为当前属性新的属性值。

如果reviver只转换某些值而不转换其他值，则一定要按原样返回所有未转换的值，否则它们将会从结果对象中删除。

JSON.parse('{"p": 5}', (key, value) =>
  typeof value === 'number'
    ? value * 2 // return value * 2 for numbers
    : value     // return everything else unchanged


// { p: 10 }

JSON.parse('{"1": 1, "2": 2, "3": {"4": 4, "5": {"6": 6}}}', (key, value) => {
  console.log(key // log the current property name, the last is "".
  return value;     // return the unchanged property value.
}

// 1
// 2
// 4
// 6
// 5
// 3 
// ""

JSON.parse() 不允许用逗号作为结尾

// both will throw a SyntaxError
JSON.parse('[1, 2, 3, 4, ]'
JSON.parse('{"foo" : 1, }'

规范

Specification	Status	Comment
ECMAScript 5.1 (ECMA-262)The definition of 'JSON.parse' in that specification.	Standard	Initial definition. Implemented in JavaScript 1.7.
ECMAScript 2015 (6th Edition, ECMA-262)The definition of 'JSON.parse' in that specification.	Standard
ECMAScript Latest Draft (ECMA-262)The definition of 'JSON.parse' in that specification.	Living Standard

浏览器兼容性

Feature	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari
Basic Support	(Yes)	(Yes)	3.5	8	10.5	4

Feature	Android	Chrome for Android	Edge mobile	Firefox for Android	IE mobile	Opera Android	iOS Safari
Basic Support	(Yes)	(Yes)	(Yes)	1	(Yes)	(Yes)	(Yes)