-
Notifications
You must be signed in to change notification settings - Fork 4
/
889.txt
267 lines (214 loc) · 14.8 KB
/
889.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
[69] [DFN[[RUBYB[スカラー値列]@en[scalar value string]]]] ([DFN[[CODE[USVString]]]])
は、[[Unicodeスカラー値]]の[[文字列]]です。
[70] ほとんど「[[Unicode文字列]]」という意味に近いですが、
「[[文字]]」の語義を巡っては相当の混乱があります。
* 仕様書
[REFS[
- [25] '''[CITE[Web IDL (Second Edition)]] ([TIME[2016-05-21 05:55:04 +09:00]]) <https://heycam.github.io/webidl/#idl-USVString>'''
- [26] [CITE[Web IDL (Second Edition)]] ([TIME[2016-05-21 05:55:04 +09:00]]) <https://heycam.github.io/webidl/#es-USVString>
- [38] [CITE[Web IDL (Second Edition)]] ([TIME[2016-05-21 05:55:04 +09:00]]) <https://heycam.github.io/webidl/#dfn-obtain-unicode>
]REFS]
* 意味
[27] [CODE(IDL)@en[USVString]] は、[[Unicodeスカラー値]]の[[列]]を表します [SRC[>>25]]。
[29] [[型名]]は、 [CODE[USVString]] です [SRC[>>25]]。
* 構文
[28] [[辞書メンバー]]や[[引数]]の[[既定値]]の指定では、
[[文字列リテラル]]として記述できます [SRC[>>25]]。
* 文脈
[30] ほとんどの場合は [CODE(IDL)@en[DOMString]] を使うべきであり、
[[Unicodeスカラー値]]の列が必要な場合に限って [CODE(IDL)@en[USVString]]
とする[SHOULD[べき]]です [SRC[>>25]]。
[60] 次の場面で使われています。
[FIG(short list)[
- [[URL]] の一部または全部を入出力とするもの
- [[起源]]を入出力とするもの
- [CODE(JS)@en[document.domain]]
- [CODE(JS)@en[document.cookies]]
- [CODE(DOMi)@en[FormData]] [[API]]
- [[Fetch]] [[API]]
- [CODE(DOMi)@en[WebSocket]] [[API]]
- [CODE(DOMi)@en[TextDecoder]]
- [[フォームデータ集合]]
]FIG]
[HISTORY[
[61] [[ネットワーク]]の入出力 (に伴い[[文字コード]]の変換が発生するもの) だけでなく、
[[URL]] でも [CODE(DOMi)@en[USVString]] が使われています。利用箇所数でいえば
[CODE(DOMi)@en[USVString]] のほとんどは [[URL文字列]]です。
[[JavaScript]] や [[DOM]] が[[符号単位]]列 ([CODE(IDL)@en[DOMString]])
ベースである以上 [[URL]] に[[サロゲート]]が混入する可能性は排除できないのですが、
[[Ian Hickson]] は [[URL]] の[[構文解析器]]で行うべきと主張したのに対し、
[[Anne]] は [[URL]] の[[構文解析器]]の入出力は[[Unicodeスカラー値]]列だと定め、
[[URL]] を使うあらゆる [[API]] の[[データ型]]を [CODE(IDL)@en[USVString]]
に書き換えていきました。 (つまり [[URL]] の[[構文解析器]]の入力時ではなく、
[[メソッド]]の呼び出しや [[IDL属性]]の[[設定器]]の呼び出しの時点で[[サロゲート]]の検査を行うこととしました。)
[62] [[内容属性]]を[[反映]]する [CODE(IDL)@en[USVString]] の [[IDL属性]]経由で[[属性値]]を設定すると[[サロゲート]]の検査が行われ、
[CODE(DOMm)@en[setAttribute]] などを使うと検査が行われません。
[[サロゲート]]がそのまま [[URL Standard]] の[[構文解析器]]に渡るとすると[[素片識別子]]部分ならそのまま、
それ以外なら [[UTF-8パーセント符号化]]されるはずで、前者の場合[[サロゲート]]のまま出力されるはずですが、
[[Chrome]] では [CODE(char)[U+FFFD]] に置き換わっています。 ([[Firefox]] では[[素片識別子]]全体が[[UTF-8パーセント符号化]]されるので、そもそも [[URL Standard]]
と動作が違います。)
[[WebIDL]] レベルで変換しても、結局 [[URL]]
の[[構文解析器]]に渡す直前またはその中でまた検査するのが現実の実装ということになるので、
[[WebIDL]] レベルでの変換が本当に必要だったのかに疑問が生じます。
]HISTORY]
* 変換
[31] [CODE(IDL)@en[USVString]] 型の[[IDL値]][VAR[入力]]から [[JavaScript]]
への[[変換][変換 (WebIDL)]]は、次のようにします [SRC[>>26]]。
[FIG(steps)[
= [35] [VAR[スカラー値列]]を、[VAR[入力]]の表す[[Unicodeスカラー値]]の列に設定します。
= [36] [VAR[符号単位列]]を、[VAR[スカラー値列]]を [[UTF-16]] で[[符号化]]した結果の[[符号単位]]の列に設定します。
= [37] [VAR[符号単位列]]と同じ[[符号単位]]の列を表す [CODE(JS)@en[String]]
値を返します。
]FIG]
[33] [[JavaScript]] [VAR[入力]]から [CODE(IDL)@en[USVString]]
型[[IDL値]]への[[変換][変換 (WebIDL)]]は、次のようにします [SRC[>>26]]。
[FIG(steps)[
= [32] [VAR[列]]を、[VAR[入力]]を [CODE(IDL)@en[DOMString]] に[[変換][変換 (WebIDL)]]した結果に設定します。
= [34] [VAR[列]]を[[[CODE(IDL)@en[DOMString]]をUnicodeスカラー値列に変換]]した結果を返します。
]FIG]
[39] [VAR[符号単位列]]について[DFN[[RUBYB[[[[CODE(JS)@en[DOMString]]をUnicodeスカラー値列に変換]]]@en[convert a DOMString to a sequence of Unicode scalar values]]]]するには、
次のようにします [SRC[>>38]]。
[FIG(steps)[
= [42] [VAR[スカラー値列]]を、[[空]]の[[列]]に設定します。
= [40] [VAR[n]] を、[VAR[文字列]]の[[長さ]]に設定します。
= [41] [VAR[i]] を、 [N[0]] に設定します。
= [43] [VAR[i]] < [VAR[n]] の間、繰り返し、
== [44] [VAR[c]] を、[VAR[符号単位列]]において[[索引]] [VAR[i]] の[[符号単位]]に設定します。
== [45] [VAR[c]] により、
[FIG(switch)[
: [VAR[c]] が[[範囲]] [ [N[0xDC00]], [N[0xDFFF]] ] に含まれる :
[VAR[スカラー値列]]の末尾に [CODE(char)[U+FFFD]] を追加します。
: [VAR[c]] が[[範囲]] [ [N[0xD800]], [N[0xDBFF]] ] に含まれる :
[FIG(steps)[
= [46] [VAR[i]] が [VAR[n]] - 1 なら、
== [47] [VAR[スカラー値列]]の末尾に [CODE(char)[U+FFFD]] を追加します。
= [48] それ以外なら、
== [49] [VAR[d]] を、[VAR[符号単位列]]において[[索引]] [VAR[i]] + 1 の[[符号単位]]に設定します。
== [50] [VAR[d]] が[[範囲]] [ [N[0xDC00]], [N[0xDFFF]] ] に含まれるなら、
=== [51] [VAR[スカラー値列]]の末尾に[[符号位置]] [N[216]] + [N[210]] × ([VAR[c]] & [N[0x3FF]]) +
([VAR[d]] & [N[0x3FF]]) の[[Unicode文字]]を追加します。
=== [52] [VAR[i]] を[[インクリメント]]します。
== [53] それ以外なら、
=== [54] [VAR[スカラー値列]] の末尾に [CODE(char)[U+FFFD]] を追加します。
]FIG]
: それ以外 :
[VAR[スカラー値列]]の末尾に[[符号位置]] [VAR[c]] の[[Unicode文字]]を追加します。
]FIG]
== [55] [VAR[i]] を[[インクリメント]]します。
= [56] [VAR[スカラー値列]]を返します。
]FIG]
;; [57] これはつまり、[[サロゲートペア]]になっていない[[サロゲート]]が含まれる時、
[CODE(char)[U+FFFD]] に置換されることとなります。
[73] 次の場面で使われます。
[FIG(short list)[ [74] [DFN[Unicodeに変換]]する場面
- [CODE[send][send (XHR)]]
]FIG]
* 歴史
** [CODE(IDL)@en[EnsureUTF16]]
@@ XXX
** [CODE(IDL)@en[ScalarValueString]]
[REFS[
- [2] [CITE@en[Bug 24581 – Fix ByteString type & ''''''[''''''EnsureUTF16'''''']'''''' flag story]]
( ([TIME[2014-05-21 03:17:32 +09:00]] 版))
<https://www.w3.org/Bugs/Public/show_bug.cgi?id=24581>
- [1] [CITE[Add ScalarValueString · 1866106 · whatwg/encoding]]
( ([TIME[2014-05-21 03:16:51 +09:00]] 版))
<https://github.com/whatwg/encoding/commit/18661066238357d6f2da5b8ca59b4055f00fad3d>
- [3] [CITE[Use ScalarValueString https://www.w3.org/Bugs/Public/show_bug.cgi?id=255... · fad6118 · whatwg/xhr]]
( ([TIME[2014-05-21 03:20:58 +09:00]] 版))
<https://github.com/whatwg/xhr/commit/fad6118b670569bef63afc8d5e1bb5a94154f431>
- [4] [CITE[Use ScalarValueString · 88155a5 · whatwg/url]]
( ([TIME[2014-05-21 03:22:16 +09:00]] 版))
<https://github.com/whatwg/url/commit/88155a5f136b702ef977fdc601629f0564cbdde3>
- [5] [CITE[The Oprah meme for ScalarValueString · f79a4b5 · whatwg/url]]
( ([TIME[2014-05-28 15:30:35 +09:00]] 版))
<https://github.com/whatwg/url/commit/f79a4b5a0eef68ee587a87820c06fcf83a0674b9>
- [6] [CITE[Clarify URL use in APIs · eece8eb · whatwg/url]]
( ([TIME[2014-05-28 15:31:31 +09:00]] 版))
<https://github.com/whatwg/url/commit/eece8ebf1391c538cdbaab6e4b957ea769d06b56>
]REFS]
** [CODE(IDL)@en[USVString]]
[12] [CODE(IDL)@en[[[EnsureUTF16]]]] は >>11 で削除されました。
[14] >>13 で [CODE(IDL)@en[[[USVString]]]] が追加されました。
[REFS[
- [13] [CITE@en[Add USVString and allow string literals in IDL to be used to give values... · 672e73d · heycam/webidl]] ([TIME[2014-10-10 07:30:10 +09:00]] 版) <https://github.com/heycam/webidl/commit/672e73d476d8c4341339cc22592bb5ff01c69823>
- [11] [CITE@en[Remove '''['''EnsureUTF16''']'''. · e2cf800 · heycam/webidl]] ([TIME[2014-10-10 07:21:43 +09:00]] 版) <https://github.com/heycam/webidl/commit/e2cf800ef401578db8d1445d815dc13bc8899554>
- [7] [CITE@en[IDL now defines USVString (new ScalarValueString) · 193297f · whatwg/encoding]] ([TIME[2014-10-04 12:42:24 +09:00]] 版) <https://github.com/whatwg/encoding/commit/193297f512d34bb952c4473f95324939dd2cc0d6>
- [8] [CITE@en[IDL defines ScalarValueString as USVString now · 0f14352 · whatwg/fetch]] ([TIME[2014-10-04 12:43:09 +09:00]] 版) <https://github.com/whatwg/fetch/commit/0f143525dfb28c57e6b776eb3d26610be44b97e6>
- [9] [CITE@en[ScalarValueString -> USVString · b75e040 · whatwg/url]] ([TIME[2014-10-04 12:43:29 +09:00]] 版) <https://github.com/whatwg/url/commit/b75e040ed46a7bee5f383e501fd6257c46b2753a>
- [10] [CITE@en[Align with IDL and DOM changes · fb55469 · whatwg/xhr]] ([TIME[2014-10-04 12:44:40 +09:00]] 版) <https://github.com/whatwg/xhr/commit/fb55469f56253d6d40e2430314d63c720c5b19bd>
]REFS]
[15] [CITE@en[Web Applications 1.0 r8836 Switch to using USVString where that makes the prose simpler. (WebSocket, primarily)]]
( ([TIME[2014-10-11 09:58:00 +09:00]] 版))
<https://html5.org/r/8836>
[16] [CITE@en[Since icon takes a URL -> USVString · f62c920 · whatwg/notifications]]
( ([TIME[2014-11-13 11:30:44 +09:00]] 版))
<https://github.com/whatwg/notifications/commit/f62c920ad1bca50d40ccc3e9a9a6ffef234ae5bc>
[17] [CITE@en[Allow USVString to be serialized. · heycam/webidl@d7aaded]]
([TIME[2015-04-19 13:09:02 +09:00]] 版)
<https://github.com/heycam/webidl/commit/d7aaded036ea48a4d9a8fd543d2cba046ce34cab>
[18] [CITE@en[USVString is the right type for things to be encoded and sent over th… · w3c/webappsec-credential-management@c749164]]
([TIME[2015-11-19 16:26:11 +09:00]] 版)
<https://github.com/w3c/webappsec-credential-management/commit/c7491649ac0ae7d30f00e31c70f5c7194cc9f48b>
[19] [CITE@en[Editorial: define Event attribute defaults through IDL · whatwg/html@0be0229]]
([TIME[2016-03-23 21:16:59 +09:00]] 版)
<https://github.com/whatwg/html/commit/0be02299f128cbb7c65a7ce259fdd838fd44a4b5>
[20] [CITE@en[Use USVString for oldURL, newURL, and origin attributes on events · whatwg/html@5d5702d]]
([TIME[2016-03-23 21:19:46 +09:00]] 版)
<https://github.com/whatwg/html/commit/5d5702d35a0b7457481d1013154f14aab25500bf>
[21] [CITE@en[Update WebSocket to use Fetch's WebSocket alterations · whatwg/html@3dadbca]]
([TIME[2016-03-28 22:54:41 +09:00]] 版)
<https://github.com/whatwg/html/commit/3dadbcad063a10b586ef52dd4b427aa339048ee7>
[22] [CITE@en[Use USVString for document.domain/referrer/cookie · whatwg/html@8170d82]]
([TIME[2016-04-05 13:59:49 +09:00]] 版)
<https://github.com/whatwg/html/commit/8170d82a2fc93c8ff7981c54aa4ccafd54204552>
[23] [CITE@en[Make EventSource use the base URL of its global · whatwg/html@3175b53]]
([TIME[2016-04-22 18:23:10 +09:00]] 版)
<https://github.com/whatwg/html/commit/3175b53a7fab83a62fc1c5674e8356f720d2aa4a>
[24] [CITE@en[Reflect USVString IDL attributes for URLs as well as DOMString ones · whatwg/html@2ced624]]
([TIME[2016-04-23 16:30:11 +09:00]] 版)
<https://github.com/whatwg/html/commit/2ced6248d16e5a742e324ba3f506cc6d179b0414>
[58] [[Firefox]] も [[Chrome]] も、 [CODE(HTML)@en[<a href>]] の
[[IDL属性]]で既に [CODE(IDL)@en[USVString]] として動作するようになっているようです。
[[IE9]] は [CODE(IDL)@en[DOMString]] としているようです。
[TIME[2016-05-21T15:17:18.500Z]]
[59] [[Firefox]] も [[Chrome]] も [CODE(HTML)@en[<blockquote cite>]]
は [CODE(IDL)@en[USVString]] ではなく [CODE(IDL)@en[DOMString]]
としています。
[TIME[2016-05-21T15:20:16.800Z]]
[63] [CITE@en[Use USVString for URLs and origins in IDL]]
( ([[zcorpan]]著, [TIME[2016-05-20 21:56:11 +09:00]]))
<https://github.com/whatwg/dom/commit/1bb85a48e07d1000e00bd792d61247b9a5e2e4ae>
[64] [CITE@en[Use USVString for all URLs]]
( ([[domenic]]著, [TIME[2016-05-20 22:02:29 +09:00]]))
<https://github.com/whatwg/html/commit/018b983b77b2cd908f6d00100e7e0abe893dd2c3>
[65] [CITE@en[Ensure strings in the form data set contain USVs]]
([[yuyokk]]著, [TIME[2016-12-17 05:26:43 +09:00]])
<https://github.com/whatwg/html/commit/f35af4efea8f89743ebdda4661c3bb58349828a9>
[66] [CITE@en[Use USVString rather than '''['''EnsureUTF16''']''' for fileName.]]
([[mkruisselbrink]]著, [TIME[2017-02-04 07:25:23 +09:00]])
<https://github.com/w3c/FileAPI/commit/abf6637473a9c81247fce46ef0a2954be95908f1>
[67] [CITE@en[Define JavaScript string and scalar value string]]
([[annevk]]著, [TIME[2017-03-27 16:01:49 +09:00]])
<https://github.com/whatwg/infra/commit/f1be763cfba23d2fc780b35403074c599e69616e>
[68] [CITE@en[Define length for byte sequences and strings]]
([[annevk]]著, [TIME[2017-03-27 16:59:15 +09:00]])
<https://github.com/whatwg/infra/commit/c484a4fe0d7bdc52b0f17ab99e49eaa9e56e3f56>
[71] [CITE@en['''['''cssom''']''' Use USVString for href attribute of Stylesheet and CSSImportRule]]
([[SimonSapin]]著, [TIME[2017-04-21 12:19:25 +09:00]])
<https://github.com/w3c/csswg-drafts/commit/4ade7360db96f95c902e9c8b24dd6e4e20d49ec7>
[72] [CITE@en[IDL amendments and small misc issues. (#271)]]
([[andypaicu]]著, [TIME[2017-12-13 17:46:06 +09:00]])
<https://github.com/w3c/webappsec-csp/commit/82aebd3dcd00492ce718e92ada3ebf1e4133cf36>
[75] [CITE@en[Editorial: rewrite send()'s body/content-type processing]]
([[domenic]]著, [TIME[2018-04-24 00:09:11 +09:00]])
<https://github.com/whatwg/xhr/commit/f47bbab42dabe1f52e5e9f1ed1fa6df06a6eb310>
[76] [CITE@en['''['''typed-om''']''' Per WG resolution, just use USVString for everything. Fixes …]]
([[tabatkins]]著, [TIME[2018-02-22 06:51:54 +09:00]])
<https://github.com/w3c/css-houdini-drafts/commit/5e48fe4bcf68c81c2da464fa8f1b8fd0595d3428>
[77] [CITE@en[Should we be using DOMString, USVString, or CSSOMString? · Issue #687 · w3c/css-houdini-drafts]]
([TIME[2018-05-08 21:37:46 +09:00]])
<https://github.com/w3c/css-houdini-drafts/issues/687>
[78] [CITE@en[SecurityPolicyViolationEvent needs more USVString · Issue #266 · w3c/webappsec-csp]]
([TIME[2019-03-08 12:22:53 +09:00]])
<https://github.com/w3c/webappsec-csp/issues/266>