/
626.txt
204 lines (158 loc) · 8.24 KB
/
626.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
[13] [DFN[[CODE(DOMi)@en[MessageEvent]]]] は、[[サーバー]]や他の[[起源]]からメッセージを受信した時の[[イベント]]で使われる[[イベントインターフェイス]]です。
* 仕様書
[REFS[
- [12] [CITE@en-US-x-hixie[HTML Standard]] ([TIME[2016-12-13 09:04:33 +09:00]]) <https://html.spec.whatwg.org/#messageevent>
]REFS]
* コンストラクター
[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]] 版))
<http://html5.org/tools/web-apps-tracker?from=8454&to=8455>
[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]] 版))
<http://html5.org/tools/web-apps-tracker?from=8588&to=8589>
[3] [CITE@en[Re: ''''''[''''''whatwg'''''']'''''' MessageEvent and ports]]
([[Jonas Sicking]] 著, [TIME[2015-03-07 02:03:07 +09:00]] 版)
<https://lists.w3.org/Archives/Public/public-whatwg-archive/2015Mar/0008.html>
[4] [CITE@en[Write structured clone algorithm in terms of ECMAScript · whatwg/html@bfb960c]]
([TIME[2016-03-02 16:39:01 +09:00]] 版)
<https://github.com/whatwg/html/commit/bfb960c938580c95e77365e614218b952f96375b>
[5] [CITE@en[Editorial: define Event attribute defaults through IDL · whatwg/html@0be0229]]
([TIME[2016-03-23 21:16:14 +09:00]] 版)
<https://github.com/whatwg/html/commit/0be02299f128cbb7c65a7ce259fdd838fd44a4b5>
[6] [CITE@en[Use FrozenArray for Navigator#languages and MessageEvent#ports · whatwg/html@e4df68a]]
([TIME[2016-03-25 13:51:21 +09:00]] 版)
<https://github.com/whatwg/html/commit/e4df68a41b86753c7fcdd0d8ea4615f63ffc87e9>
[7] [CITE@en[Make MessageEvent's ports attribute non-nullable]]
([[cdumez]]著, [TIME[2016-10-11 07:09:55 +09:00]])
<https://github.com/whatwg/html/commit/df2c0c448612d5b8ab85ad3c6ce0255ee11c0b01>
[8] [CITE@en[Specify the realm for the SSE MessageEvent]]
([[domenic]]著, [TIME[2016-10-28 02:17:38 +09:00]])
<https://github.com/whatwg/html/commit/91d19d647433203f1f319e2afe76e63ceae646ca>
[9] [CITE@en[Enable MessageEvent to supplant ServiceWorkerMessageEvent]]
([[annevk]]著, [TIME[2016-11-11 01:55:35 +09:00]])
<https://github.com/whatwg/html/commit/8dd63c05ddd950b28b58bdb9767724afd77e092f>
[10] [CITE@en[Add ServiceWorkerContainer target to MessageEvent]]
([[jungkees]]著, [TIME[2016-11-15 09:03:31 +09:00]])
<https://github.com/whatwg/html/commit/6531e0982385de7f21b9a585dd53ad3bfc731043>
[17] [CITE@en[Enable MessageEvent to supplant ServiceWorkerMessageEvent]]
([[annevk]]著, [TIME[2016-11-11 01:55:35 +09:00]])
<https://github.com/whatwg/html/commit/8dd63c05ddd950b28b58bdb9767724afd77e092f>
[24] [CITE@en[Define messageerror]]
([[annevk]]著, [TIME[2017-04-13 20:36:23 +09:00]])
<https://github.com/whatwg/html/commit/25a94f606e983534a863a0559d65bd29bb940a02>
[25] [CITE@en[Remove Unicode serialization of an origin]]
([[annevk]]著, [TIME[2017-05-18 13:24:49 +09:00]])
<https://github.com/whatwg/html/commit/59ebd9c094d9d532458a9ee61f307bf41bc70811>