Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten.Erfahre mehr über dieses Experiment.
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 März 2017.
* Some parts of this feature may have varying levels of support.
Hinweis: Diese Funktion ist inWeb 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ürXMLHttpRequest.
Konzepte und Nutzung
Die Fetch API verwendetRequest- undResponse-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 Methodefetch(). Es ist eine globale Methode sowohl imWindow- als auch imWorker-Kontext. Dies macht sie in so ziemlich jedem Kontext verfügbar, in dem Sie Ressourcen abrufen möchten.
Diefetch()-Methode erfordert ein obligatorisches Argument, den Pfad zu der Ressource, die Sie abrufen möchten. Sie gibt einPromise zurück, das zurResponse 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 eininit-Optionsobjekt als zweites Argument übergeben (sieheRequest).
Sobald eineResponse 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 KonstruktorenRequest() undResponse() erstellen, aber es ist ungewöhnlich, dies direkt zu tun. Diese werden stattdessen häufiger als Ergebnisse anderer API-Aktionen erstellt (zum BeispielFetchEvent.respondWith() aus Service Workern).
Erfahren Sie mehr über die Verwendung der Fetch API-Funktionen imVerwenden von Fetch.
Schnittstellen
Window.fetch()undWorkerGlobalScope.fetch()Die
fetch()-Methode, die zum Abrufen einer Ressource verwendet wird.HeadersRepräsentiert Antwort-/Anfrage-Header und ermöglicht es Ihnen, sie abzufragen und je nach Ergebnis unterschiedliche Aktionen durchzuführen.
RequestRepräsentiert eine Ressourcenanforderung.
ResponseRepräsentiert die Antwort auf eine Anfrage.
Spezifikationen
| Specification |
|---|
| Fetch # fetch-method |