MessageEvent: MessageEvent() Konstruktor
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since August 2016.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Der MessageEvent() Konstruktor erstellt ein neues MessageEvent Objekt.
Syntax
new MessageEvent(type)
new MessageEvent(type, options)
Parameter
type-
Ein String mit dem Namen des Events. Er ist case-sensitive und Browser setzen ihn immer auf
message. optionsOptional-
Ein Objekt, das zusätzlich zu den in
Event()definierten Eigenschaften die folgenden Eigenschaften haben kann:dataOptional-
Die Daten, die im
MessageEvententhalten sein sollen. Dies kann ein beliebiger Datentyp sein und wird standardmäßig aufnullgesetzt, wenn nicht angegeben. originOptional-
Ein String, der den Ursprung des Nachrichtensenders darstellt. Standardmäßig wird ein leerer String (
'') verwendet, wenn nichts angegeben ist. lastEventIdOptional-
Ein String, der eine eindeutige ID für das Event darstellt. Standardmäßig wird ein leerer String ("") verwendet, wenn nichts angegeben ist.
sourceOptional-
Eine
MessageEventSource(die einWindow, einMessagePortoder einServiceWorkerObjekt sein kann), die den Nachrichtensender darstellt. Diese wird standardmäßig aufnullgesetzt, wenn sie nicht festgelegt ist. portsOptional-
Ein Array von
MessagePortObjekten, das alleMessagePortObjekte enthält, die mit der Nachricht in der Reihenfolge gesendet wurden. Dies wird standardmäßig auf ein leeres Array ([]) gesetzt, wenn nichts angegeben ist.
Rückgabewert
Ein neues MessageEvent Objekt.
Beispiele
const myMessage = new MessageEvent("message", {
data: "hello",
});
Spezifikationen
| Specification |
|---|
| HTML> # the-messageevent-interface:dom-event-constructor> |
Browser-Kompatibilität
Siehe auch
ExtendableMessageEvent— ähnlich dieser Schnittstelle, aber in Schnittstellen verwendet, die Autoren mehr Flexibilität bieten müssen.