ServiceWorker: метод postMessage()

Метод postMessage() интерфейса ServiceWorker отправляет сообщение в рабочий процесс. Первый параметр — данные, которые необходимо отправить в рабочий процесс. Данные могут быть любым JavaScript-объектом, который может быть обработан алгоритмом структурированного клонирования.

Рабочий процесс может отправлять информацию своим клиентам, используя метод postMessage(). Сообщение не будет отправлено обратно этому объекту ServiceWorker, а связанному объекту ServiceWorkerContainer, доступному через navigator.serviceWorker.

message

Объект, который необходимо передать в рабочий процесс; он будет находиться в поле data в событии, переданном событию message. Это может быть любой JavaScript-объект, обработанный алгоритмом структурированного клонирования.

Параметр message является обязательным. Если данные, передаваемые в рабочий процесс, не важны, null или undefined должны быть явно указаны.

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

Необязательный массив массив передаваемых объектов, для передачи права собственности. Право собственности на эти объекты передается стороне назначения, и они больше не могут использоваться на стороне отправки. Эти передаваемые объекты должны быть присоединены к сообщению; в противном случае они будут перемещены, но на самом деле не будут доступны на стороне получателя.

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

Необязательный объект, содержащий следующие свойства:

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

Имеет то же значение, что и параметр transfer.

Ничего (undefined).

SyntaxError

Выбрасывается, если параметр message не указан.

В этом примере создается ServiceWorker и сразу же отправляется сообщение:

navigator.serviceWorker.register("service-worker.js");

navigator.serviceWorker.ready.then((registration) => {
  registration.active.postMessage(
    "Test message sent immediately after creation",
  );
});

Для получения сообщения рабочий процесс, в service-worker.js должен прослушивать событие message в своем глобальном пространстве имен.

// This must be in `service-worker.js`
addEventListener("message", (event) => {
  console.log(`Message received: ${event.data}`);
});

Обратите внимание, что рабочий процесс может отправлять сообщения обратно в основной поток, используя метод postMessage(). Для их получения основной поток должен прослушивать событие message в объекте ServiceWorkerContainer.

• Интерфейс ServiceWorker, к которому он принадлежит.
• Его аналог, метод postMessage(), который должен использовать рабочий процесс для отправки сообщения обратно связанному объекту ServiceWorkerContainer.