Client.postMessage()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨avril 2018⁩.

Expérimental: Il s'agit d'une technologie expérimentale.
Vérifiez attentivement le tableau de compatibilité des navigateurs avant de l'utiliser en production.

La méthode postMessage() de l'interface Client permet à un service worker client d'envoyer un message à un ServiceWorker.

Syntaxe

Client.postMessage(message[, transfer]);

Paramètres

message: Le message à envoyer au service worker.
transfer Facultatif: Un objet transferable, comme par exemple une référence à un port.

Ce fragment de code est tiré de l'exemple d'envoi de message du service worker exemple d'envoi de message du service worker (voir exemple en ligne). Le code envoi un message et transfert le port vers le service worker qui pourra répondre via Client.postMessage().

Ce message est contenu dans une promesse qui se résolvera si la réponse ne contient pas d'erreur et qui échouera avec l'erreur.

function sendMessage(message) {
  return new Promise(function (resolve, reject) {
    var messageChannel = new MessageChannel();
    messageChannel.port1.onmessage = function (event) {
      if (event.data.error) {
        reject(event.data.error);
      } else {
        resolve(event.data);
      }
    };
    navigator.serviceWorker.controller.postMessage(message, [
      messageChannel.port2,
    ]);
  });
}