Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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

Sources