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 July 2015.
Hinweis: Dieses Feature ist verfügbar in Web Workers.
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
. options
Optional-
Ein Objekt, das zusätzlich zu den in
Event()
definierten Eigenschaften die folgenden Eigenschaften haben kann:data
Optional-
Die Daten, die im
MessageEvent
enthalten sein sollen. Dies kann ein beliebiger Datentyp sein und wird standardmäßig aufnull
gesetzt, wenn nicht angegeben. origin
Optional-
Ein String, der den Ursprung des Nachrichtensenders darstellt. Standardmäßig wird ein leerer String (
''
) verwendet, wenn nichts angegeben ist. lastEventId
Optional-
Ein String, der eine eindeutige ID für das Event darstellt. Standardmäßig wird ein leerer String ("") verwendet, wenn nichts angegeben ist.
source
Optional-
Eine
MessageEventSource
(die einWindow
, einMessagePort
oder einServiceWorker
Objekt sein kann), die den Nachrichtensender darstellt. Diese wird standardmäßig aufnull
gesetzt, wenn sie nicht festgelegt ist. ports
Optional-
Ein Array von
MessagePort
Objekten, das alleMessagePort
Objekte 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 Standard # the-messageevent-interface:dom-event-constructor |
Browser-Kompatibilität
BCD tables only load in the browser
Siehe auch
ExtendableMessageEvent
— ähnlich dieser Schnittstelle, aber in Schnittstellen verwendet, die Autoren mehr Flexibilität bieten müssen.