BroadcastChannel: событие messageerror
Базовая линия Широко доступна
Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна во всех браузерах с марта 2022 года.
Примечание: Эта функция доступна в Веб-воркерах.
Событие messageerror интерфейса BroadcastChannel срабатывает, когда на канале поступает сообщение, которое нельзя десериализовать.
Синтаксис
Используйте имя события в методах, таких как addEventListener(), или задайте свойство обработчика событий.
addEventListener("messageerror", (event) => { })
onmessageerror = (event) => { }
Тип события
Тип MessageEvent. Наследуется от Event.
Свойства события
Помимо перечисленных ниже свойств, доступны свойства из родительского интерфейса Event.
-
dataТолько для чтения -
Данные, отправленные отправителем сообщения.
-
originТолько для чтения -
Строка, представляющая происхождение отправителя сообщения.
-
lastEventIdТолько для чтения -
Строка, представляющая уникальный идентификатор события.
-
sourceТолько для чтения -
Источник события, который может быть объектом WindowProxy,
MessagePortилиServiceWorker, представляющим отправителя сообщения. -
portsТолько для чтения -
Массив объектов
MessagePort, представляющих порты, связанные с каналом, через который отправляется сообщение (по возможности, например, при обмене сообщениями или при отправке сообщения в общий рабочий процесс).
Примеры
Этот код использует addEventListener() для прослушивания сообщений и ошибок:
const channel = new BroadcastChannel("example-channel");
channel.addEventListener("message", (event) => {
received.textContent = event.data;
});
channel.addEventListener("messageerror", (event) => {
console.error(event);
});
То же самое, но с использованием свойств обработчика событий onmessage и onmessageerror:
const channel = new BroadcastChannel("example-channel");
channel.onmessage = (event) => {
received.textContent = event.data;
};
channel.onmessageerror = (event) => {
console.log(event);
};
Спецификации
Совместимость с браузерами
| Рабочие столы | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari на IOS | Samsung Internet | WebView Android | |
messageerror_event |
60 | 79 | 57 | 47 | 15.4 | 60 | 57 | 47 | 15.4 | 8.0 | 60 |
См. также
- Связанные события:
message.
© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/BroadcastChannel/messageerror_event