CKTIS / JavaScript
JSON — analizar y serializar datos
JSON es el objeto integrado de JavaScript para leer y escribir texto JSON. JSON.parse crea valores a partir del texto, mientras que JSON.stringify serializa valores, pero no conserva todos los tipos ni las estructuras de objetos de JavaScript.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
JSON.parse(text[, reviver])
JSON.stringify(value[, replacer[, space]])JSON es un objeto integrado de ECMAScript, no un constructor ni una función: no uses new JSON() ni JSON(). El formato JSON describe objetos, arrays, cadenas, números, valores booleanos y null. Los nombres de propiedades y las cadenas deben ir entre comillas dobles; no se permiten comentarios ni comas finales.
JSON.parse(text, reviver) lee texto; una sintaxis no válida provoca un SyntaxError. El reviver opcional transforma los valores desde los elementos anidados hacia la raíz; si devuelve undefined, elimina la propiedad. Un análisis correcto no valida el esquema de datos esperado, y los enteros grandes pueden perder precisión al representarse como valores Number.
JSON.stringify(value, replacer, space) devuelve texto o undefined. replacer puede ser una función que transforme valores o un array de nombres que seleccione propiedades de objetos; space controla la sangría. En los objetos que no son arrays, se serializan de forma predeterminada las propiedades propias y enumerables cuyas claves son cadenas. En los arrays se leen los valores de los índices de 0 a length - 1, aunque las propiedades correspondientes sean heredadas o no enumerables. Las propiedades adicionales cuyos nombres no son índices se ignoran, aunque sean enumerables. Si existe un método toJSON, puede cambiar la representación.
Las propiedades cuyo valor sea undefined, una función o un símbolo se omiten en los objetos, pero los elementos correspondientes de los arrays se convierten en null. NaN y los infinitos también se convierten en null. Los ciclos y los valores BigInt sin convertir provocan un TypeError. Por tanto, serializar y volver a analizar no es una técnica general para hacer copias profundas.
Esta entrada y el ejemplo cubren los métodos básicos, no el conjunto completo de extensiones más recientes. El borrador actual de la especificación también describe JSON.rawJSON y JSON.isRawJSON; comprueba que estén disponibles en tu entorno de destino antes de usarlos. Un resultado en Node 24 no demuestra que sean compatibles con los navegadores.
Ejemplos
const text = '{"name":"Ada","scores":[3,5]}';
const data = JSON.parse(text);
data.scores.push(8);
console.log(JSON.stringify(data));
console.log(JSON.stringify({ missing: undefined, items: [undefined] }));Resultado
{"name":"Ada","scores":[3,5,8]}
{"items":[null]}El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.