Worker.postMessage()

La méthode Worker.postMessage() envoie un message à la portée locale du worker. Cette fonction accepte un seul paramètre, qui est la donnée à envoyer au worker. Cette donnée peut-être de n'importe quelle valeur ou un objet JavaScript pris en charge par l'algorithme de clone structuré, qui inclut les références cycliques.

Si cette méthode est appelée à l'intérieur du Worker, cela va envoyer un évènement  message  sur l'objet Worker  dans le thread principal : de cette manière, un Worker peut retourner de l'information au thread qui l'a créé.

Syntaxe

worker.postMessage(aMessage, transferList);

Paramètres

aMessage

L'objet à envoyer au worker ; il va être dans le champ de donnée dans l'évènement délivré au handler Worker.onmessage. Cette donnée peut être de n'importe quelle valeur ou un objet JavaScript pris en charge par l'algorithme de clone structuré, qui inclut les références cycliques.

transferList Facultatif

Un tableau optionnel d'objets Transferable  desquels on doit transférer la propriété. Si la propriété d'un objet est transférée, il devient inutilisable (neutralisé) pour le contexte dans lequel il était envoyé et devient disponible uniquement pour le worker auquel cela a été envoyé.

Seulement des objets de types MessagePort et ArrayBuffer peuvent être transférés.

Spécifications

Compatibilité des navigateurs

[1] Internet Explorer 10 accepte un seul objet Transferable comme paramètre, mais pas un tableau.

Voir aussi

• L'interface Worker auquel il appartient.