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

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. 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
# event-workerglobalscope-connect
HTML
# handler-sharedworkerglobalscope-onconnect

Compatibilité des navigateurs

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
connect event

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
See implementation notes.
Has more compatibility info.

Voir aussi