DedicatedWorkerGlobalScope: 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.

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 oder ServiceWorker 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