MessageEvent: MessageEvent() 构造函数

Baseline 已广泛支持

此功能已相当成熟,可在多种设备和浏览器版本上运行。自 ⁨2016 年 8 月⁩ 起,所有浏览器均已提供此功能。

注意:此功能在 Web Workers 中可用。

MessageEvent() 构造函数用于创建一个新的 MessageEvent 对象。

语法

js
new MessageEvent(type)
new MessageEvent(type, options)

参数

type

一个包含事件名称的字符串。它区分大小写,浏览器始终将其设置为 message

options 可选

一个对象,除了 Event() 中定义的属性外,还可以包含以下属性:

data 可选

您希望包含在 MessageEvent 中的数据。它可以是任何数据类型,如果未指定,则默认为 null

origin 可选

一个表示消息发送者来源的字符串。如果未指定,则默认为空字符串 ('')。

lastEventId 可选

一个表示事件唯一 ID 的字符串。如果未指定,则默认为空字符串 ("")。

source 可选

一个 MessageEventSource(可以是 WindowMessagePortServiceWorker 对象),表示消息发送者。如果未设置,则默认为 null

ports 可选

一个 MessagePort 对象数组,按顺序包含随消息发送的所有 MessagePort 对象。如果未指定,则默认为空数组 ([])。

返回值

一个新的 MessageEvent 对象。

示例

js
const myMessage = new MessageEvent("message", {
  data: "hello",
});

规范

规范
HTML
# the-messageevent-interface:dom-event-constructor

浏览器兼容性

另见