1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
|
---
title: JSON
slug: Web/JavaScript/Reference/Global_Objects/JSON
tags:
- JSON
- JavaScript
- Object
- Reference
- polyfill
translation_of: Web/JavaScript/Reference/Global_Objects/JSON
original_slug: Web/JavaScript/Reference/Objets_globaux/JSON
---
<div>{{JSRef}}</div>
<p>L’objet <strong><code>JSON</code></strong> contient des méthodes pour interpréter du <a class="external" href="https://json.org/">JSON</a> (JavaScript Object Notation) (voir également la page du glossaire {{glossary("JSON")}}) et convertir des valeurs en JSON. Il ne peut être appelé ou construit, et, en dehors de ses deux méthodes, n’a pas de fonctionnalité propre.</p>
<h2 id="Différences_entres_JavaScript_et_JSON">Différences entres JavaScript et JSON</h2>
<p>JSON est une syntaxe pour sérialiser des objets, tableaux, nombres, chaînes de caractères, booléens et valeurs <em>null</em>. Elle est basée sur la syntaxe de JavaScript mais en est distincte : du code JavaScript n’est pas nécessairement du JSON, et du JSON n’est pas nécessairement du JavaScript.</p>
<ul>
<li>Pour les objets et les tableaux
<ul>
<li>Les noms de propriété doivent être des chaînes de caractères délimitées par des guillements doubles ; les <em>trailing commas</em> sont interdits</li>
</ul>
</li>
<li>Pour les nombres
<ul>
<li>Les zéros non significatifs sont interdits ; un point décimal doit être suivi d’au moins un chiffre (plus exactement : <code>JSON.stringify()</code> ignorera les zéros mais <code>JSON.parse()</code> déclenchera une exception <code>SyntaxError</code>).</li>
</ul>
</li>
<li>Pour le texte : <strong>tout texte JSON est une expression JavaScript</strong> (pour les moteurs qui implémentent <a href="https://github.com/tc39/proposal-json-superset">cette proposition</a>).
<ul>
<li>Pour les autres moteurs, seul un jeu limité de caractères peut être échappé ; certains caractères de contrôle sont interdits ; le séparateur de ligne Unicode (<a href="https://unicode-table.com/en/2028/">U+2028</a>) et le séparateur de paragraphe (<a href="https://unicode-table.com/en/2029/">U+2029</a>) sont autorisés en JSON mais pas en JavaScript dans les littéraux de chaînes de caractères.</li>
</ul>
</li>
</ul>
<p>Dans l'exemple suivant, on utilise {{jsxref("JSON.parse()")}} afin d'analyser la chaîne JSON et <code>eval</code> afin d'exécuter le code correspondant :</p>
<pre class="brush: js">var code = '"\u2028\u2029"';
JSON.parse(code); // vaut "\u2028\u2029" pour tous les moteurs
eval(code); // provoque une SyntaxError pour les anciens moteurs</pre>
<h2 id="Syntaxe_complète">Syntaxe complète</h2>
<pre class="syntaxbox"><var>JSON</var> = <strong>null</strong>
<em>ou</em> <strong>true</strong> <em>ou</em> <strong>false</strong>
<em>ou</em> <var>NombreJSON</var>
<em>ou</em> <var>ChaîneJSON</var>
<em>ou</em> <var>ObjetJSON</var>
<em>ou</em> <var>TableauJSON</var>
<var>NombreJSON</var> = <strong>-</strong> <var>NombrePositif</var>
<em>ou</em> <var>NombrePositif</var>
<var>NombrePositif</var> = NombreDécimal
<em>ou</em> <var>NombreDécimal</var> <strong>.</strong> <var>Chiffres</var>
<em>ou</em> <var>NombreDécimal</var> <strong>.</strong> <var>Chiffres</var> <var>PartiExposant</var>
<em>ou</em> <var>NombreDécimal</var> <var>PartiExposant</var>
<var>NombreDécimal</var> = <strong>0</strong>
<em>ou</em> <var>UnÀNeuf</var> <var>Chiffres</var>
<var>PartiExposant</var> = <strong>e</strong> <var>Exposant</var>
<em>ou</em> <strong>E</strong> <var>Exposant</var>
<var>Exposant</var> = <var>Chiffres</var>
<em>ou</em> <strong>+</strong> <var>Chiffres</var>
<em>ou</em> <strong>-</strong> <var>Chiffres</var>
<var>Chiffres</var> = <var>Chiffre</var>
<em>ou</em> <var>Chiffres</var> <var>Chiffre</var>
<var>Chiffre</var> = <strong>0</strong> à <strong>9</strong>
<var>UnÀNeuf</var> = <strong>1</strong> à <strong>9</strong>
<var>ChaîneJSON</var> = <strong>""</strong>
<em>ou</em> <strong>"</strong> <var>ChaîneCaractères</var> <strong>"</strong>
<var>ChaîneCaractères</var> = <var>ChaîneCaractère</var>
<em>ou</em> <var>ChaîneCaractères</var> <var>ChaîneCaractère</var>
<var>ChaîneCaractère</var> = un caractère
<em>sauf</em> <strong>"</strong> <em>ou</em> <strong>\</strong> <em>ou</em> U+0000 à U+001F
<em>ou</em> <var>SéquenceÉchappement</var>
<var>SéquenceÉchappement</var> = <strong>\" </strong><em>ou</em> <strong>\/ </strong><em>ou</em> <strong>\\ </strong><em>ou</em> <strong>\b </strong><em>ou</em> <strong>\f </strong><em>ou</em> <strong>\n </strong><em>ou</em> <strong>\r </strong><em>ou</em> <strong>\t</strong>
<em>ou</em> <strong>\u</strong> <var>ChifreHexadécimal</var> <var>ChifreHexadécimal</var> <var>ChifreHexadécimal</var> <var>ChifreHexadécimal</var>
<var>ChifreHexadécimal</var> = <strong>0</strong> à <strong>9</strong>
<em>ou</em> <strong>A</strong> à <strong>F</strong>
<em>ou</em> <strong>a</strong> à <strong>f</strong>
<var>ObjetJSON</var> = <strong>{</strong> <strong>}</strong>
<em>ou</em> <strong>{</strong> <var>Membres</var> <strong>}</strong>
<var>Membres</var> = <var>ChaîneJSON</var> <strong>:</strong> <var>JSON</var>
<em>ou</em> <var>Membres</var> <strong>,</strong> <var>ChaîneJSON</var> <strong>:</strong> <var>JSON</var>
<var>TableauJSON</var> = <strong>[</strong> <strong>]</strong>
<em>ou</em> <strong>[</strong> <var>ÉlémentsTableau</var> <strong>]</strong>
<var>ÉlémentsTableau</var> = <var>JSON</var>
<em>ou</em> <var>ÉlémentsTableau</var> <strong>,</strong> <var>JSON</var></pre>
<p>Des espaces blancs insignifiants peuvent être présents n’importe où sauf dans un <code><var>JSONNumber</var></code> (les nombres ne doivent pas contenir d’espaces blancs) ou dans un <code><var>JSONString</var></code> (where it is interpreted as the corresponding character in the string, or would cause an error). Les caractères tabulation (<a href="https://unicode-table.com/en/0009/">U+0009</a>), retour chariot (<a href="https://unicode-table.com/en/000D/">U+000D</a>), saut de ligne (<a href="https://unicode-table.com/en/000A/">U+000A</a>), and espace (<a href="https://unicode-table.com/en/0020/">U+0020</a>) sont les seuls caractères blancs valides.</p>
<h2 id="Méthodes">Méthodes</h2>
<dl>
<dt>{{jsxref("JSON.parse()", "JSON.parse(<var>texte</var>[, <var>revivificateur</var>])")}}</dt>
<dd>Analysez le <code>texte</code> de la chaîne comme JSON, transformez éventuellement la valeur produite et ses propriétés, et renvoyez la valeur. Toute violation de la syntaxe JSON, y compris celles concernant les différences entre JavaScript et JSON, entraîne l'envoi d'un {{jsxref("SyntaxError")}}. L'option "<code>revivificateur</code>" permet d'interpréter ce que le <code>remplacement</code> a utilisé pour remplacer d'autres types de données.</dd>
<dt>{{jsxref("JSON.stringify()", "JSON.stringify(<var>valeur</var>[, remplacement[, expace]])")}}</dt>
<dd>Retourne une chaîne JSON correspondant à la valeur spécifiée, en incluant éventuellement seulement certaines propriétés ou en remplaçant les valeurs des propriétés d'une manière définie par l'utilisateur. Par défaut, toutes les instances de {{jsxref("undefined")}} sont remplacées par {{jsxref("null")}}, et les autres types de données natives non prises en charge sont censurés. L'option de <code>remplacement</code> permet de spécifier un autre comportement.</dd>
</dl>
<h2 id="Spécifications">Spécifications</h2>
<table class="standard-table">
<tbody>
<tr>
<th scope="col">Spécification</th>
<th scope="col">État</th>
<th scope="col">Commentaires</th>
</tr>
<tr>
<td>{{SpecName('ES5.1', '#sec-15.12', 'JSON')}}</td>
<td>{{Spec2('ES5.1')}}</td>
<td>Définition initiale.</td>
</tr>
<tr>
<td>{{SpecName('ES6', '#sec-json-object', 'JSON')}}</td>
<td>{{Spec2('ES6')}}</td>
<td></td>
</tr>
<tr>
<td>{{SpecName('ESDraft', '#sec-json-object', 'JSON')}}</td>
<td>{{Spec2('ESDraft')}}</td>
<td></td>
</tr>
</tbody>
</table>
<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2>
<p>{{Compat("javascript.builtins.JSON")}}</p>
<h2 id="Voir_aussi">Voir aussi</h2>
<ul>
<li>{{jsxref("Date.prototype.toJSON()")}}</li>
<li>Quelques outils permettant de manipuler des données en JSON
<ul>
<li><a href="http://jsoncompare.org/">JSON Compare</a> qui permet de comparer deux JSON</li>
<li><a href="http://jsonbeautifier.org/">JSON Beautifier</a> qui permet de visualiser et d'éditer un fichier JSON</li>
<li><a href="https://jsonparser.org/">JSON Parser</a> qui permet de formatter une chaîne JSON</li>
<li><a href="https://extendsclass.com/json-validator.html">JSON Formatter</a> qui permet de formatter et échapper une chaîne JSON </li>
<li><a href="https://tools.learningcontainer.com/json-validator/">JSON Validator</a> qui permet de valider une chaîne JSON</li>
</ul>
</li>
</ul>
|
