Fetch API
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2017.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die Fetch API bietet eine Schnittstelle zum Abrufen von Ressourcen (einschließlich über das Netzwerk). Sie ist ein leistungsfähigerer und flexiblerer Ersatz für XMLHttpRequest
.
Konzepte und Verwendung
Die Fetch API verwendet Request
- und Response
-Objekte (und andere Dinge, die mit Netzwerkanforderungen zu tun haben), sowie verwandte Konzepte wie CORS und die HTTP-Origin-Header-Semantik.
Um eine Anforderung zu stellen und eine Ressource abzurufen, verwenden Sie die fetch()
-Methode. Diese Methode ist global sowohl im Window
-Kontext als auch im Worker
-Kontext verfügbar. Dadurch ist sie in nahezu jedem Kontext verfügbar, in dem Sie Ressourcen abrufen möchten.
Die fetch()
-Methode nimmt ein obligatorisches Argument, den Pfad zur abzurufenden Ressource. Sie gibt ein Promise
zurück, das auf die Response
dieser Anforderung aufgelöst wird — sobald der Server mit Headern antwortet — selbst wenn die Serverantwort ein HTTP-Fehlerstatus ist. Sie können auch optional ein init'-Optionsobjekt als zweites Argument übergeben (siehe [
Request`](/de/docs/Web/API/Request)).
Sobald eine Response
abgerufen wurde, gibt es eine Reihe von Methoden, um festzulegen, was der Inhalt des Körpers ist und wie er behandelt werden soll.
Sie können eine Anforderung und Antwort direkt mit den Konstruktoren Request()
und Response()
erstellen, aber es ist selten, dies direkt zu tun. Stattdessen werden sie eher als Ergebnisse anderer API-Aktionen erstellt (zum Beispiel FetchEvent.respondWith()
von Service Workern).
Erfahren Sie mehr über die Verwendung der Funktionen der Fetch API in Using Fetch.
Fetch-Schnittstellen
Window.fetch()
undWorkerGlobalScope.fetch()
-
Die
fetch()
-Methode, die zum Abrufen einer Ressource verwendet wird. Headers
-
Stellt Antwort-/Anforderungs-Header dar und ermöglicht es Ihnen, sie abzufragen und je nach Ergebnis unterschiedliche Aktionen durchzuführen.
Request
-
Stellt eine Ressourcenanforderung dar.
Response
-
Stellt die Antwort auf eine Anforderung dar.
Spezifikationen
Specification |
---|
Fetch Standard # fetch-method |
Browser-Kompatibilität
BCD tables only load in the browser