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
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 :
- Le corps de la requête est perturbé 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).
SyntaxError-
Le 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①> |