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 auf dem Kanal eintrifft, die nicht deserialisiert werden kann.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener()
oder setzen Sie eine Ereignishandler-Eigenschaft.
addEventListener("messageerror", (event) => { })
onmessageerror = (event) => { }
Ereignistyp
Ein MessageEvent
. Erbt von Event
.
Ereigniseigenschaften
Zusätzlich zu den unten aufgeführten Eigenschaften sind Eigenschaften von der übergeordneten Schnittstelle Event
verfügbar.
data
Schreibgeschützt-
Die vom Nachrichtenemitter gesendeten Daten.
origin
Schreibgeschützt-
Ein String, der den Ursprung des Nachrichtenemitters 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 darstellt, das den Nachrichtenemitter repräsentiert. ports
Schreibgeschützt-
Ein Array von
MessagePort
-Objekten, die die Ports darstellen, die mit dem Kanal verbunden sind, durch den die Nachricht gesendet wird (wo zutreffend, z.B. beim Channel-Messaging oder beim Senden einer Nachricht an einen Shared Worker).
Beispiele
Dieser Code verwendet addEventListener()
, um auf Nachrichten und Fehler zu hören:
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
Ereignishandler-Eigenschaften:
const channel = new BroadcastChannel("example-channel");
channel.onmessage = (event) => {
received.textContent = event.data;
};
channel.onmessageerror = (event) => {
console.log(event);
};
Spezifikationen
Specification |
---|
HTML Standard # event-messageerror |
HTML Standard # handler-broadcastchannel-onmessageerror |
Browser-Kompatibilität
BCD tables only load in the browser
Siehe auch
- Verwandte Ereignisse:
message
.