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

Spécification Statut Commentaire
WHATWG HTML Living Standard
La définition de 'Worker.postMessage()' dans cette spécification.
Living Standard Aucun changement de Web Workers.
Web Workers
La définition de 'Worker.postMessage()' dans cette spécification.
Candidate Recommendation Définition initiale.

Compatibilité des navigateurs

Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Support de base (Oui) (Oui) 10.0 [1] (Oui) (Oui)
Fonctionnalité Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Support de base (Oui) (Oui) 10.0 [1] (Oui) (Oui)

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

Voir aussi

  • L'interface Worker auquel il appartient.

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : fscholz, J.DMB, Whimzfreak
 Dernière mise à jour par : J.DMB,