25/3/2015

JSON.parse() - JavaScript | MDN

Apply your JS skills to key Mozilla projects as an MDN Fellow! http://mzl.la/MDNFellowship

JSON.parse()
This translation is incomplete. Please help translate this article from English.

Resumen
El mtodoJSON.parse()analiza una cadena de texto como un JSON, transformando
opcionalmenteel valor producido por el anlisis.

Sintaxis
JSON.parse(text[, reviver])

Parmetros
text
El texto que se convertir a JSON. Vea el objeto JSONpara una descripcin de la sintaxis JSON.
reviver

Opti onal

Si una funcin, prescribe cmo se transforma el valor producido originalmente por el parsing,
antes de retornar.

Returns
Retorna el objeto que se corresponde con el texto JSON entregado.

Exceptions
Lanza una excepcin SyntaxErrorsi la cadenaa transformar no es un JSON vlido.

Ejemplos
Ejemplo: UsandoJSON.parse()
1
2

JSON.parse('{}');
JSON.parse('true');

// {}
// true

https://developer.mozilla.org/es/docs/Web/JavaScript/Referencia/Objetos_globales/JSON/parse

1/3

25/3/2015
3
4
5

JSON.parse() - JavaScript | MDN

JSON.parse('"foo"');
// "foo"
JSON.parse('[1, 5, "false"]'); // [1, 5, "false"]
JSON.parse('null');
// null

Ejemplo: Usando el parmetro reviver

Si se especifica un reviver, el valor computado por el parsing es transformado antes de retornar.
Especficamente, el valor computado, y todas sus propiedades (comenzando con las propiedades
ms anidadas y siguiendo al propio valor original), son individualmente ejecutados a travs del
reviver, el cual es llamado con el objeto que contiene la propiedad que est siendo procesada
como thisy con el nombre de la propiedad como cadena y el valor de la propiedad como
argumentos. Si la funcin reviverretorna undefined(o no retorna algn valor, por ejemplo: si la
ejecucin cae el final de la funcin), la propiedad es eliminada del objeto. De otra manera, la
propiedad es redefinidad para ser el valor de retorno.
El reviveres llamada ltimo con la cadena vaca y el valor ms alto para permitir la transformacin
del valor ms alto. Asegrese de manejar este caso adecuadamente, por lo general mediante la
devolucin del valor proporcionado, o JSON.parsewill retorna undefined.

1
2
3
4

JSON.parse('{"p": 5}', function (k, v) {

if(k === "") return v;
// if topmost value, return it,
return v * 2;
// else return v * 2.
});
// { p: 10 }

5
6
7
8
9

JSON.parse('{"1": 1, "2": 2,"3": {"4": 4, "5": {"6": 6}}}', function (k, v) {

console.log(k);
// log the current property name, the last is "".
return v;
// return the unchanged property value.
});

10
11
12
13
14
15
16
17

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

Especificaciones
Especificacin

ECMAScript 5.1 (ECMA-262)

The definition of 'JSON.parse' in that specification.

ECMAScript 6 (ECMA-262)

The definition of 'JSON.parse' in that specification.

Estado
ST

Standard

Draft

Comentario
Definicin inicial.
Implementado en JavaScript 1.7.

https://developer.mozilla.org/es/docs/Web/JavaScript/Referencia/Objetos_globales/JSON/parse

2/3

25/3/2015

JSON.parse() - JavaScript | MDN

Compatibilidad de navegadores
Mobile

Desktop

Caracterstica Chrome Firefox (Gecko) Internet Explorer Opera Safari

Soporte bsico

Based on

(Yes)

3.5 (1.9.1)

8.0

10.5

4.0

Kangax's compat table.

Especificaciones Gecko
Comenzando con Gecko 29 (Firefox 29 / Thunderbird 29 / SeaMonkey 2.26), unas malformados
cadenas JSON produce un mensaje de error ms detallado que contiene el nmero de lnea y
columna que provoc el error de parsing. Esto es til cuando se est haciendo debug de un JSON
grande.

1
2
3

JSON.parse('[1, 2, 3,]')
// SyntaxError: JSON.parse: unexpected character at
// line 1 column 10 of the JSON data

Vase tambin
Using native JSON

https://developer.mozilla.org/es/docs/Web/JavaScript/Referencia/Objetos_globales/JSON/parse

3/3