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.
addEventListener("messageerror", (event) => {});
onmessageerror = (event) => {};
Ereignistyp
Ein MessageEvent
. Erbt von Event
.
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
oderServiceWorker
-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()
:
window.addEventListener("messageerror", (event) => {
console.error(event);
});
Das Gleiche, jedoch mit der onmessageerror
-Ereignis-Handler-Eigenschaft:
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
Window.postMessage()
- Verwandte Ereignisse:
message
.