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.

Hinweis: Diese Funktion ist nur in Web Workers verfügbar.

Die fetch()-Methode der WorkerGlobalScope-Schnittstelle startet den Vorgang 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 wird zu dem Response-Objekt aufgelöst, das die Antwort auf Ihre Anfrage darstellt.

Ein fetch()-Promise schlägt nur fehl, wenn die Anfrage fehlschlägt, zum Beispiel wegen einer schlecht formatierten Anforderungs-URL oder eines Netzwerkfehlers. Ein fetch()-Promise wird nicht abgelehnt, 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 überprüfen.

Die fetch()-Methode wird von der connect-src-Richtlinie der Content Security Policy kontrolliert und nicht von der Richtlinie der Ressourcen, die sie abruft.

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

Syntax

js
fetch(resource)
fetch(resource, options)

Parameter

resource

Dies definiert die Ressource, die Sie abrufen möchten. Dies kann entweder sein:

  • Ein String oder ein Objekt mit einem Stringifier — einschließlich eines URL-Objekts — das die URL der Ressource bereitstellt, die Sie abrufen möchten. Die URL kann relativ zur Basis-URL sein, was im Fensterkontext die baseURI des Dokuments ist oder WorkerGlobalScope.location im Worker-Kontext.
  • 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 aufgelöst wird.

Ausnahmen

AbortError DOMException

Die Anfrage wurde aufgrund eines Aufrufs der AbortController abort()-Methode abgebrochen.

NotAllowedError DOMException

Ausgelöst, wenn die Verwendung der Topics API durch eine browsing-topics Permissions Policy ausdrücklich untersagt ist, und eine fetch()-Anfrage mit browsingTopics: true gemacht wurde.

TypeError

Ein Fehler, wenn der fetch-Vorgang nicht ausgeführt werden konnte. Siehe Window.fetch()-Ausnahmen für eine Liste der Gründe, warum dieser Fehler auftreten kann.

Beispiele

Sehen Sie fetch() für Beispiele.

Spezifikationen

Specification
Fetch Standard
# fetch-method

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch