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 (und andere Dinge, die mit Netzwerkanfragen verbunden sind), sowie verwandte Konzepte wie CORS und die Semantik des HTTP-Origin-Headers.
Um eine Anfrage zu stellen und eine Ressource abzurufen, verwenden Sie die Methode fetch(). Es ist eine globale Methode sowohl im Window- als auch im Worker-Kontext. Dies macht sie in so ziemlich jedem Kontext verfügbar, in dem Sie Ressourcen abrufen möchten.
Die fetch()-Methode erfordert ein obligatorisches Argument, den Pfad zu der Ressource, die Sie abrufen möchten. Sie gibt ein Promise zurück, das zur Response auf diese Anfrage aufgelöst wird – sobald der Server mit den Headern antwortet – auch wenn die Serverantwort ein HTTP-Fehlerstatus ist. Sie können optional auch 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 damit umgegangen werden soll.
Sie können eine Anfrage und Antwort direkt mit den Konstruktoren Request() und Response() erstellen, aber es ist ungewöhnlich, dies direkt zu tun. Diese werden stattdessen häufiger als Ergebnisse anderer API-Aktionen erstellt (zum Beispiel FetchEvent.respondWith() aus Service Workern).
Erfahren Sie mehr über die Verwendung der Fetch API-Funktionen im Verwenden von Fetch.
Schnittstellen
Window.fetch()undWorkerGlobalScope.fetch()-
Die
fetch()-Methode, die zum Abrufen einer Ressource verwendet wird. Headers-
Repräsentiert Antwort-/Anfrage-Header und ermöglicht es Ihnen, sie abzufragen und je nach Ergebnis unterschiedliche Aktionen durchzuführen.
Request-
Repräsentiert eine Ressourcenanforderung.
Response-
Repräsentiert die Antwort auf eine Anfrage.
Spezifikationen
| Specification |
|---|
| Fetch # fetch-method |