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.
* Some parts of this feature may have varying levels of support.
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 # fetch-method |
Browser-Kompatibilität
Report problems with this compatibility data on GitHubdesktop | mobile | server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
fetch | ||||||||||||||
Authorization header removed from cross-origin redirects | ||||||||||||||
Support for blob: and data: | ||||||||||||||
Send ReadableStream in body | ||||||||||||||
init.attributionReporting parameter | ||||||||||||||
init.browsingTopics parameter | ||||||||||||||
init.duplex parameter | ||||||||||||||
init.keepalive parameter | ||||||||||||||
init.priority parameter | ||||||||||||||
init.referrerPolicy parameter | ||||||||||||||
init.signal parameter |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- No support
- No support
- Experimental. Expect behavior to change in the future.
- Non-standard. Check cross-browser support before using.
- See implementation notes.
- Has more compatibility info.