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.