Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Request : méthode json()

Baseline Widely available

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis mars 2017.

Note : Cette fonctionnalité est disponible via les Web Workers.

La méthode json() de l'interface Request lit le corps de la requête et le retourne sous forme d'une promesse qui produit le résultat de l'analyse du texte du corps comme JSON.

Notez que, bien que la méthode soit nommée json(), le résultat n'est pas du JSON mais le résultat de la prise du JSON en entrée et de son analyse pour produire un objet JavaScript.

Syntaxe

js
json()

Paramètres

Aucun.

Valeur de retour

Une promesse (Promise) qui produit un objet JavaScript. Cet objet peut être n'importe quoi qui peut être représenté par du JSON — un objet, un tableau, une chaîne de caractères, un nombre…

Exceptions

TypeError

Produite pour l'une des raisons suivantes :

SyntaxError

Le corps de la requête ne peut pas être analysé comme JSON.

Exemples

js
const obj = { hello: "bonjour" };

const requete = new Request("/monPointDeTerminaison", {
  method: "POST",
  body: JSON.stringify(obj),
});

requete.json().then((donnees) => {
  // faire quelque chose avec les données envoyées dans la requête
});

Spécifications

Specification
Fetch
# ref-for-dom-body-json①

Compatibilité des navigateurs

Voir aussi