Window: messageerror Ereignis

Baseline 2023

Newly available

Since March 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Das messageerror Ereignis wird auf einem Window-Objekt ausgelöst, wenn es eine Nachricht empfängt, die nicht deserialisiert werden kann.

Dieses Ereignis ist nicht abbrechbar und hat keine Bubbling-Eigenschaften.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignishandler-Eigenschaft.

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

onmessageerror = (event) => {};

Diese Schnittstelle erbt auch Eigenschaften von ihrer Elternklasse, Event.

MessageEvent.data Schreibgeschützt: Die vom Nachrichtensender gesendeten Daten.
MessageEvent.origin Schreibgeschützt: Ein String, der den Ursprung des Nachrichtensenders repräsentiert.
MessageEvent.lastEventId Schreibgeschützt: Ein String, der eine eindeutige ID für das Ereignis repräsentiert.
MessageEvent.source Schreibgeschützt: Ein MessageEventSource (welches ein WindowProxy, MessagePort oder ServiceWorker Objekt sein kann) repräsentiert den Nachrichtensender.
MessageEvent.ports Schreibgeschützt: Ein Array von MessagePort-Objekten, die die mit dem Kanal assoziierten Ports repräsentieren, durch den die Nachricht gesendet wird (falls zutreffend, z.B. bei Kanal-Messaging oder beim Versenden einer Nachricht an einen Shared Worker).

Hören Sie auf messageerror mit addEventListener():

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

Das Gleiche, aber mit der onmessageerror Ereignishandler-Eigenschaft:

window.onmessageerror = (event) => {
  console.error(event);
};

Specification
HTML # event-messageerror
HTML # handler-window-onmessageerror