Fetch API

Die Fetch API bietet eine Schnittstelle zum Abrufen von Ressourcen (auch über das Netzwerk). Sie ist ein mächtigerer und flexiblerer Ersatz für XMLHttpRequest.

In diesem Artikel

Konzepte und Verwendung

Die Fetch API verwendet Request und Response Objekte (und andere Dinge im Zusammenhang mit Netzwerk-Anfragen), sowie verwandte Konzepte wie CORS und die Semantik des HTTP Origin-Headers.

Um eine Anfrage zu stellen und eine Ressource abzurufen, nutzen Sie die fetch() Methode. Diese ist eine globale Methode sowohl im Window als auch im Worker Kontext. Dadurch ist sie in fast jedem Kontext verfügbar, in dem Sie Ressourcen abrufen möchten.

Die fetch() Methode benötigt ein obligatorisches Argument, den Pfad zu der Ressource, die Sie abrufen möchten. Sie gibt ein Promise zurück, das auf die Response dieser Anfrage auflöst — sobald der Server mit Headers antwortet — selbst wenn der Server mit einem HTTP-Fehlerstatus antwortet. Sie können optional auch ein init-Optionsobjekt als zweites Argument übergeben (siehe Request).

Sobald eine Response abgerufen ist, stehen zahlreiche Methoden zur Verfügung, um zu definieren, was der Body-Inhalt ist und wie er behandelt werden sollte.

Sie können eine Anfrage und Antwort direkt über die Konstruktoren Request() und Response() erstellen, aber es ist ungewöhnlich, dies direkt zu tun. Stattdessen werden diese eher als Ergebnis anderer API-Aktionen erstellt (zum Beispiel, FetchEvent.respondWith() von Service Workern).

Erfahren Sie mehr über die Verwendung der Fetch API-Funktionen in Using Fetch.

Deferred Fetch

Die fetchLater() API ermöglicht es einem Entwickler, einen deferred fetch anzufordern, der nach einem bestimmten Zeitraum oder wenn die Seite geschlossen oder navigiert wird, gesendet werden kann. Siehe Using Deferred Fetch.