Cette page a été traduite à partir de l'anglais par la communauté.Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
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 lesWeb Workers.
La méthodejson() de l'interfaceRequestlit 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 commeJSON.
Notez que, bien que la méthode soit nomméejson(), 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
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
TypeErrorProduite pour l'une des raisons suivantes :
- Le corps de la requête estperturbé ou verrouillé.
- Une erreur s'est produite lors du décodage du contenu du corps (par exemple, parce que l'en-tête
Content-Encodingest incorrect).
SyntaxErrorLe corps de la requête ne peut pas être analysé comme JSON.
Exemples
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① |