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() und WorkerGlobalScope.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

Siehe auch