ExtendableMessageEvent: ExtendableMessageEvent()-Konstruktor

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2018.

Hinweis: Dieses Feature ist nur verfügbar in Service Workers.

Der ExtendableMessageEvent()-Konstruktor erstellt ein neues ExtendableMessageEvent-Objekt.

Syntax

js
new ExtendableMessageEvent(type)
new ExtendableMessageEvent(type, options)

Parameter

type

Ein String mit dem Namen des Ereignisses. Er ist case-sensitiv und Browser setzen ihn auf messageerror oder message.

options Optional

Ein Objekt, das zusätzlich zu den in ExtendableEvent() definierten Eigenschaften die folgenden Eigenschaften enthalten kann:

data Optional

Die Daten des Ereignisses; dies kann jeder Datentyp sein. Standardmäßig null.

origin Optional

Ein String, der den Ursprung des entsprechenden Service Workers-Umgebungsobjekts definiert. Standardmäßig "".

lastEventId Optional

Ein String, der die letzte Ereignis-ID der Ereignisquelle definiert. Standardmäßig "".

source Optional

Der Client, ServiceWorker oder MessagePort, der die Nachricht gesendet hat. Standardmäßig null.

ports Optional

Ein Array, das die MessagePort-Objekte enthält, die mit dem Kanal verbunden sind, der die Nachricht sendet. Standardmäßig ein leeres Array.

Rückgabewert

Ein neues ExtendableMessageEvent-Objekt.

Beispiele

js
const options = {
  data: "hello message",
  source: MessagePortReference,
  ports: MessagePortListReference,
};

const myEME = new ExtendableMessageEvent("message", init);

Spezifikationen

Specification
Service Workers
# dom-extendablemessageevent-extendablemessageevent

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch