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

Siehe auch