Fetch API

Die Fetch API bietet eine Schnittstelle zum Abrufen von Ressourcen (auch über das Netzwerk). Wer schon einmal mit XMLHttpRequest gearbeitet hat wird Ähnlichkeiten erkennen. Die neue API bietet jedoch einen ganzen Satz leistungsfähigerer und flexiblerer Funktionen.

Konzepte und Verwendung

Fetch bietet eine generische Definition von Request (en-US) und Response Objekten (und anderen Dingen, die mit Anfragen über ein Netzwerk zu tun haben). Dadurch können sie überall dort eingesetzt werden, wo sie in Zukunft benötigt werden, sei es für Service Worker, die Cache-API und andere ähnliche Dinge, mit denen Anfragen und Antworten abgewickelt oder geändert werden, oder in jedem Anwendungsfall, für den Sie möglicherweise eigene Antworten programmatisch erstellen müssen.

Sie enthält auch eine Definition für verwandte Konzepte wie CORS und die HTTP-Origin-Semantik, die ihre separaten Definitionen an anderer Stelle ersetzen.

Verwenden Sie zum Erstellen einer Anfrage und zum Abrufen einer Ressource die Methode WindowOrWorkerGlobalScope.fetch() (en-US). Es ist in mehreren Schnittstellen implementiert, insbesondere Window und WorkerGlobalScope (en-US). Dadurch ist es in nahezu jedem Kontext verfügbar, in dem Sie Ressourcen abrufen möchten.

Die Methode fetch() nimmt ein obligatorisches Argument entgegen, den Pfad zu der Ressource, die Sie abrufen möchten. Sie gibt ein Promise (en-US) zurück, das in die Response dieser Anfrage aufgelöst wird, unabhängig davon, ob sie erfolgreich ist oder nicht. Sie können optional auch ein init Objekt mit Optionen als zweites Argument übergeben (siehe Request (en-US)).

Nachdem eine Response abgerufen wurde, stehen eine Reihe von Methoden zur Verfügung, mit denen der Antwort-Inhalt (Body) definiert werden kann und wie er verarbeitet werden soll (siehe Body).

Sie können eine Anfrage und Antwort direkt erstellen, indem Sie die Konstruktoren Request() (en-US) und Response() verwenden, was Sie aber wahrscheinlich in den seltensten Fällen tun werden. Stattdessen werden diese eher als Ergebnis anderer API-Aktionen erstellt (z. B. durch FetchEvent.respondWith() (en-US) von Service Workern).

Hinweis: Erfahren Sie mehr über die Verwendung der Funktionen der Fetch API in der Verwendung von Fetch (en-US) und lernen Sie die Grundkonzepte von Fetch (en-US).

Einen Abruf abbrechen

Browser haben begonnen, experimentelle Unterstützung für die Schnittstellen AbortController (en-US) und AbortSignal (en-US) hinzuzufügen (auch Abort API genannt), die den Abbruch von Operationen durch Fetch und XHR ermöglichen, sofern diese noch nicht abgeschlossen sind. Weitere Informationen finden Sie auf den Schnittstellenseiten.

Fetch Interfaces

WindowOrWorkerGlobalScope.fetch() (en-US)
Die fetch() Methode zum Abrufen einer Ressource.
Headers (en-US)
Stellt die Antwort-/Anfrageheader dar, damit Sie sie abfragen und je nach Ergebnis unterschiedliche Aktionen ausführen können.
Request (en-US)
Stellt eine Ressourcenanfrage dar.
Response
Stellt die Antwort auf eine Anfrage dar.

Fetch mixin

Body
Stellt Methoden bereit, die sich auf den Hauptteil (Body) der Antwort/Anfrage beziehen, sodass Sie den Inhaltstyp angeben können und wie dieser behandelt werden soll.

Spezifikationen

Specification Status Comment
Fetch Lebender Standard Initial definition

Browserkompatibilität

BCD tables only load in the browser

Siehe auch