broadcastchannel

Same-origin messaging between tabs, windows, and workers via the BroadcastChannel API.

Import: @rtorcato/browser-common/broadcastchannel

📖 MDN: Broadcast Channel API · 📊 caniuse: broadcastchannel

createBroadcastChannel returns a live channel object, so it throws a requires a browser environment error where BroadcastChannel is unsupported — guard with isBroadcastChannelAvailable() first.

Browser support

API	Chrome	Edge	Firefox	Safari	iOS Safari	Baseline
BroadcastChannel	✅ 54+	✅ 79+	✅ 38+	✅ 15.4+	✅ 15.4+	Widely available

✅ supported · ◐ partial · ❌ not supported · [n] see note. Generated from MDN browser-compat-data and web-features. caniuse: BroadcastChannel

Example

import {
  isBroadcastChannelAvailable,
  createBroadcastChannel,
} from '@rtorcato/browser-common/broadcastchannel'

if (isBroadcastChannelAvailable()) {
  const channel = createBroadcastChannel<{ type: string }>('sync')

  const off = channel.onMessage((data) => {
    if (data.type === 'updated') refresh()
  })

  channel.send({ type: 'updated' })

  // later:
  off()
  channel.close()
}

Exports

• isBroadcastChannelAvailable() — feature check
• createBroadcastChannel(name) — returns { onMessage, send, close, channel }

See the API reference for full signatures.