Worker()

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

* Some parts of this feature may have varying levels of support.

Конструктор Worker() создаёт объект Worker, который выполняет скрипт по указанному URL-адресу. Этот скрипт должен подчиняться политике одного источника (same-origin policy).

Если URL имеет недопустимый синтаксис или нарушена политика одного источника, то будет вызвано DOMException типа SECURITY_ERR.

Примечание: There is a disagreement among browser manufacturers about whether a data URI is of the same origin or not. Though Gecko 10.0 and later accept data URIs, that's not the case in all other browsers.

Синтаксис

js
var myWorker = new Worker(aURL, options);

Параметры

aURL

USVString, представляющая URL-адрес скрипта который будет выполняться worker. Он должен подчиняться политике одного источника.

options Необязательный

An object containing option properties that can be set when creating the object instance. Available properties are as follows:

  • type: A DOMString specifying the type of worker to create. The value can be classic or module. If not specified, the default used is classic.
  • credentials: A DOMString specifying the type of credentials to use for the worker. The value can be* omit*, same-origin, or include. If not specified, or if type is classic, the default used is omit (no credentials required).
  • _name: A _DOMString specifying an identifying name for the DedicatedWorkerGlobalScope representing the scope of the worker, which is mainly useful for debugging purposes.

Исключения

  • A SecurityError is raised if the document is not allowed to start workers.
  • A NetworkError is raised if the MIME type of one of the script is text/csv, image/*, video/*, or audio/*. It should always be text/javascript.
  • A SyntaxError is raised if a URL cannot be parsed.

Пример

Следующий фрагмент кода показывает создание объекта Worker с помощью конструктора Worker() и его последующее использование:

js
var 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).

Спецификации

Specification
HTML
# dom-worker-dev

Совместимость с браузерами

Смотрите также

Интерфейс Worker