WorkerGlobalScope: importScripts() 方法

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

importScripts() 方法是 WorkerGlobalScope 接口的一种方法,它同步地将一个或多个脚本导入到工作者的作用域中。

语法

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

参数

pathN

一个字符串值,表示要导入的脚本的 URL。该 URL 可以是绝对的或相对的。如果 URL 是相对的,则它相对于工作者入口脚本的 URL。

返回值

无 (undefined).

异常

NetworkError

导入的脚本在没有 text/javascript MIME 类型或没有允许的 传统 JavaScript MIME 类型 的情况下被提供。

TypeError

如果当前 WorkerGlobalScope 是一个模块,则抛出该异常。请改用 import

示例

如果您在名为 foo.js 的单独脚本中编写了一些功能,并且希望在 worker.js 中使用这些功能,则可以使用以下代码行导入它

js
importScripts("foo.js");

foo.js 应该与工作者的入口点位于同一个 URL 子树中 — 例如,如果此工作者是使用 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() 实际上是等效的 — 它们都代表从工作者的内部作用域中调用的 importScripts()

规范

规范
HTML 标准
# dom-workerglobalscope-importscripts-dev

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参见