KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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.

Bronnen