Aller au contenu principal

MessagePortMain

MessagePortMain est l’équivalent de MessagePort du DOM mais coté processus principal. Il se comporte de la même manière que la version DOM, sauf qu'il utilise le système d'événements de Node.js EventEmitter au lieu du système EventTarget du DOM. Cela signifie que vous devrez utiliser port.on('message', ...) pour écouter les événements, au lieu de port. nmessage = ... ou port.addEventListener('message', ...)

Pour plus d'informations sur son utilisation consultez la documentation de Channel Messaging API.

MessagePortMain est un EventEmitter.

Classe: MessagePortMain

Assure l''nteraction avec un canal de messages dans le processus principal.

Processus : Principal
Cette classe n'est pas exportée depuis le module 'electron'. Elle n'est disponible qu'en tant que valeur de retour des autres méthodes dans l'API Electron.

Méthodes d’instance

port.postMessage(message, [transfer])

  • message any
  • transfer MessagePortMain[] (facultatif)

Envoie un message depuis le port, et le cas échéant, transfère la propriété d'objets à d’autres contextes de navigation.

port.start()

Démarre l'envoi de messages en file d'attente sur le port. Les messages seront mis en file d'attente jusqu'à ce que cette méthode soit appelée.

port.close()

Déconnecte le port qui ne sera donc plus actif.

Événements d’instance

Événement : 'message'

Retourne :

  • Objet messageEvent
    • data {any}
    • ports MessagePortMain[]

Émis lorsqu'un objet MessagePortMain reçoit un message.

Événement : 'close'

Émis lorsque l’extrémité distante d’un objet MessagePortMain devient déconnectée.