Windows and messaging

Oro Runtime apps can create multiple windows. Windows are identified by a numeric index.

Create a second window#

Create a new window using oro:application:

import application from 'oro:application'

await application.createWindow({
  index: 1,
  path: 'details.html',
  title: 'Details window',
})

The path must resolve inside your bundled resources, so make sure it’s included in your copy_map.

Find existing windows#

import application from 'oro:application'

const detailsWindow = await application.getWindow(1)
const all = await application.getWindows()

Send a message to another window#

ApplicationWindow.postMessage(...) is the simplest way to send a message to a specific window:

import application from 'oro:application'

const detailsWindow = await application.getWindow(1)
await detailsWindow.postMessage({ type: 'ping', at: Date.now() })

Receive messages in any window:

globalThis.addEventListener('message', (event) => {
  const payload = event.detail ?? event.data
  console.log('message:', payload)
})

Send structured events (advanced)#

ApplicationWindow.send(...) lets you set an explicit event name:

import application from 'oro:application'

const current = await application.getCurrentWindow()
await current.send({ window: 1, event: 'message', value: { hello: 'world' } })

Next#

• JavaScript APIs: oro:application · oro:window