diff options
Diffstat (limited to 'files/fr/web/javascript/reference/objets_globaux/json/index.html')
| -rw-r--r-- | files/fr/web/javascript/reference/objets_globaux/json/index.html | 153 |
1 files changed, 0 insertions, 153 deletions
diff --git a/files/fr/web/javascript/reference/objets_globaux/json/index.html b/files/fr/web/javascript/reference/objets_globaux/json/index.html deleted file mode 100644 index ecc67a2d86..0000000000 --- a/files/fr/web/javascript/reference/objets_globaux/json/index.html +++ /dev/null @@ -1,153 +0,0 @@ ---- -title: JSON -slug: Web/JavaScript/Reference/Objets_globaux/JSON -tags: - - JSON - - JavaScript - - Object - - Reference - - polyfill -translation_of: Web/JavaScript/Reference/Global_Objects/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> - -<div> -<div class="hidden">Le tableau de compatibilité de cette page a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à consulter <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> et à nous envoyer une <em>pull request</em>.</div> - -<p>{{Compat("javascript.builtins.JSON")}}</p> -</div> - -<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> |