大网数据广告活动
Web 标准与前端开发

Worker()

· 52CE 我爱测

`Worker()`** 构造函数创建一个 Worker 对象,该对象执行指定的 URL 脚本。这个脚本必须遵守 同源策略 。

Web Workers API

Worker() 构造函数创建一个 Worker 对象,该对象执行指定的 URL 脚本。这个脚本必须遵守 同源策略 。

如果 此 URL 有一个无效的语句,或者违反同源策略,一个 SECURITY_ERR 类型的DOMException被抛出。

[!NOTE] 浏览器厂商对于 data URI 是否同源存在分歧。尽管 Gecko 10.0 和之后的版本接受 data URIs,但在所有其他浏览器中并非如此。

语法

const myWorker = new Worker(aURL, options);

参数

  • 如果文档不允许启动 worker,则会引发 SecurityError

  • 如果脚本之一的 MIME 类型为 text/csv, image/*, video/*,或 audio/*, 则会引发 NetworkError。它应该始终是 text/javascript。

  • 如果 aURL 无法解析,则引发 SyntaxError。

  • aURL

    • : 是一个String 表示 worker 将执行的脚本的 URL。它必须遵守同源策略。
  • options

    • : 包含可在创建对象实例时设置的选项属性的对象。可用属性如下:
      • type:用以指定 worker 类型的 String 值。该值可以是 classic 或 module. 如果未指定,将使用默认值 classic.
      • credentials:用以指定 worker 凭证的 String 值。该值可以是* omit*, same-origin,或 include.。如果未指定,或者 type 是 classic,将使用默认值 omit (不要求凭证)。
      • *name:*在 DedicatedWorkerGlobalScope 的情况下,用来表示 worker 的 scope 的一个 String 值,主要用于调试目的。

返回值

创建的 worker。

异常

  • 当 document 不被允许启动 worker 的时候,将抛出一个 SecurityError 异常。例如:如果提供的 aURL 有语法错误,或者与同源策略相冲突(跨域访问)。
  • 如果 worker 的 MIME 类型不正确,将抛出一个 NetworkError 异常。worker 的 MIME 类型必须是 text/javascript。
  • 如果 aURL 无法被解析(格式错误),将抛出一个 SyntaxError 异常。

例子

下面的代码片段展示了通过 Worker() 创建 Worker 对象的过程,以及随后的使用方法:

let myWorker = new Worker("worker.js");

first.onchange = function () {
  myWorker.postMessage([first.value, second.value]);
  console.log("Message posted to worker");
};

完整的例子请看 Basic dedicated worker example (run dedicated worker).

规范

浏览器兼容性

[!NOTE] 浏览器可以被标记为对Worker()的完全支持尽管他并不支持一个以 modules 类型编写的脚本。截至 2019 年 8 月 1 日,暂无浏览器支持以模块类型编写的脚本。如果没有这种支持,moduleds 类型的脚本必须使用编译器翻译成无 module 代码才能在浏览器上运行。

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。