API канала широковещательной передачи

API канала широковещательной передачи позволяет осуществлять базовый обмен данными между контекстами просмотра (то есть, окнами, вкладками, кадрами или фреймами iframes) и потоками выполнения на том же исходе.

Создав объект BroadcastChannel, вы можете получать любые сообщения, отправленные в него. Вам не нужно хранить ссылки на фреймы или потоки выполнения, с которыми вы хотите обмениваться данными: они могут «подписаться» на конкретный канал, создав свой собственный объект BroadcastChannel с тем же именем, и осуществлять двусторонний обмен данными между всеми объектами.

Клиент присоединяется к каналу широковещательной передачи, создавая объект BroadcastChannel. Его конструктор принимает один параметр: имя канала. Если это первый подключившийся к каналу с таким именем, то подразумевающий канал создается.

// Connection to a broadcast channel
const bc = new BroadcastChannel("test_channel");

Достаточно вызвать метод postMessage() на созданном объекте BroadcastChannel, который принимает любой объект в качестве аргумента. Пример с текстовым сообщением:

// Example of sending of a very simple message
bc.postMessage("This is a test message.");

Данные, отправляемые в канал, сериализуются с помощью алгоритма структурированного клонирования. Это означает, что вы можете безопасно отправлять различные объекты данных без необходимости их самостоятельной сериализации.

API не накладывает никаких ограничений на семантику сообщений, поэтому код должен сам понимать, какие сообщения ожидать и как с ними обращаться.

При отправке сообщения событие message отправляется каждому объекту BroadcastChannel, подключенному к этому каналу. Функция может быть запущена для этого события с помощью обработчика событий onmessage:

// A handler that only logs the event to the console:
bc.onmessage = (event) => {
  console.log(event);
};

Чтобы выйти из канала, вызовите метод close() на объекте. Это отключает объект от базового канала, позволяя сборку мусора.

// Disconnect the channel
bc.close();

Самодостаточный интерфейс API канала широковещательной передачи позволяет обмениваться данными между контекстами. Его можно использовать для определения действий пользователя в других вкладках того же исхода, например, при входе или выходе пользователя.

Протокол обмена сообщениями не определен, и разные контексты просмотра должны реализовывать его сами; не существует никаких переговоров или требований со стороны спецификации.

BroadcastChannel

Представляет собой именованный канал, к которому любой контекст просмотра данного исхода может подключиться.

• BroadcastChannel, интерфейс, его реализующий.