CKTIS / JavaScript
Request — een Fetch-verzoek beschrijven
Request vertegenwoordigt een verzoek voor Fetch. De constructor bereidt de URL, methode, headers en een optionele body voor zonder iets te verzenden. De body is een stream: het uitlezen ervan beïnvloedt of deze opnieuw kan worden gebruikt.
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 Request(input, init?)Request is een Web-API uit de Fetch Standard, geen onderdeel van ECMAScript. new Request(input, init?) verzendt niets; geef het verzoek door aan fetch().
input accepteert een URL of een ander Request-object; init stelt opties in, waaronder method, headers en body. De standaardmethode is GET. Een body bij GET of HEAD veroorzaakt een TypeError.
text() en json() verbruiken de body. bodyUsed geeft aan of de bodystream de status disturbed heeft: er is uit de stream gelezen of de stream is geannuleerd. Ook als je de stream annuleert zonder eruit te lezen, wordt bodyUsed true. Roep vóór het uitlezen clone() aan voor een aparte streamtak; een verbruikte of vergrendelde body verhindert het klonen.
Het voorbeeld gebruikt geen netwerk: het leest de oorspronkelijke body en die van de kopie uit.
Voorbeelden
(async () => {
const request = new Request('https://example.org/items', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ id: 7 })
});
const copy = request.clone();
console.log(request.method);
console.log(request.headers.get('content-type'));
console.log(request.bodyUsed);
console.log(await request.text());
console.log(request.bodyUsed);
console.log(await copy.text());
})().catch(console.error);Resultaat
POST
application/json
false
{"id":7}
true
{"id":7}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.