CKTIS / JavaScript
fetch — asynchroon ophalen van bronnen
fetch() haalt een bron op en retourneert Promise<Response>. Een HTTP-foutstatus wijst de promise niet automatisch af; controleer response.ok.
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
fetch(input, init?) → Promise<Response>fetch(input, init?) is een Web API en geen onderdeel van ECMAScript. De functie accepteert een URL of Request; de optionele parameter init configureert het verzoek. Als init.method niet is opgegeven, geldt voor een URL standaard GET, terwijl een bestaand Request-object zijn methode behoudt (een POST-verzoek blijft bijvoorbeeld POST).
await fetch(...) levert een Response-object op, niet de al uitgelezen inhoud ervan. await response.json() leest en parseert JSON; dit kan de promise afwijzen. De inhoud kan doorgaans maar één keer worden gelezen.
response.ok betekent dat de status tussen 200 en 299 ligt. HTTP-statussen 404 en 500 wijzen de promise op zichzelf niet af; netwerkfouten wel. Browsers handhaven CORS: mode: 'no-cors' maakt het niet mogelijk om een antwoord van een andere oorsprong te lezen.
Voorbeelden
async function main() {
const response = await fetch('data:application/json,%7B%22value%22%3A42%7D');
if (!response.ok) {
throw new Error(`HTTP ${response.status}`);
}
const data = await response.json();
console.log(data.value);
}
main().catch(console.error);Resultaat
42
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.