在此页

• 构造函数
• 特性
• 方法
• 事件
• 范例
• 规范
• 浏览器兼容性
• 另请参阅
• 相关话题

Worker 接口在 Web 工作者 API represents a background task that can be created via script, which can send messages back to its creator. Creating a worker is done by calling the Worker("path/to/worker/script") 构造函数。

Workers may themselves spawn new workers, as long as those workers are hosted at the same origin as the parent page. (Note: nested workers are not yet implemented in WebKit ).

Not all interfaces and functions are available to scripts inside a Worker . Workers may use XMLHttpRequest for network communication, but its responseXML and channel attributes are always null . ( fetch is also available, with no such restrictions.)

构造函数

Worker()

Creates a dedicated web worker that executes the script at the specified URL. This also works for Blob URL .

特性

继承的特性来自其父级， EventTarget ，和实现的特性来自 AbstractWorker .

事件处理程序

AbstractWorker.onerror

EventListener called whenever an ErrorEvent 类型 error bubbles through to the worker. This is inherited from AbstractWorker .

Worker.onmessage

EventListener called whenever a MessageEvent 类型 message bubbles through the worker — i.e. when a message is sent to the parent document from the worker via DedicatedWorkerGlobalScope.postMessage . The message is stored in the event's data 特性。

Worker.onmessageerror

是 EventHandler 表示要调用的代码当 messageerror 事件被引发。

方法

继承方法来自其父级 EventTarget , and implements methods from AbstractWorker .

Worker.postMessage()

Sends a message — consisting of any JavaScript object — to the worker's inner scope.

Worker.terminate()

Immediately terminates the worker. This does not let worker finish its operations; it is halted at once. ServiceWorker instances do not support this method.

事件

message

Fires when the worker's parent receives a message from that worker.
也可用凭借 onmessage 特性。

messageerror

Fires when a Worker object receives a message that can't be deserialized .
也可用凭借 onmessageerror 特性。

rejectionhandled

Fires every time a Promise rejects, regardless of whether or not there is a handler to catch the rejection.
Also available through the onrejectionhandled event handler property.

unhandledrejection

Fires when a Promise rejects with no handler to catch the rejection.
Also available using the onunhandledrejection event handler property.

范例

The following code snippet creates a Worker 对象使用 Worker() constructor, then uses the worker object:

var myWorker = new Worker('/worker.js');
var first = document.querySelector('input#number1');
var second = document.querySelector('input#number2');
first.onchange = function() {
  myWorker.postMessage([first.value, second.value]);
  console.log('Message posted to worker');
}
						

For a full example, see our Basic dedicated worker example ( run dedicated worker ).

规范

规范	状态	注释
HTML 实时标准 在该规范中的 Worker 定义。	实时标准

浏览器兼容性

Support varies for different types of workers. See each worker type's page for specifics.

The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
Worker	Chrome 4	Edge 12	Firefox 3.5	IE 10	Opera 10.6	Safari 4	WebView Android 4	Chrome Android 18	Firefox Android 4	Opera Android 11	Safari iOS 5.1	Samsung Internet Android 1.0
Worker() 构造函数	Chrome 4	Edge 12	Firefox 3.5	IE 10	Opera 10.6	Safari 4	WebView Android 4	Chrome Android 18	Firefox Android 4	Opera Android 11	Safari iOS 5.1	Samsung Internet Android 1.0
message event	Chrome 4	Edge 12	Firefox 3.5	IE 10	Opera 10.6	Safari 4	WebView Android 4	Chrome Android 18	Firefox Android 4	Opera Android 11.5	Safari iOS 5.1	Samsung Internet Android 1.0
messageerror event	Chrome 60	Edge 18	Firefox 57	IE ?	Opera 47	Safari ?	WebView Android 60	Chrome Android 60	Firefox Android 57	Opera Android 47	Safari iOS ?	Samsung Internet Android 8.0
onmessage	Chrome 4	Edge 12	Firefox 3.5	IE 10	Opera 10.6	Safari 4	WebView Android 4	Chrome Android 18	Firefox Android 4	Opera Android 11	Safari iOS 5.1	Samsung Internet Android 1.0
onmessageerror	Chrome 60	Edge 18	Firefox 57	IE ?	Opera 47	Safari ?	WebView Android 60	Chrome Android 60	Firefox Android 57	Opera Android 44	Safari iOS ?	Samsung Internet Android 8.0
postMessage	Chrome Yes	Edge 12	Firefox Yes	IE 10 10 Internet Explorer does not support Transferable 对象。	Opera 47	Safari Yes	WebView Android Yes	Chrome Android Yes	Firefox Android Yes	Opera Android 44	Safari iOS Yes	Samsung Internet Android Yes
terminate	Chrome 4	Edge 12	Firefox 3.5	IE 10	Opera 10.6	Safari 4	WebView Android 4	Chrome Android 18	Firefox Android 4	Opera Android 11	Safari iOS 5.1	Samsung Internet Android 1.0

图例

完整支持

完整支持

兼容性未知 ?

兼容性未知

见实现注意事项。

Cross-origin worker error behaviour

In early versions of the spec, loading a cross-origin worker script threw a SecurityError . Nowadays, an error event is thrown instead. Find out how to deal with this in Loading cross-origin worker now fires error event instead of throwing; worker in sandboxed iframe no longer allowed .

另请参阅

• 使用 Web 工作者
• 可用于 Web 工作者的函数和类
• Other kind of workers: SharedWorker and Service Worker .

元数据

• 最后修改： Aug 26, 2020

相关话题

1. Web 工作者 API
2. Worker
3. 构造函数

   1. Worker()
4. 特性

   1. onerror
   2. onmessage
   3. onmessageerror
5. 方法

   1. postMessage()
   2. terminate()
6. 事件

   1. message
   2. messageerror
7. 继承：

   1. EventTarget
8. Web 工作者 API 相关页面

   1. AbstractWorker
   2. ChromeWorker
   3. DedicatedWorkerGlobalScope
   4. ServiceWorker
   5. SharedWorker
   6. SharedWorkerGlobalScope
   7. WorkerGlobalScope
   8. WorkerLocation
   9. WorkerNavigator