一个 MessageEvent
是接口代表一个目标收到的一个消息, 作为一个 WebSocket
或者一个 WebRTC RTCDataChannel
。
这个行为由设定在 事件手柄为 WebSocket.onmessage
或 RTCDataChannel.onmessage
的事件触发。
Note: This feature is available in Web Workers.
构造函数
MessageEvent()
- 创建一个新的 消息事件 。
属性
继承父类 Event
的属性。
MessageEvent.data
只读- 返回
DOMString
,Blob
或者ArrayBuffer
,包含来自发送者的数据。 MessageEvent.origin
- 是一个
DOMString
… MessageEvent.ports
- …
MessageEvent.source
- …
方法
继承父类 Event
的方法。
MessageEvent.initMessageEvent()
- … 不要再使用: 使用
MessageEvent()
。
浏览器兼容性
特性 | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Basic support | 1 | (Yes) | 4.0 (2.0)[1] | 9 | ? | 10.0+ |
特性 | Android | Edge | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | ? | (Yes) | ? | ? | ? | 3.0+ |
[1] 对于 Gecko 11.0 (Firefox 11.0 / Thunderbird 11.0 / SeaMonkey 2.8), Gecko 支持 ArrayBuffer
类型的数据,但不支持 Blob
类型的数据。
详见
ExtendableMessageEvent
,与此接口类似,但适合用于更灵活的场景。- WebSocket API
- WebRTC API