CKTIS / JavaScript
JSON.parse : du texte JSON à une valeur JavaScript
JSON.parse lit un texte selon la grammaire JSON stricte et renvoie sa valeur JavaScript ; un reviver facultatif peut transformer le résultat des feuilles vers la racine.
Version : ECMAScript 5 onward; reviver context.source from ECMAScript 2026; example target: Node.js 24.22.2
Syntaxe
JSON.parse(text[, reviver])JSON.parse(text, reviver?) convertit d’abord text en chaîne, puis reconnaît exactement une valeur JSON : objet, tableau, chaîne, nombre, true, false ou null. JSON exige des guillemets doubles et n’autorise ni commentaires, ni virgules finales, ni undefined, NaN ou Infinity. Une clé "__proto__" devient une propriété de données propre ordinaire ; l’analyse ne modifie pas le prototype.
Si reviver est une fonction, le moteur visite les propriétés des enfants vers le parent ; this est le détenteur de la propriété courante et la racine utilise la clé vide "". Renvoyer undefined supprime une propriété, tandis qu’un autre résultat la remplace. Depuis ECMAScript 2026, context est le troisième argument du reviver ; pour une primitive non modifiée, context.source contient la tranche d’entrée exacte, permettant de récupérer un grand entier en BigInt malgré son arrondi préalable en Number.
Une syntaxe invalide lève SyntaxError ; une exception lancée par le reviver se propage. JSON.parse n’exécute pas le texte comme du code, mais les données d’une source non fiable doivent toujours être validées selon le schéma attendu avant utilisation. La méthode est standard depuis ECMAScript 5 et context.source depuis ECMAScript 2026.
Exemples
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);
}Résultat
true 2024-01-02T03:04:05.006Z 9007199254740993 b,a,<root> true