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

CKTIS / JavaScript

JSON — analyser et sérialiser des données

JSON est l’objet intégré de JavaScript qui permet de lire et d’écrire du texte JSON. JSON.parse crée des valeurs à partir du texte, tandis que JSON.stringify sérialise des valeurs, sans préserver pour autant tous les types ni toutes les structures d’objets JavaScript.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

JSON.parse(text[, reviver])
JSON.stringify(value[, replacer[, space]])

JSON est un objet intégré à ECMAScript, pas un constructeur ni une fonction : n’utilisez ni new JSON() ni JSON(). Le format JSON décrit des objets, des tableaux, des chaînes, des nombres, des booléens et null. Les noms de propriétés et les chaînes doivent être entre guillemets doubles ; les commentaires et les virgules finales sont interdits.

JSON.parse(text, reviver) lit le texte ; une syntaxe invalide provoque une SyntaxError. Le reviver facultatif transforme les valeurs des éléments imbriqués vers la racine ; renvoyer undefined supprime une propriété. Une analyse réussie ne valide pas le schéma de données attendu, et les grands entiers peuvent perdre en précision lorsqu’ils sont représentés par des valeurs Number.

JSON.stringify(value, replacer, space) renvoie du texte ou undefined. replacer peut être une fonction qui transforme les valeurs ou un tableau de noms qui sélectionne les propriétés des objets ; space contrôle l’indentation. Pour les objets autres que les tableaux, ce sont les propriétés propres, énumérables et dont les clés sont des chaînes qui sont sérialisées par défaut. Pour les tableaux, les valeurs sont lues aux indices de 0 à length - 1, même si les propriétés correspondantes sont héritées ou non énumérables. Les propriétés supplémentaires dont les noms ne sont pas des indices sont ignorées, même si elles sont énumérables. Une méthode toJSON, si elle existe, peut modifier la représentation.

Les propriétés dont la valeur est undefined, une fonction ou un symbole sont omises des objets, mais les éléments de tableau correspondants deviennent null. NaN et les infinis deviennent également null. Les cycles et les valeurs BigInt non converties provoquent une TypeError. Par conséquent, sérialiser puis analyser à nouveau n’est pas une méthode générale de copie profonde.

Cette entrée et cet exemple couvrent les méthodes de base, pas l’ensemble des extensions plus récentes. Le projet de spécification actuel décrit aussi JSON.rawJSON et JSON.isRawJSON ; vérifiez leur disponibilité dans votre environnement cible avant de les utiliser. Un résultat obtenu dans Node 24 ne prouve pas leur prise en charge par les navigateurs.

Exemples

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] }));

Résultat

{"name":"Ada","scores":[3,5,8]}
{"items":[null]}

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources