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: Dieses Feature ist nur verfügbar in Web Workers.
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
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 diebaseURI
des Dokuments ist oderWorkerGlobalScope.location
im Worker-Kontext. - Ein
Request
-Objekt.
- Ein String oder ein Objekt mit einem Stringifier — einschließlich eines
options
Optional-
Ein
RequestInit
-Objekt, das alle benutzerdefinierten Einstellungen enthält, die Sie auf die Anfrage anwenden möchten.
Rückgabewert
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 einefetch()
-Anfrage mitbrowsingTopics: 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