/
759.txt
408 lines (303 loc) · 16.5 KB
/
759.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
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
[62] [DFN[[[Web IDL]]]] は、 [[DOM]] その他の [[API]] の記述に使われる言語です。
仕様書としての [[Web IDL]] には、その言語自体の定義に加え、
[[Web IDL]] の記述と [[JavaScript]] の処理との対応関係や、
[[Web]] における [[JavaScript]] の [[API]] として実装するべき機能が規定されています。
* 仕様書
[REFS[
- [61] [CITE[Web IDL (Second Edition)]] ([TIME[2015-11-17 15:39:16 +09:00]] 版) <https://heycam.github.io/webidl/>
]REFS]
* 概念
[80]
[FIG(list short)[
- [[Web IDLの型]]
-- [CODE(IDL)@en[[[Promise]]]]
-- [CODE(IDL)@en[[[DOMException]]]]
-- [[インターフェイス]]
-- [[辞書]]
- [[大域環境]]
- [[拡張属性]]
[HISTORY[
- [CODE[module]]
- [CODE[sealed]]
- [CODE[exception]]
]HISTORY]
]FIG]
* JavaScript 束縛
[63] [[DOM API]] は [[Web IDL]] によって定義されていて、 [[Web IDL]] と [[JavaScript]]
の対応関係は [[Web IDL]] 仕様書で定義されています。
[64] いくつかの機能は [[Web IDL]] だけで記述できず、直接 [[JavaScript]]
の概念を参照して定義されています。
[FIG(list)[
- [65] [[大域オブジェクト]]が [CODE(DOMi)@en[[[Window]]]] のとき、 [CODE(JS)@en[[[ThisBinding]]]]
([CODE(JS)@en[[[this]]]]) は [CODE(DOMi)@en[[[Window]]]] ではなく
[CODE(DOMi)@en[[[WindowProxy]]]] になります。 [SRC[[[HTML Standard]]]]
- [66] [CODE(JS)@en[[[window.opener]]]]
- [67] [CODE(DOMi)@en[[[Window]]]] と [CODE(DOMi)@en[[[Location]]]] は[[同一起源ポリシー]]のために特殊な動作をします。
- [68] [CODE(JS)@en[[[document.all]]]] ([CODE(DOMi)@en[[[HTMLAllCollection]]]])
は特殊な動作をします。
]FIG]
* 互換性
[59] 記述言語としての [[Web IDL]] は不特定多数の[[著者]]が直接使う機能ではないので、
しばしば非互換変更が行われます。通常の [[Web]] 技術とは違って、
必要の無い機能は積極的に削除されます。
[60] [[Web IDL]] の改訂と [[Web IDL]] を使う各仕様の改訂は、必ずしも同期していません。
[[Web IDL]] に追加される見込みの (または追加してほしいと希望している)
機能が各仕様で使われることもあります。各仕様でまだ使われている機能が [[Web IDL]]
から削除されることもあります。
* 歴史
** W3C DOM 時代
[69] [[W3C DOM]] は [[OMG IDL]] を使っていました。各仕様書には[[附属書]]として
[[Java束縛]]および[[ECMAScript束縛]]が規定されていましたが、
特に後者は曖昧でほとんど意味をなさないものでした。
** HTML5
[70] [[WF2]], [[WA1]], [[XBL2]] といった初期 [[WHATWG]] 世代の仕様書では、
一部例外的な機能について、 [[JavaScript]] でどのように実装するべきかの規定を含んでいました。
しかし [[IDL]] と [[JavaScript]] との基本的な対応関係が規定されていない以上、
曖昧なものとならざるを得ませんでした。 [[Ian Hickson]] は、
いずれそれを明確化する必要があると予定していました。
** Web IDL
[1]
[CITE[WebIDL and HTML5]] ([[Ian Hickson <ian@...>]] 著, [CODE[2008-05-06 11:04:39 +09:00]] 版) <http://permalink.gmane.org/gmane.org.w3c.whatwg.discuss/14004>
([[名無しさん]])
[2]
[CITE[Web IDL]] ([CODE[2008-07-01 10:07:08 +09:00]] 版) <http://dev.w3.org/cvsweb/~checkout~/2006/webapi/WebIDL/Overview.html?content-type=text/html;%20charset=utf-8>
([[名無しさん]])
[3]
[CITE[Web IDL]] ([TIME[2008-08-28 18:26:27 +09:00]] 版) <http://www.w3.org/TR/2008/WD-WebIDL-20080829/>
[4] [CITE[Web IDL]] ([TIME[2008-12-23 00:36:01 +09:00]] 版) <http://www.w3.org/TR/2008/WD-WebIDL-20081219/>
[5] [CITE@en[WebIDL roadmap?]]
([[Dominique Hazael-Massieux]] 著, [TIME[2009-09-16 23:47:11 +09:00]] 版)
<http://lists.w3.org/Archives/Public/public-webapps/2009JulSep/1095.html>
[6] [CITE@en[Re: WebIDL roadmap?]]
([[Cameron McCormack]] 著, [TIME[2009-09-17 08:56:53 +09:00]] 版)
<http://lists.w3.org/Archives/Public/public-webapps/2009JulSep/1101.html>
[7] [CITE[public-script-coord@w3.org Mail Archives]]
([TIME[2009-10-31 23:54:02 +09:00]] 版)
<http://lists.w3.org/Archives/Public/public-script-coord/>
[8] [CITE@en[Fwd: Web IDL Garden Hose]]
([[Mark S. Miller]] 著, [TIME[2009-09-30 00:13:42 +09:00]] 版)
<http://lists.w3.org/Archives/Public/public-script-coord/2009JulSep/0002.html>
[9] [CITE[Index of /2006/webapi/WebIDL/dom]]
([TIME[2009-11-05 06:35:22 +09:00]] 版)
<http://dev.w3.org/2006/webapi/WebIDL/dom/>
[10] [CITE[Don’t call me DOM » WebIDL checker]] ([TIME[2009-11-12 22:13:49 +09:00]] 版) <http://people.w3.org/~dom/archives/2009/07/webidl-checker/>
[11] [CITE[IRC logs: freenode / #whatwg / 20091008]]
([TIME[2009-12-08 00:05:58 +09:00]] 版)
<http://krijnhoetmer.nl/irc-logs/whatwg/20091008#l-436>
[12] [CITE['''['''whatwg''']''' Java language bindings for HTML5]]
([TIME[2010-08-04 08:55:36 +09:00]] 版)
<http://lists.whatwg.org/pipermail/whatwg-whatwg.org/2010-August/027577.html>
[13] [CITE[IRC logs: freenode / #whatwg / 20100909]]
( ([TIME[2010-09-25 23:28:54 +09:00]] 版))
<http://krijnhoetmer.nl/irc-logs/whatwg/20100909>
[14] [CITE[Web IDL]]
( ([TIME[2010-10-21 05:56:53 +09:00]] 版))
<http://www.w3.org/TR/2010/WD-WebIDL-20101021/>
[15] [CITE[IRC logs: freenode / #whatwg / 20101019]]
( ([TIME[2010-10-26 22:42:45 +09:00]] 版))
<http://krijnhoetmer.nl/irc-logs/whatwg/20101019#l-1110>
[16] [CITE[Web IDL]]
( ([TIME[2011-07-11 22:03:42 +09:00]] 版))
<http://www.w3.org/TR/2011/WD-WebIDL-20110712/>
[17] [CITE@en[RfC: Last Call Working Draft of Web IDL; deadline October 18]]
( ([[Arthur Barstow]] 著, [TIME[2011-09-28 04:56:10 +09:00]] 版))
<http://lists.w3.org/Archives/Public/public-script-coord/2011JulSep/0467.html>
[18] [CITE[IRC logs: freenode / #whatwg / 20111116]]
( ([TIME[2011-11-18 00:23:14 +09:00]] 版))
<http://krijnhoetmer.nl/irc-logs/whatwg/20111116>
[19] [CITE[Java language binding for Web IDL]]
( ([TIME[2012-02-07 00:01:11 +09:00]] 版))
<http://www.w3.org/TR/2012/WD-WebIDL-Java-20120207/>
[20] [CITE[Web IDL]]
( ([TIME[2012-02-06 23:48:52 +09:00]] 版))
<http://www.w3.org/TR/2012/WD-WebIDL-20120207/>
[21] [CITE[Device APIs - Design Patterns & Guidelines]]
( ([TIME[2012-01-25 18:46:05 +09:00]] 版))
<http://dev.webinos.org/specifications/draft/patterns.html>
[22] [CITE[Web IDL]]
( ([TIME[2012-04-18 02:46:57 +09:00]] 版))
<http://www.w3.org/TR/2012/CR-WebIDL-20120419/>
[23] [CITE@en[Web API Design Cookbook]]
( ([TIME[2012-10-01 19:19:17 +09:00]] 版))
<http://www.w3.org/TR/2012/NOTE-api-design-20121002/>
[24] [CITE@en[Web API Design Cookbook]]
( ([TIME[2012-10-01 19:18:14 +09:00]] 版))
<http://darobin.github.com/api-design-cookbook/>
[25] [CITE[IRC logs: freenode / #whatwg / 20121204]]
( ([TIME[2012-12-14 22:04:57 +09:00]] 版))
<http://krijnhoetmer.nl/irc-logs/whatwg/20121204>
[26] [CITE@en-AU[Web IDL: Defining Web APIs and Implementing JavaScript Bindings]]
( ([TIME[2013-01-30 11:49:57 +09:00]] 版))
<http://mcc.id.au/2013/lca-webidl/>
[27] [CITE[IRC logs: freenode / #whatwg / 20130430]]
( ([TIME[2013-05-12 12:28:04 +09:00]] 版))
<http://krijnhoetmer.nl/irc-logs/whatwg/20130430#l-385>
[28] [CITE[Java language binding for Web IDL]]
( ([TIME[2013-05-13 21:54:11 +09:00]] 版))
<http://www.w3.org/TR/2013/NOTE-WebIDL-Java-20130514/>
[29] [CITE@en[CfC: publish Java bindings for WebIDL as a WG Note; deadline May 4]]
( ([[Arthur Barstow]] 著, [TIME[2013-04-27 23:25:13 +09:00]] 版))
<http://lists.w3.org/Archives/Public/public-webapps/2013AprJun/0398.html>
[30] [CITE[IRC logs: freenode / #whatwg / 20071003]]
( ([TIME[2013-05-22 12:31:19 +09:00]] 版))
<http://krijnhoetmer.nl/irc-logs/whatwg/20071003>
[31] [CITE[IRC logs: freenode / #whatwg / 20130620]]
( ([TIME[2013-06-22 12:30:28 +09:00]] 版))
<http://krijnhoetmer.nl/irc-logs/whatwg/20130620>
[32] [CITE[Web IDL in Blink - The Chromium Projects]]
( ([TIME[2013-09-30 05:12:29 +09:00]] 版))
<http://www.chromium.org/blink/webidl>
[33] [CITE[Blink IDL Extended Attributes - The Chromium Projects]]
( ([TIME[2013-09-30 05:12:29 +09:00]] 版))
<http://www.chromium.org/blink/webidl/blink-idl-extended-attributes>
[34] [CITE[WebKitIDL – WebKit]]
( ([TIME[2013-09-30 05:24:22 +09:00]] 版))
<http://trac.webkit.org/wiki/WebKitIDL>
[35] [CITE[Intent to Implement and Ship: Moving DOM attributes to prototype chains - Google グループ]]
( ([TIME[2013-11-01 21:24:43 +09:00]] 版))
<https://groups.google.com/a/chromium.org/forum/#!topic/blink-dev/t0XiZuMey7M>
[36] [CITE[Web IDL (Second Edition)]]
( ([TIME[2013-11-06 03:35:15 +09:00]] 版))
<http://heycam.github.io/webidl/>
[37] [CITE[Issue 43394 - chromium - DOM attributes should be moved to prototype chains and should expose JavaScript getters/setters - An open-source project to help move the web forward. - Google Project Hosting]]
( ([TIME[2013-12-09 09:51:35 +09:00]] 版))
<https://code.google.com/p/chromium/issues/detail?id=43394>
[38] [CITE@en[Web Applications 1.0 r8572 Editorial tweaks]]
( ([TIME[2014-04-12 04:08:00 +09:00]] 版))
<http://html5.org/tools/web-apps-tracker?from=8571&to=8572>
[39] [CITE[IRC logs: freenode / #whatwg / 20140425]]
( ([TIME[2014-04-26 14:47:24 +09:00]] 版))
<http://krijnhoetmer.nl/irc-logs/whatwg/20140425#l-871>
[40] [CITE[IRC logs: freenode / #whatwg / 20140519]]
( ([TIME[2014-05-22 17:23:00 +09:00]] 版))
<http://krijnhoetmer.nl/irc-logs/whatwg/20140519#l-341>
[41] [CITE[dontcallmedom/webidl-checker]]
( ([TIME[2014-05-29 02:30:05 +09:00]] 版))
<https://github.com/dontcallmedom/webidl-checker>
[42] [CITE[dontcallmedom/widlproc]]
( ([TIME[2014-05-29 02:31:54 +09:00]] 版))
<https://github.com/dontcallmedom/widlproc>
[43] [CITE[darobin/webidl2.js]]
( ([TIME[2014-05-29 02:34:49 +09:00]] 版))
<https://github.com/darobin/webidl2.js>
[44] [CITE@en[Re: WebIDL Spec Status]]
( ([[Marcos]] 著, [TIME[2014-06-24 06:05:55 +09:00]] 版))
<http://lists.w3.org/Archives/Public/public-webapps/2014AprJun/0990.html>
[45] [CITE@en[Re: Status of Web IDL]]
( ([[Boris Zbarsky]] 著, [TIME[2014-06-07 10:16:18 +09:00]] 版))
<http://lists.w3.org/Archives/Public/public-script-coord/2014AprJun/0162.html>
[46] [CITE@en[Re: WebIDL Spec Status]]
( ([[Boris Zbarsky]] 著, [TIME[2014-06-24 22:14:37 +09:00]] 版))
<http://lists.w3.org/Archives/Public/public-webapps/2014AprJun/1008.html>
[47] [CITE@en[Re: WebIDL Spec Status]]
( ([[Cameron McCormack]] 著, [TIME[2014-06-25 06:28:57 +09:00]] 版))
<http://lists.w3.org/Archives/Public/public-webapps/2014AprJun/1020.html>
[48] [CITE[mozilla-central mozilla/dom/webidl/]]
( ([TIME[2014-08-05 15:01:37 +09:00]] 版))
<http://mxr.mozilla.org/mozilla-central/source/dom/webidl/>
[49] [CITE@en[Help with WebIDL v1?]]
( ([[Travis Leithead]] 著, [TIME[2014-12-02 05:57:34 +09:00]] 版))
<http://lists.w3.org/Archives/Public/public-webapps/2014OctDec/0515.html>
[50] [CITE@en[WebIDL v1 vs. v2]]
( ([[Domenic Denicola]] 著, [TIME[2014-12-04 01:23:44 +09:00]] 版))
<http://lists.w3.org/Archives/Public/www-tag/2014Dec/0005.html>
[51] [CITE@en-US[WebIDL bindings - Mozilla | MDN]]
( ([TIME[2015-01-07 23:27:17 +09:00]] 版))
<https://developer.mozilla.org/en-US/docs/Mozilla/WebIDL_bindings#Implementing_WebIDL_using_Javascript>
[52] [CITE[Blink-in-JavaScript - The Chromium Projects]]
( ([TIME[2015-01-14 08:26:46 +09:00]] 版))
<https://www.chromium.org/blink/blink-in-js>
[53] [CITE[IRC logs: freenode / #whatwg / 20150113]]
( ([TIME[2015-01-14 10:31:13 +09:00]] 版))
<http://krijnhoetmer.nl/irc-logs/whatwg/20150113>
[54] [CITE@en[Bug 28093 – Consider using namespaceURI in the IDL]]
([TIME[2015-02-25 11:57:33 +09:00]] 版)
<https://www.w3.org/Bugs/Public/show_bug.cgi?id=28093#c3>
[55] [CITE@en[WebIDL Plans]]
([[Yves Lafon]] 著, [TIME[2015-04-10 21:53:52 +09:00]] 版)
<https://lists.w3.org/Archives/Public/public-webapps/2015AprJun/0078.html>
[56] [CITE@en[PSA: publish WD of "WebIDL Level 1"]]
([[Arthur Barstow]] 著, [TIME[2015-07-30 23:29:33 +09:00]] 版)
<https://lists.w3.org/Archives/Public/public-webapps/2015JulSep/0225.html>
[57] [CITE@en[WebIDL Level 1]]
( ([TIME[2015-07-31 15:37:41 +09:00]] 版))
<http://www.w3.org/TR/2015/WD-WebIDL-1-20150804/>
[58] [CITE@en[Remove v1 spec. · heycam/webidl@877b066]]
([TIME[2015-09-22 11:07:12 +09:00]] 版)
<https://github.com/heycam/webidl/commit/877b066aa14560b6e271910a6e6f8daf565bb41b>
[71] [CITE@en[CfC: publish Candidate Recommendation of Web IDL Level 1; deadline December 9]]
([[Arthur Barstow]] 著, [TIME[2015-12-02 22:23:44 +09:00]] 版)
<https://lists.w3.org/Archives/Public/public-script-coord/2015OctDec/0058.html>
[72] [CITE@en[Update ECMAScript and IDL integration by domenic · Pull Request #373 · whatwg/html]]
([TIME[2015-12-16 15:53:17 +09:00]] 版)
<https://github.com/whatwg/html/pull/373>
[73] [CITE@en[WebIDL Level 1]]
([TIME[2016-03-08 01:45:33 +09:00]] 版)
<https://www.w3.org/TR/2016/CR-WebIDL-1-20160308/>
[FIG(quote)[
[FIGCAPTION[
[74] [CITE@en[Editorial: link DOMStringMap algorithms · whatwg/html@fafd2e1]]
([TIME[2016-03-23 21:32:18 +09:00]] 版)
<https://github.com/whatwg/html/commit/fafd2e185ce5884b7cd90c6bf8c894ead0bdda90>
]FIGCAPTION]
> Also remove a note about it only describing a mapping to JavaScript,
> since that is true for all of IDL.
]FIG]
[75] [CITE@en[Editorial: Use consistent spacing for "Web IDL"]]
( ([[Resseguie]]著, [TIME[2016-06-15 17:20:35 +09:00]]))
<https://github.com/whatwg/html/commit/405a49c58954184b5a3f25ecf78bf84017a1bce3>
[76] [CITE@en[Quick update on WebIDL "Level 1"]]
([[Travis Leithead]]著, [TIME[2016-07-09 05:14:48 +09:00]])
<https://lists.w3.org/Archives/Public/public-webapps/2016JulSep/0004.html>
[77] [CITE@en[WebIDL crawler]]
([[Dominique Hazael-Massieux]]著, [TIME[2016-07-15 17:00:44 +09:00]])
<https://lists.w3.org/Archives/Public/public-script-coord/2016JulSep/0000.html>
[78] [CITE[WebIDLPedia]]
([TIME[2016-07-05 22:51:19 +09:00]])
<https://dontcallmedom.github.io/webidlpedia/>
[79] [CITE@en[CFC to publish WebIDL-1 as a Proposed Recommendation]]
([[Léonie Watson]]著, [TIME[2016-08-16 20:46:45 +09:00]])
<https://lists.w3.org/Archives/Public/public-webapps/2016JulSep/0058.html>
[81] [CITE@en[Convert specification to Bikeshed]]
([[tobie]]著, [TIME[2016-09-04 18:08:23 +09:00]])
<https://github.com/heycam/webidl/commit/e4a54951979a72004cae9f9949e856108a92224b>
[82] [CITE@en[WebIDL Level 1]]
([TIME[2016-09-15 18:24:33 +09:00]])
<https://www.w3.org/TR/2016/PR-WebIDL-1-20160915/>
[FIG(quote)[
[FIGCAPTION[
[83] [CITE@en[Welcome new WebPlat editors]]
([[Léonie Watson]]著, [TIME[2016-10-23 22:30:26 +09:00]])
<https://lists.w3.org/Archives/Public/public-webapps/2016OctDec/0013.html>
]FIGCAPTION]
> Tobie Langel (IE) as editor for WebIDL, Sangwhan Moon (IE) as editor for
> Web Workers and HTML, Yongsheng Zhu (Alibaba) as editor for DOM, and
> Brandon Jones (Google) as editor for Gamepad API.
]FIG]
[84] [CITE@en[Add myself to the editors.]]
([[tobie]]著, [TIME[2016-10-27 16:51:32 +09:00]])
<https://github.com/heycam/webidl/commit/1c308128e3416c724e2614f84db7c07eb4882660>
[85] [CITE@en[WebIDL Level 1]]
([TIME[2016-12-15 05:09:27 +09:00]])
<https://www.w3.org/TR/2016/REC-WebIDL-1-20161215/>
[86] [CITE@en[WebIDL-1 is a W3C Recommendation]]
([[Léonie Watson]]著, [TIME[2016-12-20 20:36:51 +09:00]])
<https://lists.w3.org/Archives/Public/public-webapps/2016OctDec/0032.html>
[87] [CITE[GC / DOM / Web API Integration :unicorn: - WebAssembly]]
([TIME[2017-01-14 05:40:46 +09:00]])
<http://webassembly.org/docs/gc/>
[88] [CITE@en[Add support for readonly attributes on namespaces (#264)]]
([[domenic]]著, [TIME[2017-01-22 09:22:31 +09:00]])
<https://github.com/heycam/webidl/commit/dca168847268a1e08fcb91f4ccadd2e3b748a39e>
[89] [CITE@en[Reference to WebIDL · Issue #408 · w3c/presentation-api]]
([TIME[2017-01-26 11:52:30 +09:00]])
<https://github.com/w3c/presentation-api/issues/408>
[90] [CITE@en[WebAPI/WebIDL Review Checklist - MozillaWiki]]
([TIME[2017-04-09 07:35:54 +09:00]])
<https://wiki.mozilla.org/WebAPI/WebIDL_Review_Checklist>
[91] [CITE@en-US[WebIDL bindings - Mozilla | MDN]]
([TIME[2017-03-02 14:58:55 +09:00]])
<https://developer.mozilla.org/en-US/docs/Mozilla/WebIDL_bindings>
[92] [CITE@en[Exact normative requirements for interface definitions are unclear · Issue #732 · whatwg/streams]]
([TIME[2017-04-14 15:38:30 +09:00]])
<https://github.com/whatwg/streams/issues/732>