SharedWorkerGlobalScope.onconnect

La proriété onconnect de l'interface SharedWorkerGlobalScope (en-US) est un gestionnaire d'évènement pour l'évènement connect, c'est à dire quand une connexion MessagePort (en-US) est ouverte entre le SharedWorker et le thread principale.

Syntaxe

js
onconnect = function() { ... };

Exemple

Cet exemple montre le gestionnaire d'évènement onconnect quand une connection depuis le thread principal vers un fichier de worker partagé via un MessagePort (en-US). L'objet évènement est un MessageEvent.

Le port de connexion peut-être récupéré avec la propriété ports de l'objet évènement. Le port a un gestionnaire d'évènement onmessage pour gérer les évènement venant de cet port et la méthode postMessage() peut-être utilisée pour répondre au thread principale qui utilise le worker.

js
onconnect = function (e) {
  var port = e.ports[0];

  port.onmessage = function (e) {
    var workerResult = "Result: " + e.data[0] * e.data[1];
    port.postMessage(workerResult);
  };

  port.start();
};

Pour l'exemple complet en fonctionnement, voir Basic shared worker example (run shared worker.)

Note : La propriété data de l'objet évènement est null dans Firefox. À partir de la version 65, elle est initialisée comme une chaîne vide, selon les spécifications (bug Firefox 1508824).

Spécifications

Specification
HTML Standard
# event-workerglobalscope-connect
HTML Standard
# handler-sharedworkerglobalscope-onconnect

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi