WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

fetch — asynchrones Abrufen von Ressourcen

fetch() ruft eine Ressource ab und gibt Promise<Response> zurück. Ein HTTP-Fehlerstatus weist das Promise nicht automatisch zurück; prüfe response.ok.

Version: 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?) ist eine Web API und kein Bestandteil von ECMAScript. Es akzeptiert eine URL oder Request; das optionale init konfiguriert die Anfrage. Ohne Angabe von init.method wird bei einer URL GET verwendet, während ein vorhandenes Request-Objekt seine Methode beibehält (z. B. bleibt eine POST-Anfrage bei POST).

await fetch(...) liefert ein Response-Objekt, nicht den bereits ausgelesenen Inhalt. await response.json() liest und parst JSON; dabei kann das Promise zurückgewiesen werden. Der Inhalt kann im Allgemeinen nur einmal gelesen werden.

response.ok bedeutet, dass der Status zwischen 200 und 299 liegt. HTTP 404 und 500 allein weisen das Promise nicht zurück; Netzwerkfehler tun dies. In Browsern gilt CORS: mode: 'no-cors' ermöglicht nicht das Lesen einer ursprungsübergreifenden Antwort.

Beispiele

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

Ergebnis

42

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen