WorkerGlobalScope: importScripts()-Methode

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

Die importScripts()-Methode des WorkerGlobalScope-Interfaces importiert synchron ein oder mehrere Skripte in den Workers-Bereich.

Syntax

js
importScripts(path0)
importScripts(path0, path1)
importScripts(path0, path1, /* …, */ pathN)

Parameter

pathN

Ein String-Wert, der die URL des zu importierenden Skripts darstellt. Die URL kann absolut oder relativ sein. Ist die URL relativ, bezieht sie sich auf die URL des Einstiegs-Skripts des Workers.

Rückgabewert

Keiner (undefined).

Ausnahmen

NetworkError

Importierte Skripte wurden ohne einen text/javascript MIME-Typ oder ohne einen der erlaubten Legacy-JavaScript-MIME-Typen bereitgestellt.

TypeError

Wird ausgelöst, wenn der aktuelle WorkerGlobalScope ein Modul ist. Verwenden Sie stattdessen import.

Beispiele

Wenn Sie eine Funktionalität in einem separaten Skript namens foo.js geschrieben haben, die Sie in worker.js verwenden möchten, könnten Sie es mit der folgenden Zeile importieren:

js
importScripts("foo.js");

foo.js sollte sich im selben URL-Teilbaum wie der Einstiegspunkt des Workers befinden — zum Beispiel, wenn dieser Worker mit new Worker("worker.js") erstellt wurde, dann ist worker.js der Einstiegspunkt. Befindet sich worker.js unter https://example.com/scripts/worker.js, dann sollte foo.js unter https://example.com/scripts/foo.js sein.

importScripts() und self.importScripts() sind im Wesentlichen gleichwertig — beide repräsentieren importScripts(), das aus dem inneren Bereich des Workers aufgerufen wird.

Spezifikationen

Specification
HTML
# dom-workerglobalscope-importscripts-dev

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
importScripts
Strict MIME type checks for importScripts()

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support

Siehe auch