跳到主要内容

MessagePortMain

MessagePortMain 是 DOM MessagePort 对象在主进程中的等效物。 它的行为类似于 DOM 版本,不同之处在于它使用 Node.js 的 EventEmitter 事件系统,而不是 DOM 的 EventTarget 系统。 这意味着你应该使用 port.on('message', ...) 来监听事件,而不是使用 port.onmessage = ...port.addEventListener('message', ...)

有关使用通道消息传递的更多信息,请参阅 Channel Messaging API 文档。

MessagePortMain 是一个 EventEmitter

类: MessagePortMain

主进程中用于通道消息传递的端口接口。

进程:主进程
此类不从 'electron' 模块导出。 它仅作为 Electron API 中其他方法的返回值可用。

实例方法

port.postMessage(message, [transfer])

  • message 任意类型
  • transfer MessagePortMain[] (可选)

从端口发送消息,并且可以选择将对象的拥有权转移给其他浏览上下文。

port.start()

启动端口上排队消息的发送。消息将一直排队,直到调用此方法。

port.close()

断开端口连接,使其不再处于活动状态。

实例事件

事件: 'message'

返回值

  • messageEvent 对象
    • data 任意类型
    • ports MessagePortMain[]

当 MessagePortMain 对象接收到消息时触发。

事件: 'close'

当 MessagePortMain 对象的远程端断开连接时触发。