feat: add webFrameMain.send() / webFrameMain.postMessage()

[miniak]

Description of Change

Add webFrameMain.send() / webFrameMain.postMessage().

Checklist

• PR description included and stakeholders cc'd
• npm test passes
• tests are changed or added
• relevant documentation is changed or added
• PR release notes describe the change in a way relevant to app developers, and are capitalized, punctuated, and past tense.

Release Notes

Notes: Added webFrameMain.send() / webFrameMain.postMessage().

[samuelmaddock]

👍

[samuelmaddock]

❤️ this

[jeremypointer7]

Is that what I need to do? Sent from my Metro By T-Mobile 4G LTE Android Device

-------- Original message -------- From: Samuel Maddock <notifications@github.com> Date: 1/8/21 12:20 PM (GMT-06:00) To: electron/electron <electron@noreply.github.com> Cc: Subscribed <subscribed@noreply.github.com> Subject: Re: [electron/electron] feat: add webFrameMain.send() / webFrameMain.postMessage() (#26807) @samuelmaddock approved this pull request. 👍

________________________________ In docs/api/web-frame-main.md<#26807 (comment)>:

+process by accessing the `ports` property of the emitted event. When they

+arrive in the renderer, they will be native DOM `MessagePort` objects. + +For example: + +```js +// Main process +const { port1, port2 } = new MessageChannelMain() +webContents.mainFrame.postMessage('port', { message: 'hello' }, [port1]) + +// Renderer process +ipcRenderer.on('port', (e, msg) => { + const [port] = e.ports + // ... +}) +``` ❤️ this — You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub<#26807 (review)>, or unsubscribe<https://github.com/notifications/unsubscribe-auth/ASMU2B3H2RA6F4NM73DMAKLSY5EIDANCNFSM4ULJ6UXQ>.

[samuelmaddock]

API LGTM

[release-clerk]

Release Notes Persisted

Added webFrameMain.send() / webFrameMain.postMessage().

[trop]

I was unable to backport this PR to "12-x-y" cleanly;
you will need to perform this backport manually.

[trop]

@miniak has manually backported this PR to "12-x-y", please check out #27354

[trop]

@miniak has manually backported this PR to "12-x-y", please check out #27366