Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

JSON.parse: de texto JSON a un valor JavaScript

JSON.parse lee texto con la gramática JSON estricta y devuelve su valor JavaScript; un reviver opcional puede transformar el resultado desde las hojas hasta la raíz.

Versión: ECMAScript 5 onward; reviver context.source from ECMAScript 2026; example target: Node.js 24.22.2

Sintaxis

JSON.parse(text[, reviver])

JSON.parse(text, reviver?) convierte primero text en cadena y después reconoce exactamente un valor JSON: objeto, array, cadena, número, true, false o null. JSON exige comillas dobles y no admite comentarios, comas finales, undefined, NaN ni Infinity. Una clave "__proto__" se convierte en una propiedad de datos propia ordinaria; el análisis no cambia el prototipo.

Si reviver es una función, el motor visita las propiedades desde los hijos hasta el padre; this es el contenedor de la propiedad actual y la raíz usa la clave vacía "". Devolver undefined elimina una propiedad y otro resultado la sustituye. Desde ECMAScript 2026, context es el tercer argumento del reviver; para un primitivo no modificado, context.source contiene el fragmento exacto de entrada, permitiendo recuperar un entero grande como BigInt pese a su redondeo previo a Number.

La sintaxis inválida lanza SyntaxError; una excepción del reviver se propaga. JSON.parse no ejecuta el texto como código, pero los datos de una fuente no fiable aún deben validarse contra el esquema esperado antes de usarlos. El método es estándar desde ECMAScript 5 y context.source desde ECMAScript 2026.

Ejemplos

const value = JSON.parse(
  '{"created":"2024-01-02T03:04:05.006Z","count":9007199254740993}',
  function (key, current, context) {
    if (key === "created") return new Date(current);
    if (key === "count") return BigInt(context.source);
    return current;
  },
);
console.log(value.created instanceof Date, value.created.toISOString());
console.log(String(value.count));

const order = [];
JSON.parse('{"a":{"b":1}}', (key, current) => {
  order.push(key || "<root>");
  return current;
});
console.log(order.join(","));

try {
  JSON.parse('{"trailing":true,}');
} catch (error) {
  console.log(error instanceof SyntaxError);
}

Resultado

true 2024-01-02T03:04:05.006Z
9007199254740993
b,a,<root>
true

Fuentes