[13] [DFN[[CODE(DOMi)@en[MessageEvent]]]] は、[[サーバー]]や他の[[起源]]からメッセージを受信した時の[[イベント]]で使われる[[イベントインターフェイス]]です。 * 仕様書 [REFS[ - [12] [CITE@en-US-x-hixie[HTML Standard]] ([TIME[2016-12-13 09:04:33 +09:00]]) ]REFS] * インターフェイス [27] [[文書環境]]、[[ワーカー環境]]、 [CODE[AudioWorklet]] に[[晒され]]ています [SRC[>>12]]。 * コンストラクター [15] [[イベントコンストラクター]]を持ちます [SRC[>>12]]。 * メンバー [14] [CODE(DOMi)@en[MessageEvent]] [[インターフェイス]]は、 [CODE(DOMi)@en[Event]] [[インターフェイス]]の[[メンバー][インターフェイスメンバー]]に加えて、 次の[[メンバー][インターフェイスメンバー]]を持ちます。 [CODE(DOMi)@en[MessageEventInit]] [[辞書]]も [CODE(DOMi)@en[MessageEventInit]] [[辞書]]の[[メンバー][辞書メンバー]]に加えて、 次の[[メンバー][辞書メンバー]]を持ちます。 [FIG(short list)[ - [CODE(DOMa)@en[data][MessageEvent]] - [CODE(DOMa)@en[origin][MessageEvent]] - [CODE(DOMa)@en[lastEventId]] - [CODE(DOMa)@en[source][MessageEvent]] - [CODE(DOMa)@en[ports]] ]FIG] [16] [CODE(DOMi)@en[MessageEvent]] [[インターフェイス]]は、更に次の[[メンバー][インターフェイスメンバー]]を持ちます。 [FIG(short list)[ - [CODE(DOMm)@en[initMessageEvent]] ]FIG] [11] [CODE(DOMi)@en[MessageEvent]] [[インターフェイス]]は、色々な[[イベント]]に使われます。 [[IDL属性]]は、各用途で次のような値に設定されます。 [FIG(table)[ :x: 場面 :target: [F[イベント対象]] :t: [F[イベント型]] :d: [F[[CODE(DOMa)@en[data][MessageEvent]]]] :o: [F[[CODE(DOMa)@en[origin][MessageEvent]]]] :l: [F[[CODE(DOMa)@en[lastEventId]]]] :s: [F[[CODE(DOMa)@en[source][MessageEvent]]]] :p: [F[[CODE(DOMa)@en[ports]]]] :target: [CODE(DOMi)@en[EventSource]] :x: [[SSE]] のデータ受信 :t: [CODE(DOMe)@en[message][onmessage]] :d: 受信したデータ :o: 接続先サーバーの[[起源]] :l: ○ :target: [CODE(DOMi)@en[WebSocket]] :x: [[WebSocketメッセージ受信]] :t: [CODE(DOMe)@en[message][onmessage]] :d: 受信したデータ :o: 接続先サーバーの[[起源]] :target: [CODE(DOMi)@en[Window]] :x: [CODE(DOMi)@en[Window]] の [CODE(DOMm)@en[postMessage]] 受信 :t: [CODE(DOMe)@en[message][onmessage]] :d: 受信したデータ :o: 送信元の[[起源]] :p: ○ :s: ○ :target: [CODE(DOMi)@en[Window]] :x: [CODE(DOMi)@en[Window]] の [CODE(DOMm)@en[postMessage]] 受信 (エラー) :t: [CODE(DOMe)@en[messageerror]] :o: 送信元の[[起源]] :s: ○ :d: [[空文字列]] :target: [CODE(DOMi)@en[MessagePort]] :x: [CODE(DOMi)@en[MessagePort]] の [CODE(DOMm)@en[postMessage]] 受信 :t: [CODE(DOMe)@en[message][onmessage]] :d: 受信したデータ :p: ○ :target: [CODE(DOMi)@en[MessagePort]] :x: [CODE(DOMi)@en[MessagePort]] の [CODE(DOMm)@en[postMessage]] 受信 (エラー) :t: [CODE(DOMe)@en[messageerror]] :d: [[空文字列]] :target: [CODE(DOMi)@en[BroadcastChannel]] :x: [CODE(DOMi)@en[BroadcastChannel]] の [CODE(DOMm)@en[postMessage]] 受信 :t: [CODE(DOMe)@en[message][onmessage]] :d: 受信したデータ :o: 送信元の[[起源]] :target: [CODE(DOMi)@en[BroadcastChannel]] :x: [CODE(DOMi)@en[BroadcastChannel]] の [CODE(DOMm)@en[postMessage]] 受信 (エラー) :t: [CODE(DOMe)@en[messageerror]] :d: [[空文字列]] :o: 送信元の[[起源]] :target: [CODE(DOMi)@en[SharedWorkerGlobalScope]] :x: [[共有ワーカー]]への [CODE(DOMi)@en[SharedWorker]] 接続を検知 :t: [CODE(DOMe)@en[connect][onconnect]] :d: [[空文字列]] :p: ○ :s: ○ ]FIG] * [CODE(DOMi)@en[MessageEvent]] インターフェイス [CODE(DOMa)@en[data][MessageEvent]] 属性 [19] [CODE(DOMi)@en[MessageEvent]] [[インターフェイス]]と [CODE(DOMi)@en[MessageEventInit]] [[辞書]]の [DFN[[CODE(DOMa)@en[data][MessageEvent]]]] [[IDL属性]]/[[辞書メンバー]] [SRC[>>12]] は、 受信したデータを表します。 [20] 値は[[任意のもの][any (Web IDL)]]です [SRC[>>12]]。 [[辞書]]での既定値は [CODE[null]] です [SRC[>>12]]。 * [CODE(DOMi)@en[MessageEvent]] インターフェイス [CODE(DOMa)@en[source][MessageEvent]] 属性 [21] [CODE(DOMi)@en[MessageEvent]] [[インターフェイス]]と [CODE(DOMi)@en[MessageEventInit]] [[辞書]]の [DFN[[CODE(DOMa)@en[source][MessageEvent]]]] [[IDL属性]]/[[辞書メンバー]] [SRC[>>12]] は、 データの送信者を表します。 [22] 値は [CODE(DOMi)@en[MessageEventSource]] または [CODE[null]] です [SRC[>>12]]。 [[辞書]]における既定値は [CODE[null]] です。 [18] [DFN[[CODE(DOMi)@en[MessageEventSource]]]] は、 次の[[いずれかを表す][or (Web IDL)]]と[[型定義]]されています [SRC[>>12]]。 [FIG(short list)[ - [CODE(DOMi)@en[WindowProxy]] - [CODE(DOMi)@en[MessagePort]] - [CODE(DOMi)@en[ServiceWorker]] ]FIG] * [CODE(DOMi)@en[MessageEvent]] インターフェイス [CODE(DOMa)@en[origin][MessageEvent]] 属性 [21] [CODE(DOMi)@en[MessageEvent]] [[インターフェイス]]と [CODE(DOMi)@en[MessageEventInit]] [[辞書]]の [DFN[[CODE(DOMa)@en[origin][MessageEvent]]]] [[IDL属性]]/[[辞書メンバー]] [SRC[>>12]] は、 データの送信者の[[起源]]を表します。 [22] 値は [CODE(IDL)@en[USVString]] です [SRC[>>12]]。 [[辞書]]における既定値は[[空文字列]]です [SRC[>>12]]。 [23] [[起源]]の[F[直列化][ASCII直列化]]が設定されるか、[[空文字列]]が設定されます。 * 歴史 [1] [CITE@en[Web Applications 1.0 r8455 Make WebSocket binary data ArrayBuffers mutable, for consistency with XHR.]] ( ([TIME[2014-02-04 08:17:00 +09:00]] 版)) [2] [CITE@en[Web Applications 1.0 r8589 Instead of MessageEvent.channel, use MessageEvent.target.name.]] ( ([TIME[2014-04-30 09:04:00 +09:00]] 版)) [3] [CITE@en[Re: ''''''[''''''whatwg'''''']'''''' MessageEvent and ports]] ([[Jonas Sicking]] 著, [TIME[2015-03-07 02:03:07 +09:00]] 版) [4] [CITE@en[Write structured clone algorithm in terms of ECMAScript · whatwg/html@bfb960c]] ([TIME[2016-03-02 16:39:01 +09:00]] 版) [5] [CITE@en[Editorial: define Event attribute defaults through IDL · whatwg/html@0be0229]] ([TIME[2016-03-23 21:16:14 +09:00]] 版) [6] [CITE@en[Use FrozenArray for Navigator#languages and MessageEvent#ports · whatwg/html@e4df68a]] ([TIME[2016-03-25 13:51:21 +09:00]] 版) [7] [CITE@en[Make MessageEvent's ports attribute non-nullable]] ([[cdumez]]著, [TIME[2016-10-11 07:09:55 +09:00]]) [8] [CITE@en[Specify the realm for the SSE MessageEvent]] ([[domenic]]著, [TIME[2016-10-28 02:17:38 +09:00]]) [9] [CITE@en[Enable MessageEvent to supplant ServiceWorkerMessageEvent]] ([[annevk]]著, [TIME[2016-11-11 01:55:35 +09:00]]) [10] [CITE@en[Add ServiceWorkerContainer target to MessageEvent]] ([[jungkees]]著, [TIME[2016-11-15 09:03:31 +09:00]]) [17] [CITE@en[Enable MessageEvent to supplant ServiceWorkerMessageEvent]] ([[annevk]]著, [TIME[2016-11-11 01:55:35 +09:00]]) [24] [CITE@en[Define messageerror]] ([[annevk]]著, [TIME[2017-04-13 20:36:23 +09:00]]) [25] [CITE@en[Remove Unicode serialization of an origin]] ([[annevk]]著, [TIME[2017-05-18 13:24:49 +09:00]]) [26] [CITE@en[Expose MessagePort to AudioWorklet]] ([[hoch]]著, [TIME[2017-10-03 17:07:58 +09:00]]) [28] [CITE@en[Expose MessagePort to AudioWorklet · Issue #3081 · whatwg/html]] ([TIME[2017-10-04 17:06:13 +09:00]]) [29] [CITE@en[Fix 3081: Expose MessagePort in AudioWorklet by hoch · Pull Request #3082 · whatwg/html]] ([TIME[2017-10-04 17:06:44 +09:00]]) [30] [CITE@en[22646 – So if we want to say on a per-object basis whether it ought to be exposed to workers (which I think is useful) lets introduce "exposed to document environments", "exposed to worker environments", and '''['''...''']''']] ([TIME[2017-12-08 16:17:25 +09:00]]) [31] [CITE@en[Use ASCII serialization for origins (#1151)]] ([[jungkees]]著, [TIME[2019-06-14 03:09:32 +09:00]]) [32] [CITE@en[Use ASCII serialization for origins by jungkees · Pull Request #1151 · w3c/ServiceWorker]] ([TIME[2020-01-12 20:28:37 +09:00]]) [33] [CITE@en[Use ASCII serialization for origins · Issue #1142 · w3c/ServiceWorker]] ([TIME[2020-01-12 20:29:13 +09:00]])