DedicatedWorkerGlobalScope: 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 März 2023.
Hinweis: Diese Funktion ist nur in Dedicated Web Workers verfügbar.
Das messageerror
Ereignis wird auf einem DedicatedWorkerGlobalScope
Objekt ausgelöst, wenn es eine Nachricht empfängt, die nicht deserialisiert werden kann.
Dieses Ereignis ist nicht abbrechbar und wird nicht weitergeleitet.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener()
oder legen Sie eine Ereignis-Handler-Eigenschaft fest.
addEventListener("messageerror", (event) => { })
onmessageerror = (event) => { }
Ereignistyp
Ein MessageEvent
. Erbt von Event
.
Ereigniseigenschaften
Diese Schnittstelle erbt auch Eigenschaften von ihrem übergeordneten Event
.
MessageEvent.data
Schreibgeschützt-
Die vom Nachrichtensender gesendeten Daten.
MessageEvent.origin
Schreibgeschützt-
Ein String, der den Ursprung des Nachrichtensenders darstellt.
MessageEvent.lastEventId
Schreibgeschützt-
Ein String, der eine eindeutige ID für das Ereignis darstellt.
MessageEvent.source
Schreibgeschützt-
Ein
MessageEventSource
(welches ein WindowProxy,MessagePort
oderServiceWorker
Objekt sein kann), das den Nachrichtensender darstellt. MessageEvent.ports
Schreibgeschützt-
Ein Array von
MessagePort
Objekten, das die mit dem Kanal, durch den die Nachricht gesendet wird, verbundenen Ports repräsentiert (wo zutreffend, z.B. bei der Kanal-Messaging oder beim Senden einer Nachricht zu einem Shared Worker).
Beispiele
Auf messageerror
mit addEventListener()
hören:
// worker.js
self.addEventListener("messageerror", (event) => {
self.postMessage("Error receiving message");
console.error(event);
});
Dasselbe, aber mit der onmessageerror
Ereignis-Handler-Eigenschaft:
// worker.js
self.onmessageerror = (event) => {
self.postMessage("Error receiving message");
console.error(event);
};
Spezifikationen
Specification |
---|
HTML> # event-messageerror> |
HTML> # handler-messageeventtarget-onmessageerror> |
Browser-Kompatibilität
Loading…
Siehe auch
DedicatedWorkerGlobalScope
WorkerGlobalScope
- Verwandte Ereignisse:
message
Worker.postMessage()
- Verwendung von Kanal-Messaging