ipcMain

    进程：主进程

    ipcRenderer 是一个 的实例。 当在主进程中使用时，它处理从渲染器进程（网页）发送出来的异步和同步信息。 从渲染器进程发送的消息将被发送到该模块。

    欲了解用法示例，请查看 进程间通信（IPC）教程。

    也可以从主进程向渲染进程发送消息，查阅webContents.send获取更多信息。

    • 发送消息时，事件名称为channel 。
    • 可以使用event.reply(...)将异步消息发送回发送者。 此方法将自动处理从非主 frame 发送的消息(比如： iframes)。相应的发送方法是: event.sender.send(...) 它将总是把消息发送到主 frame

    IpcMain模块有以下方法来侦听事件：

    • channel string
    • listener Function
      • event
      • ...args any[]

    ipcMain.once(channel, listener)

    • channel string
    • listener Function
      • ...args any[]

    添加一次性 listener 函数。 这个 listener 只会在 channel下一次收到消息的时候被调用，之后这个监听器会被移除。

    • channel string
    • listener Function
      • ...args any[]

    为特定的 channel 从监听队列中删除特定的 listener 监听者.

    ipcMain.removeAllListeners([channel])

    移除所有指定 channel 的监听器； 若未指定 channel，则移除所有监听器。

    • channel string
    • listener Function<Promise<void> | any>
      • event
      • ...args any[]

    为一个 invokeable的IPC 添加一个handler。 每当一个渲染进程调用 ipcRenderer.invoke(channel, ...args) 时这个处理器就会被调用。

    如果 listener 返回一个 Promise，那么 Promise 的最终结果就是远程调用的返回值。 否则， 监听器的返回值将被用来作为应答值。

    Renderer Process

    1. async () => {
    3.   // ...
    4. }

    传递给处理器的第一个参数的 event 与传递给常规事件侦听器的相同。 里面包含了哪些 WebContents 是调用请求的来源

    通过handle在主线程抛出的异常并不易读，那是因为他们已经被序列化了。只有原始错误中的 message 属性可提供给渲染进程。 详情请参阅 #24427

    ipcMain.handleOnce(channel, listener)

    • channel string
    • listener Function<Promise<void> | any>
      • event IpcMainInvokeEvent
      • ...args any[]

    处理单个 invokeable 可触发的 IPC 消息，然后移除侦听器。 详见 ipcMain.handle(channel, listener)

    移除 channel的所有处理程序，若存在。

    handle回调参数event对象文档可以在一节找到