Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten.Erfahre mehr über dieses Experiment.
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 März 2017.
* Some parts of this feature may have varying levels of support.
Hinweis: Diese Funktion ist nur inWeb Workers verfügbar.
Diefetch()-Methode desWorkerGlobalScope-Interfaces 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 demResponse-Objekt auf, das die Antwort auf Ihre Anfrage darstellt.
Einfetch()-Promise wird nur abgelehnt, wenn die Anfrage fehlschlägt, beispielsweise aufgrund einer fehlerhaft formatierten URL oder eines Netzwerkfehlers.Einfetch()-Promise wirdnicht abgelehnt, wenn der Server mit HTTP-Statuscodes antwortet, die Fehler anzeigen (404,504, etc.).Stattdessen muss einthen()-Handler die EigenschaftenResponse.ok und/oderResponse.status überprüfen.
Diefetch()-Methode wird durch dieconnect-src-Directive derContent Security Policy kontrolliert, anstatt durch die Direktive der Ressourcen, die sie abruft.
Hinweis:Die Parameter derfetch()-Methode sind identisch mit denen desRequest()-Konstruktors.
Syntax
fetch(resource)fetch(resource, options)Parameter
resourceDies definiert die Ressource, die Sie abrufen möchten. Dies kann entweder sein:
- Ein String oder ein anderes Objekt mit einemStringifier — einschließlich eines
URL-Objekts — das die URL der Ressource bereitstellt, die Sie abrufen möchten. Die URL kann relativ zur Basis-URL sein, die im Fensterkontext diebaseURIdes Dokuments oder im Worker-KontextWorkerGlobalScope.locationist. - Ein
Request-Objekt.
- Ein String oder ein anderes Objekt mit einemStringifier — einschließlich eines
optionsOptionalEin
RequestInit-Objekt, das benutzerdefinierte Einstellungen enthält, die Sie auf die Anfrage anwenden möchten.
Rückgabewert
Ausnahmen
AbortErrorDOMExceptionDie Anfrage wurde abgebrochen aufgrund eines Aufrufs der
AbortController-Methodeabort().NotAllowedErrorDOMExceptionAusgelöst, wenn die Nutzung derTopics API ausdrücklich durch eine
browsing-topicsPermissions Policy untersagt ist, und einefetch()-Anfrage mitbrowsingTopics: truegestellt wurde.TypeErrorEin Fehler, wenn die Fetch-Operation nicht ausgeführt werden konnte.Siehe
Window.fetch()für eine Liste der Gründe, warum dieser Fehler auftreten kann.
Beispiele
Siehefetch() für Beispiele.
Spezifikationen
| Specification |
|---|
| Fetch # fetch-method |