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 Ereignishandler-Eigenschaft.

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

Ereignistyp

Ereigniseigenschaften

Neben den unten aufgeführten Eigenschaften sind Eigenschaften der Elternschnittstelle, Event, verfügbar.

data Schreibgeschützt

Die vom Nachrichtensender gesendeten Daten.

origin Schreibgeschützt

Ein String, der den Ursprung des Nachrichtensenders repräsentiert.

lastEventId Schreibgeschützt

Ein String, der eine eindeutige ID für das Ereignis darstellt.

source Schreibgeschützt

Eine Nachrichtenereignisquelle, welche 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 mit dem Kanal verbundenen Ports repräsentieren, durch die die Nachricht gesendet wird (wo zutreffend, z.B. bei Kanalnachrichten oder beim Senden einer Nachricht an einen Shared Worker).

Beispiele

Dieser Code verwendet addEventListener(), um auf Nachrichten und Fehler zu hören:

js
const channel = new BroadcastChannel("example-channel");

channel.addEventListener("message", (event) => {
  received.textContent = event.data;
});

channel.addEventListener("messageerror", (event) => {
  console.error(event);
});

Dasselbe, aber unter Verwendung der onmessage und onmessageerror Ereignishandler-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