Request : méthode text()
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 text() de l'interface Request lit le corps de la requête et le retourne sous la forme d'une promesse qui produit une chaîne de caractères (String). La réponse est toujours décodée en UTF-8.
Syntaxe
js
text()
Paramètres
Aucun.
Valeur de retour
Une promesse qui produit une chaîne de caractères (String).
Exceptions
TypeError-
Levée 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 HTTP
Content-Encodingest incorrect).
Exemples
js
const texte = "Bonjour le monde";
const requete = new Request("/monPointDeTerminaison", {
method: "POST",
body: texte,
});
requete.text().then((texte) => {
// faire quelque chose avec le texte envoyé dans la requête
});
Spécifications
| Specification |
|---|
| Fetch # ref-for-dom-body-text① |
Compatibilité des navigateurs
Voir aussi
- La méthode
Response.text()