Back to Content

ExtendableMessageEvent: ports property

files/en-us/web/api/extendablemessageevent/ports/index.md

latest1.4 KB
Original Source

{{APIRef("Service Workers API")}}{{AvailableInWorkers("service")}}

The ports read-only property of the {{domxref("ExtendableMessageEvent")}} interface returns the array containing the {{domxref("MessagePort")}} objects representing the ports of the associated message channel (the channel the message is being sent through.)

Value

An array of {{domxref("MessagePort")}} objects.

Examples

When the following code is used inside a service worker to respond to a push messages by sending the data received via {{domxref("PushMessageData")}} to the main context via a channel message, the event object of onmessage will be an ExtendableMessageEvent.

js
let port;

self.addEventListener("push", (e) => {
  const obj = e.data.json();

  if (obj.action === "subscribe" || obj.action === "unsubscribe") {
    port.postMessage(obj);
  } else if (obj.action === "init" || obj.action === "chatMsg") {
    port.postMessage(obj);
  }
});

self.onmessage = (e) => {
  port = e.ports[0];
};

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also