KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Response — een Fetch API-response

Response staat voor een Fetch API-response: de status, headers en body. De body wordt asynchroon gelezen.

Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

new Response()
new Response(body)
new Response(body, init)
response.status
response.ok
response.headers
await response.json()
response.clone()

Response is een Web API die is gedefinieerd door de Fetch Standard en geen onderdeel is van ECMAScript. fetch() retourneert een Promise die bij succesvolle voltooiing een Response-object oplevert. Je kunt zo’n object ook maken met new Response(body, init).

status bevat de antwoordcode, ok betekent een status van 200–299 en headers geeft toegang tot de headers. response.json() leest de body asynchroon en parseert JSON; het maakt geen response, in tegenstelling tot de statische methode Response.json().

Een body die niet null is, kan in het algemeen maar één keer worden gebruikt. bodyUsed is true wanneer de stream van de body zich in de toestand ‘disturbed’ bevindt. Ook als je de stream annuleert zonder die te lezen, wordt bodyUsed true. Aan deze eigenschap kun je dus niet zien of het lezen is begonnen. Als de response een bodystream heeft, roep clone() dan alleen aan als de stream niet vergrendeld is en zich niet in de toestand ‘disturbed’ bevindt. Controleer of de Web API beschikbaar is in de doelbrowser; de Node-versie van de repository bevestigt dat niet.

Voorbeelden

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);

Resultaat

201 true false
Ada true

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen