WorkerGlobalScope: importScripts() 方法

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

注意:此功能僅在 Web Workers 中可用。

WorkerGlobalScope 介面的 importScripts() 方法將一個或多個指令碼同步匯入到 worker 的作用域中。

語法

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

引數

pathN

一個表示要匯入的指令碼的 URL 的字串值。URL 可以是絕對的也可以是相對的。如果 URL 是相對的,則它是相對於 worker 入口指令碼的 URL。

返回值

無(undefined)。

異常

NetworkError

匯入的指令碼是以非 text/javascript MIME 型別或未經允許的 舊版 JavaScript MIME 型別提供的。

TypeError

如果當前的 WorkerGlobalScope 是一個模組,則會丟擲此異常。請使用 import 代替。

示例

如果你有一些功能寫在名為 foo.js 的單獨指令碼中,並且想在 worker.js 中使用它,你可以使用以下行匯入它:

js
importScripts("foo.js");

foo.js 應該位於與 worker 入口點相同的 URL 子樹中 — 例如,如果此 worker 是使用 new Worker("worker.js") 建立的,則 worker.js 是入口點。如果 worker.js 位於 https://example.com/scripts/worker.js,則 foo.js 應該位於 https://example.com/scripts/foo.js

importScripts()self.importScripts() 的作用基本相同 — 兩者都表示從 worker 內部作用域呼叫 importScripts()

規範

規範
HTML
# dom-workerglobalscope-importscripts-dev

瀏覽器相容性

另見