JavaScript
Explica cómo JSON.stringify y JSON.parse convierten datos, qué valores se pierden o cambian y cómo usar replacer, reviver y contratos de serialización.
es un formato de texto para representar datos. Se parece a la sintaxis de objetos JavaScript, pero no son lo mismo.
{
"id": "product-1",
"price": 120,
"active": true
}JSON permite:
No permite directamente:
const value = JSON.parse(text);Puede lanzar SyntaxError cuando el texto no es JSON válido.
try {
const configuration = JSON.parse(content);
} catch (cause) {
throw new ConfigurationError(
"Configuration is not valid JSON",
{ cause },
);
}Parsear no valida el dominio. El resultado continúa siendo información externa.
const text = JSON.stringify(value);Produce texto JSON cuando el grafo puede representarse.
Dentro de un objeto:
JSON.stringify({
value: undefined,
handler() {},
token: Symbol("token"),
});
// "{}"Dentro de un array, valores no representables suelen convertirse en null.
JSON.stringify([
undefined,
function () {},
Symbol("token"),
]);
// "[null,null,null]"JSON.stringify({
value: NaN,
maximum: Infinity,
});Se serializan como null, lo que puede cambiar el significado de los datos.
JSON.stringify({
createdAt: new Date(
"2026-07-23T14:00:00Z",
),
});Date utiliza toJSON, que normalmente produce un string ISO.
Al parsear, vuelve como string.
const parsed = JSON.parse(text);
typeof parsed.createdAt; // "string"Un objeto puede controlar su representación.
const product = {
id: "product-1",
internalToken: "secret",
toJSON() {
return {
id: this.id,
};
},
};Esto afecta cualquier stringify del objeto y puede ocultar datos inesperadamente. Úsalo de forma consciente.
Array de propiedades:
JSON.stringify(product, ["id", "name"]);Función:
JSON.stringify(value, (key, currentValue) => {
if (key === "password") {
return undefined;
}
return currentValue;
});No uses un replacer improvisado como única barrera de seguridad. Define DTOs explícitos para datos sensibles.
const value = JSON.parse(text, (key, currentValue) => {
if (key.endsWith("At")) {
return new Date(currentValue);
}
return currentValue;
});El reviver recorre desde propiedades hijas hacia sus contenedores. Una regla genérica por nombre puede convertir strings que no eran fechas; valida el formato y el contrato.
JSON.stringify({ value: 10n });
// TypeErrorDefine representación como string y un esquema que indique cómo reconstruirla.
JSON.stringify(new Map([["a", 1]]));
// "{}"Representaciones posibles:
[...map];
[...set];
Object.fromEntries(map);La elección forma parte del contrato de intercambio.
const object = {};
object.self = object;
JSON.stringify(object);
// TypeErrorJSON representa árboles, no grafos con identidad compartida o ciclos.
const copy = JSON.parse(
JSON.stringify(original),
);No es una copia profunda general. Puede perder:
Usa structuredClone cuando su contrato encaje.
JSON.stringify considera propiedades propias enumerables con claves string. Omite propiedades heredadas, no enumerables y symbol.
Las propiedades siguen el orden definido para las claves propias enumerables. No dependas de JSON para firmas criptográficas o comparación canónica sin una especificación de canonicalización.
Parsear JSON no ejecuta código como eval, pero los datos siguen siendo no confiables.
Riesgos:
function toPublicUser(user) {
return {
id: user.id,
name: user.name,
createdAt: user.createdAt.toISOString(),
};
}
const body = JSON.stringify(
toPublicUser(user),
);La representación pública no depende de todas las propiedades internas.
¿Por qué una Date deja de ser Date después de stringify y parse?
Porque JSON no tiene un tipo fecha. Date se representa como string y parse reconstruye ese string, no una instancia de Date.
JavaScript y las Web APIs inicia el bloque del navegador y separa el lenguaje de las capacidades del host.