ipcRenderer 模塊是一個(gè) EventEmitter 類的實(shí)例. 它提供了有限的方法，你可以從渲染進(jìn)程向主進(jìn)程發(fā)送同步或異步消息. 也可以收到主進(jìn)程的響應(yīng).

查看 ipcMain 代碼例子.

消息監(jiān)聽

ipcRenderer 模塊有下列方法來監(jiān)聽事件:

ipcRenderer.on(channel, listener)

• channel String
• listener Function

監(jiān)聽 channel, 當(dāng)有新消息到達(dá)，使用 listener(event, args...) 調(diào)用 listener .

ipcRenderer.once(channel, listener)

• channel String
• listener Function

為這個(gè)事件添加一個(gè)一次性 listener 函數(shù).這個(gè) listener 將在下一次有新消息被發(fā)送到 channel 的時(shí)候被請(qǐng)求調(diào)用，之后就被刪除了.

ipcRenderer.removeListener(channel, listener)

• channel String
• listener Function

從指定的 channel 中的監(jiān)聽者數(shù)組刪除指定的 listener .

ipcRenderer.removeAllListeners([channel])

• channel String (optional)

刪除所有的監(jiān)聽者，或者刪除指定 channel 中的全部.

發(fā)送消息

ipcRenderer 模塊有如下方法來發(fā)送消息:

ipcRenderer.send(channel[, arg1][, arg2][, ...])

• channel String
• arg (可選)

通過 channel 向主進(jìn)程發(fā)送異步消息，也可以發(fā)送任意參數(shù).參數(shù)會(huì)被JSON序列化，之后就不會(huì)包含函數(shù)或原型鏈.

主進(jìn)程通過使用 ipcMain 模塊來監(jiān)聽 channel，從而處理消息.

ipcRenderer.sendSync(channel[, arg1][, arg2][, ...])

• channel String
• arg (可選)

通過 channel 向主進(jìn)程發(fā)送同步消息，也可以發(fā)送任意參數(shù).參數(shù)會(huì)被JSON序列化，之后就不會(huì)包含函數(shù)或原型鏈.

主進(jìn)程通過使用 ipcMain 模塊來監(jiān)聽 channel，從而處理消息, 通過 event.returnValue 來響應(yīng).

注意: 發(fā)送同步消息將會(huì)阻塞整個(gè)渲染進(jìn)程,除非你知道你在做什么，否則就永遠(yuǎn)不要用它 .

ipcRenderer.sendToHost(channel[, arg1][, arg2][, ...])

• channel String
• arg (可選)

類似 ipcRenderer.send ，但是它的事件將發(fā)往 host page 的 <webview> 元素，而不是主進(jìn)程.