Worker: messageerror-Ereignis
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Hinweis: Diese Funktion ist in Web Workers verfügbar, mit Ausnahme von Service Workers.
Das messageerror
-Ereignis wird auf einem Worker
-Objekt ausgelöst, wenn es eine Nachricht empfängt, die nicht deserialisiert werden kann.
Dieses Ereignis kann nicht abgebrochen werden und wird nicht weitergegeben.
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 Element, Event
.
MessageEvent.data
Schreibgeschützt-
Die von dem Nachrichtenemitter gesendeten Daten.
MessageEvent.origin
Schreibgeschützt-
Ein String, der den Ursprung des Nachrichtenemitters repräsentiert.
MessageEvent.lastEventId
Schreibgeschützt-
Ein String, der eine einzigartige ID für das Ereignis darstellt.
MessageEvent.source
Schreibgeschützt-
Ein
MessageEventSource
(kann ein WindowProxy,MessagePort
oderServiceWorker
-Objekt sein), das den Nachrichtenemitter repräsentiert. MessageEvent.ports
Schreibgeschützt-
Ein Array von
MessagePort
-Objekten, die die Ports repräsentieren, die mit dem Kanal verbunden sind, über den die Nachricht gesendet wird (wo zutreffend, z.B. bei der Kanalnachrichtübermittlung oder beim Senden einer Nachricht an einen gemeinsam genutzten Worker).
Beispiele
Erstellen Sie einen Worker und lauschen Sie auf message
- und messageerror
-Ereignisse mit addEventListener()
:
// main.js
const worker = new Worker("static/scripts/worker.js");
worker.addEventListener("message", (event) => {
console.error(`Received message from worker: ${event}`);
});
worker.addEventListener("messageerror", (event) => {
console.error(`Error receiving message from worker: ${event}`);
});
Das gleiche, aber unter Verwendung der onmessageerror
-Ereignis-Handler-Eigenschaft:
// main.js
const worker = new Worker("static/scripts/worker.js");
worker.onmessage = (event) => {
console.error(`Received message from worker: ${event}`);
};
worker.onmessageerror = (event) => {
console.error(`Error receiving message from worker: ${event}`);
};
Spezifikationen
Specification |
---|
HTML # event-messageerror |
Browser-Kompatibilität
Siehe auch
Worker.postMessage()
- Verwandte Ereignisse:
message