BroadcastChannel: messageerror-Ereignis
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2022.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Das messageerror
-Ereignis der BroadcastChannel
-Schnittstelle wird ausgelöst, wenn eine Nachricht, die nicht deserialisiert werden kann, auf dem Kanal ankommt.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener()
, oder setzen Sie eine Ereignis-Handler-Eigenschaft.
addEventListener("messageerror", (event) => { })
onmessageerror = (event) => { }
Ereignistyp
Ein MessageEvent
. Erbt von Event
.
Ereigniseigenschaften
Neben den unten aufgeführten Eigenschaften sind Eigenschaften aus der Elternschnittstelle, Event
, verfügbar.
data
Schreibgeschützt-
Die Daten, die vom Nachrichtensender gesendet wurden.
origin
Schreibgeschützt-
Ein String, der die Herkunft des Nachrichtensenders darstellt.
lastEventId
Schreibgeschützt-
Ein String, der eine eindeutige ID für das Ereignis darstellt.
source
Schreibgeschützt-
Eine Nachrichtenereignisquelle, die entweder ein WindowProxy, ein
MessagePort
oder einServiceWorker
-Objekt ist, das den Nachrichtensender repräsentiert. ports
Schreibgeschützt-
Ein Array von
MessagePort
-Objekten, die die Ports repräsentieren, die mit dem Kanal verbunden sind, durch den die Nachricht gesendet wird (wenn zutreffend, z. B. bei Kanalnachrichtenübermittlung oder beim Senden einer Nachricht an einen Shared Worker).
Beispiele
Dieser Code verwendet addEventListener()
, um Nachrichten und Fehler zu beobachten:
const channel = new BroadcastChannel("example-channel");
channel.addEventListener("message", (event) => {
received.textContent = event.data;
});
channel.addEventListener("messageerror", (event) => {
console.error(event);
});
Dasselbe, aber mit den onmessage
- und onmessageerror
-Ereignis-Handler-Eigenschaften:
const channel = new BroadcastChannel("example-channel");
channel.onmessage = (event) => {
received.textContent = event.data;
};
channel.onmessageerror = (event) => {
console.log(event);
};
Spezifikationen
Specification |
---|
HTML # event-messageerror |
HTML # handler-broadcastchannel-onmessageerror |
Browser-Kompatibilität
Siehe auch
- Verwandte Ereignisse:
message
.