CKTIS / JavaScript
Response — une réponse de l’API Fetch
Response représente une réponse de l’API Fetch : son statut, ses en-têtes et son corps. Le corps est lu de manière asynchrone.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
new Response()
new Response(body)
new Response(body, init)
response.status
response.ok
response.headers
await response.json()
response.clone()Response est une API Web définie par le Fetch Standard, et ne fait pas partie d’ECMAScript. fetch() renvoie une promesse (Promise) qui, si elle est tenue, fournit un objet Response. Tu peux aussi créer un tel objet avec new Response(body, init).
status contient le code de réponse, ok indique un statut compris entre 200 et 299, et headers donne accès aux en-têtes. response.json() lit le corps de manière asynchrone et analyse le JSON ; contrairement à la méthode statique Response.json(), cette méthode ne crée pas de réponse.
Un corps non nul ne peut généralement être utilisé qu’une seule fois. bodyUsed vaut true lorsque le flux du corps est dans l’état « disturbed ». Annuler le flux sans le lire fait aussi passer bodyUsed à true : cette propriété ne permet donc pas de savoir si la lecture a commencé. Si la réponse possède un flux de corps, appelle clone() uniquement si le flux n’est ni dans l’état « disturbed » ni verrouillé. Vérifie la disponibilité de l’API Web dans le navigateur visé ; la version de Node du dépôt ne permet pas de l’établir.
Exemples
async function main() {
const response = new Response('{"name":"Ada"}', {
status: 201,
headers: { "Content-Type": "application/json" }
});
console.log(response.status, response.ok, response.bodyUsed);
const data = await response.json();
console.log(data.name, response.bodyUsed);
}
main().catch(console.error);Résultat
201 true false Ada true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.