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.

js
addEventListener("messageerror", (event) => { })

onmessageerror = (event) => { }

Ereignistyp

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 ein ServiceWorker-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:

js
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:

js
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