WorkerGlobalScope: fetch() Methode

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 nur in Web Workers verfügbar.

Die fetch() Methode der WorkerGlobalScope-Schnittstelle startet den Prozess des Abrufens einer Ressource aus dem Netzwerk und gibt ein Promise zurück, das erfüllt wird, sobald die Antwort verfügbar ist.

Das Promise löst sich zu dem Response-Objekt auf, das die Antwort auf Ihre Anfrage darstellt.

Ein fetch()-Promise weist nur dann einen Fehler zurück, wenn die Anfrage fehlschlägt, zum Beispiel aufgrund einer schlecht formatierten Anfrage-URL oder eines Netzwerkfehlers. Ein fetch()-Promise wird nicht zurückgewiesen, wenn der Server mit HTTP-Statuscodes antwortet, die Fehler anzeigen (404, 504, etc.). Stattdessen muss ein then()-Handler die Eigenschaften Response.ok und/oder Response.status prüfen.

Die fetch()-Methode wird durch die connect-src-Direktive der Content Security Policy kontrolliert, anstatt durch die Direktive der Ressourcen, die sie abruft.

Hinweis: Die Parameter der fetch()-Methode sind identisch mit denen des Request()-Konstruktors.

Syntax

fetch(resource)
fetch(resource, options)

Parameter

resource

Definiert die Ressource, die Sie abrufen möchten. Diese kann entweder sein:

Ein String oder ein anderes Objekt mit einem Stringifier — einschließlich eines URL-Objekts —, das die URL der Ressource liefert, die Sie abrufen möchten. Die URL kann relativ zur Basis-URL sein, welche der baseURI im Dokumentenkontext oder WorkerGlobalScope.location im Worker-Kontext ist.
Ein Request-Objekt.

options Optional

Ein RequestInit-Objekt, das alle benutzerdefinierten Einstellungen enthält, die Sie auf die Anfrage anwenden möchten.

Rückgabewert

Ein Promise, das zu einem Response-Objekt auflöst.

Ausnahmen

AbortError DOMException: Die Anfrage wurde aufgrund eines Aufrufs der AbortController abort()-Methode abgebrochen.
NotAllowedError DOMException: Wird ausgelöst, wenn die Nutzung der Topics API durch eine browsing-topics Berechtigungsrichtlinie speziell untersagt ist, und eine fetch()-Anfrage mit browsingTopics: true gestellt wurde.
TypeError: Ein Fehler, wenn die Fetch-Operation nicht durchgeführt werden konnte. Siehe Window.fetch() Ausnahmen für eine Liste der Gründe, warum dieser Fehler auftreten kann.

Beispiele

Siehe fetch() für Beispiele.

Spezifikationen

Specification
Fetch # fetch-method