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 bei einem Window-Objekt ausgelöst, wenn es eine Nachricht erhält, die nicht deserialisiert werden kann.

Dieses Ereignis kann nicht abgebrochen werden und wird nicht weitergeleitet.

Syntax

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

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

onmessageerror = (event) => {};

Ereignistyp

Ereigniseigenschaften

Diese Schnittstelle erbt auch Eigenschaften von ihrem Elternteil, Event.

MessageEvent.data Schreibgeschützt

Die vom Nachrichten-Emitter gesendeten Daten.

MessageEvent.origin Schreibgeschützt

Ein String, der den Ursprung des Nachrichten-Emitters darstellt.

MessageEvent.lastEventId Schreibgeschützt

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

MessageEvent.source Schreibgeschützt

Eine MessageEventSource (die ein WindowProxy, MessagePort oder ServiceWorker-Objekt sein kann), die den Nachrichten-Emitter darstellt.

MessageEvent.ports Schreibgeschützt

Ein Array von MessagePort-Objekten, die die mit dem Kanal assoziierten Ports darstellen, über den die Nachricht gesendet wird (soweit zutreffend, z.B. bei Nachrichtenübermittlung in Kanälen oder beim Senden einer Nachricht an einen Shared Worker).

Beispiele

Ein Listener für messageerror mit addEventListener():

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

Das Gleiche, jedoch mit der onmessageerror-Ereignis-Handler-Eigenschaft:

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

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch