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

CKTIS / JavaScript

JSON.stringify: de un valor JavaScript a texto JSON

JSON.stringify serializa un valor JavaScript como texto JSON; un replacer opcional selecciona o transforma datos y space controla la sangría.

Versión: ECMAScript 5 onward; well-formed lone-surrogate escaping from ECMAScript 2019; example target: Node.js 24.22.2

Sintaxis

JSON.stringify(value[, replacer[, space]])

JSON.stringify(value, replacer?, space?) devuelve una cadena JSON, o undefined cuando el valor superior es undefined, una función o un Symbol. Esos valores se omiten en un objeto, pero se vuelven null en un array; NaN e infinitos también se vuelven null, mientras que -0 se escribe como 0. Serializa propiedades propias enumerables con clave de cadena en el orden definido de Object.keys; ignora claves Symbol. La descripción de propiedades propias enumerables corresponde a la lista predeterminada; un array replacer lee propiedades nombradas mediante Get y puede incluir una heredada o no enumerable.

Un método toJSON, si existe, se ejecuta antes del replacer. Una función replacer recibe (key, value), con this como contenedor, y puede sustituir el valor u omitir una propiedad devolviendo undefined; la llamada raíz usa la clave vacía "". Un array replacer forma la lista permitida de nombres de propiedades de objetos. space numérico se limita a 10 espacios y space de cadena a sus primeros 10 caracteres. Para space de cadena, «10 caracteres» significa exactamente las primeras 10 unidades de código UTF-16.

Una referencia cíclica lanza TypeError. Un BigInt también lanza TypeError salvo que la búsqueda ordinaria de propiedades encuentre un toJSON invocable; el método puede venir del prototipo. Las excepciones de un getter, toJSON o el replacer se propagan. El orden estable de propiedades no convierte la salida en JSON canónico para firmas criptográficas. El método es estándar desde ECMAScript 5; desde ECMAScript 2019, los sustitutos Unicode aislados se emiten como secuencias \ud800–\udfff para producir Unicode bien formado.

Ejemplos

const value = {
  name: "Ada",
  missing: undefined,
  numbers: [1, NaN, Infinity, undefined],
  nested: { keep: true, secret: "hidden" },
};
console.log(JSON.stringify(value, (key, current) =>
  key === "secret" ? undefined : current,
));
console.log(JSON.stringify(undefined) === undefined);

try {
  JSON.stringify(1n);
} catch (error) {
  console.log(error instanceof TypeError);
}

const cycle = {};
cycle.self = cycle;
try {
  JSON.stringify(cycle);
} catch (error) {
  console.log(error instanceof TypeError);
}

Resultado

{"name":"Ada","numbers":[1,null,null,null],"nested":{"keep":true}}
true
true
true

Fuentes