SharedWorkerGlobalScope.onconnect

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

Syntaxe

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. 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.

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

Remarque: 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 1508824).

Spécifications

Spécification Status Commentaire
HTML Living Standard
La définition de 'onconnect' dans cette spécification.
Standard évolutif

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi