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.

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

Ereignistyp

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

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 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 Standard
# event-messageerror
HTML Standard
# handler-broadcastchannel-onmessageerror

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch