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

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.

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:

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 Standard # dom-workerglobalscope-importscripts-dev

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch

WorkerGlobalScope