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 Nutzung
Die Fetch-API verwendet Request
- und Response
-Objekte (sowie andere Dinge, die mit Netzwerk-Anfragen zu tun haben), sowie verwandte Konzepte wie CORS und die Semantik des HTTP-Origin-Headers.
Um eine Anfrage zu stellen und eine Ressource abzurufen, verwenden Sie die fetch()
-Methode. Sie ist eine globale Methode sowohl in Window
- als auch in Worker
-Kontexten. Dadurch ist sie praktisch in jedem Kontext verfügbar, in dem Sie Ressourcen abrufen möchten.
Die Methode fetch()
erfordert ein obligatorisches Argument, den Pfad zur Ressource, die Sie abrufen möchten. Sie gibt ein Promise
zurück, das sich zur Response
auf diese Anfrage auflöst — sobald der Server mit Headern antwortet — sogar wenn die Serverantwort einen HTTP-Fehlerstatus enthält. Sie können auch optional ein init
-Optionsobjekt als zweites Argument übergeben (siehe Request
).
Sobald eine Response
abgerufen wurde, stehen eine Reihe von Methoden zur Verfügung, um zu definieren, was der Inhalt des Körpers ist und wie er behandelt werden soll.
Sie können eine Anfrage und eine Antwort direkt mit den Konstruktoren Request()
und Response()
erstellen, aber es ist unüblich, dies direkt zu tun. Stattdessen werden diese eher als Ergebnisse anderer API-Aktionen erstellt (zum Beispiel durch FetchEvent.respondWith()
von Service-Workern).
Erfahren Sie mehr über die Nutzung der Features der Fetch-API in Using Fetch.
Fetch-Schnittstellen
Window.fetch()
undWorkerGlobalScope.fetch()
-
Die
fetch()
-Methode, um eine Ressource abzurufen. Headers
-
Repräsentiert Antwort-/Anfrageheader und ermöglicht es Ihnen, diese abzufragen und unterschiedliche Aktionen je nach Ergebnis zu ergreifen.
Request
-
Repräsentiert eine Ressourcenanfrage.
Response
-
Repräsentiert die Antwort auf eine Anfrage.
Spezifikationen
Specification |
---|
Fetch # fetch-method |
Browser-Kompatibilität
BCD tables only load in the browser