electronjs.org-new/docs/latest/api/parent-port.md

1.2 KiB

title description slug hide_title
parentPort Interface for communication with parent process. parent-port false

parentPort

Interface for communication with parent process.

Process: Utility

parentPort is an EventEmitter. This object is not exported from the 'electron' module. It is only available as a property of the process object in the Electron API.

// Main process
const child = utilityProcess.fork(path.join(__dirname, 'test.js'))
child.postMessage({ message: 'hello' })
child.on('message', (data) => {
  console.log(data) // hello world!
})

// Child process
process.parentPort.on('message', (e) => {
  process.parentPort.postMessage(`${e.data} world!`)
})

Events

The parentPort object emits the following events:

Event: 'message'

Returns:

  • messageEvent Object
    • data any
    • ports MessagePortMain[]

Emitted when the process receives a message. Messages received on this port will be queued up until a handler is registered for this event.

Methods

parentPort.postMessage(message)

  • message any

Sends a message from the process to its parent.