Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources