JSON.parse()

Sintaxis

JSON.parse(text[, reviver])

Parmetros

text

El texto que se convertir a JSON. Vea el objeto JSON para una descripcin de la sintaxis JSON.

reviver Opcional

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 SyntaxError si la cadena a transformar no es un JSON vlido.

Ejemplos

Ejemplo: Usando JSON.parse()

JSON.parse("{}"); // {}
JSON.parse("true"); // true
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 this y con el nombre de la propiedad como cadena y el valor de la propiedad como argumentos. Si la funcin reviver retorna 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 reviver es 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.parse will retorna undefined.

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 }

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.
});

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

JSON.parse() no admite comas finales

// ambos lanzarn un SyntaxError
JSON.parse("[1, 2, 3, 4, ]");
JSON.parse('{"foo" : 1, }');

Especificaciones

Compatibilidad con navegadores

Vase tambin

• Utilizando JSON nativo