mirror of
https://github.com/electron/electron.git
synced 2026-04-10 03:01:51 -04:00
63e59a196a
* docs: fix broken links Co-authored-by: David Sanders <dsanders11@ucsbalum.com> * docs: change link to navigator.getUserMedia Co-authored-by: Jeremy Rose <nornagon@nornagon.net> Co-authored-by: David Sanders <dsanders11@ucsbalum.com> * docs: fix link in examples.md Co-authored-by: David Sanders <dsanders11@ucsbalum.com> Co-authored-by: trop[bot] <37223003+trop[bot]@users.noreply.github.com> Co-authored-by: David Sanders <dsanders11@ucsbalum.com>
60 lines
1.8 KiB
Markdown
60 lines
1.8 KiB
Markdown
# MessagePortMain
|
|
|
|
`MessagePortMain` is the main-process-side equivalent of the DOM
|
|
[`MessagePort`][] object. It behaves similarly to the DOM version, with the
|
|
exception that it uses the Node.js `EventEmitter` event system, instead of the
|
|
DOM `EventTarget` system. This means you should use `port.on('message', ...)`
|
|
to listen for events, instead of `port.onmessage = ...` or
|
|
`port.addEventListener('message', ...)`
|
|
|
|
See the [Channel Messaging API][] documentation for more information on using
|
|
channel messaging.
|
|
|
|
`MessagePortMain` is an [EventEmitter][event-emitter].
|
|
|
|
## Class: MessagePortMain
|
|
|
|
> Port interface for channel messaging in the main process.
|
|
|
|
Process: [Main](../glossary.md#main-process)<br />
|
|
_This class is not exported from the `'electron'` module. It is only available as a return value of other methods in the Electron API._
|
|
|
|
### Instance Methods
|
|
|
|
#### `port.postMessage(message, [transfer])`
|
|
|
|
* `message` any
|
|
* `transfer` MessagePortMain[] (optional)
|
|
|
|
Sends a message from the port, and optionally, transfers ownership of objects
|
|
to other browsing contexts.
|
|
|
|
#### `port.start()`
|
|
|
|
Starts the sending of messages queued on the port. Messages will be queued
|
|
until this method is called.
|
|
|
|
#### `port.close()`
|
|
|
|
Disconnects the port, so it is no longer active.
|
|
|
|
### Instance Events
|
|
|
|
#### Event: 'message'
|
|
|
|
Returns:
|
|
|
|
* `messageEvent` Object
|
|
* `data` any
|
|
* `ports` MessagePortMain[]
|
|
|
|
Emitted when a MessagePortMain object receives a message.
|
|
|
|
#### Event: 'close'
|
|
|
|
Emitted when the remote end of a MessagePortMain object becomes disconnected.
|
|
|
|
[`MessagePort`]: https://developer.mozilla.org/en-US/docs/Web/API/MessagePort
|
|
[Channel Messaging API]: https://developer.mozilla.org/en-US/docs/Web/API/Channel_Messaging_API
|
|
[event-emitter]: https://nodejs.org/api/events.html#events_class_eventemitter
|