Рабочий поток с общим доступом: конструктор SharedWorker()

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

aURL

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

name Необязательно

Строка, задающая идентифицирующее имя для SharedWorkerGlobalScope, представляющего область действия рабочего потока, что полезно для создания новых экземпляров одного и того же SharedWorker и отладки.

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

Объект, содержащий свойства параметров, которые могут быть установлены при создании экземпляра объекта. Доступные свойства следующие:

type

Строка, определяющая тип создаваемого рабочего потока. Значение может быть classic или module. Если не указано, по умолчанию используется classic.

credentials

Строка, определяющая тип используемых учетных данных для рабочего потока. Значение может быть omit, same-origin, или include. Если не указано или если тип classic, по умолчанию используется omit (нет необходимости в учетных данных).

name

Строка, задающая идентифицирующее имя для SharedWorkerGlobalScope, представляющего область действия рабочего потока, что в основном полезно для отладки.

sameSiteCookies

Строка, указывающая, какие SameSite куки должны быть доступны рабочему потоку. Может принимать одно из следующих двух значений:

'all'

SameSite=Strict, SameSite=Lax, и SameSite=None куки будут доступны рабочему потоку. Этот параметр поддерживается только в контексте первого уровня и является значением по умолчанию в контексте первого уровня.

'none'

Только SameSite=None куки будут доступны рабочему потоку. Этот параметр поддерживается в контексте первого и третьего уровня, и является значением по умолчанию в контексте третьего уровня.

SecurityError DOMException

Выбрасывается, если документу запрещено запускать рабочие потоки, например, если URL имеет недопустимый синтаксис или нарушается политика одинакового происхождения, или если значение sameSiteCookies не поддерживается в данном контексте.

NetworkError DOMException

Выбрасывается, если MIME-тип скрипта рабочего потока неверный. Он должен всегда быть text/javascript (по историческим причинам другие MIME-типы JavaScript могут быть приняты).

SyntaxError DOMException

Выбрасывается, если aURL не может быть обработана.

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

const myWorker = new SharedWorker("worker.js");

myWorker.port.start();

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

myWorker.port.onmessage = (e) => {
  result1.textContent = e.data;
  console.log("Message received from worker");
};

Для получения полного примера см. наш пример простого рабочего потока с общим доступом (запуск рабочего потока с общим доступом.)

• Интерфейс SharedWorker, к которому он относится.