/
122.txt
296 lines (222 loc) · 15.9 KB
/
122.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
* 仕様書
[REFS[
- [12] '''[CITE@en-GB-x-hixie[HTML Standard]] ([TIME[2015-04-25 04:40:19 +09:00]] 版) <https://html.spec.whatwg.org/#dom-location-reload>'''
]REFS]
* 再読み込み
[4] [[Webブラウザー]]は通常[[再読み込み]]機能を実装しています。これはおおむね
[CODE(JS)@en[[[location.reload]]]] に相当するものです。
[5] [[GUI]] 環境で動作する [[Webブラウザー]]は普通[[ツールバー]]などに[[再読み込み]]ボタンを設けています。
[6] [[Windows]] で動作する [[Webブラウザー]]の多くは [KBD[[[F5]]]] や
[KBD[[[Ctrl]] + [[R]]]] で[[再読み込み]]が実行されます。
[8] [[Webサイト]]によっては、[[利用者]]が [KBD[[[F5]]]] によって[[再読み込み]]を実行することを避けるために[[鍵盤イベント]]を[[取り消し]]することでこれを無効化していることがあります。
誤操作や安易な [[DoS攻撃]]を避けるために有用なこともありますが、
多くの場合は[[利用者]]の利便性を低下させるだけであり、好ましくない挙動と思われています。
[7] 多くの [[Webブラウザー]]は[[スーパーリロード]]も実装しています。
;; [[スーパーリロード]]参照。
[40] 多くの [[Webブラウザー]]は[[文字コード指定メニュー]]も実装しています。
[14] [[利用者]]が[[閲覧文脈]]の[[活性文書]]の[RUBYB[[[再読込]]]@en[reload]]を求めたら、
次のようにする[['''べきです''']] [SRC[>>12]]。
この時[[利用者]]が[VAR[キャッシュ上書き]]を指示できても構いません。
[FIG(steps)[
= [15] [[閲覧文脈]]の[[活性文書]]の [[fetch]] の際の[[要求メソッド]]が[[冪等メソッド]]でないなら、
[[利用者]]に確認します [SRC[>>12]]。
= [16] [[利用者]]が拒んだら、ここで停止します [SRC[>>12]]。
= [20] [[エントリー更新]]のため [[navigate]] します [SRC[>>12]]。
[FIG(list members)[
:[VAR[[[navigate]] する[[閲覧文脈]]]]:[[閲覧文脈]] [SRC[>>12]]
:[VAR[新しい[[資源]]]]:[[閲覧文脈]]の[[活性文書]]と同じ [SRC[>>12]]
:[VAR[[[置換有効]]]]:[[真]] [SRC[>>12]]
: [VAR[[[reload-triggered navigation]]]] : [[真]] [SRC[>>12]]
:[VAR[キャッシュ上書き]] : [VAR[キャッシュ上書き]]
]FIG]
]FIG]
;; [21] 再読込する[[資源]]やその[[要求メソッド]]は、[[閲覧文脈]]の当該[[セッション履歴エントリー]]の指定に拠ります。
;; [37] [[フレーム]]の再読込に対応した [[Webブラウザー]]は、
[[[CODE(HTMLe)@en[iframe]] [CODE(HTMLa)@en[srcdoc]]文書]]の場合 (>>27)
も考慮する必要がありそうです。
;; [38] [[navigate]] の際に [[reload-triggered navigation]] も設定する必要がありそうです。
;; [39] [[Webブラウザー]]により、 [[navigate]] 内の [[fetch]] で
[CODE(HTTP)@en[[[Origin:]]]] が設定されるものとされないものがあるようです。
最近の [[Chrome]] は設定しないようです。 [TIME[2015-05-26T08:24:31.200Z]]
[57] [[仕様書]]にはありませんが、[VAR[キャッシュ上書き]]が[[真]]の場合、
[[navigate]] だけでなく、[[部分資源]]の [[fetch]] でも[F[キャッシュモード]]が適当に設定されるかもしれません。
[HISTORY[
[17]
かつて[[仕様書]]や [[Firefox]] は、
[[overridden reload]]
を組み込んでいましたが、廃止されました。
]HISTORY]
** 安全性
[9] [[再読み込み]]によって[[要求]]を再度実行しても[[安全]]かどうかは、
[[要求メソッド]]に依存します。 [CODE(HTTP)@en[[[GET]]]] は[[安全]]ですが、
[CODE(HTTP)@en[[[POST]]]] は[[安全]]ではありません。
[10] [[Webブラウザー]]は[[非安全]]な[[要求]]を[[再読み込み]]する前に[[利用者]]に[[モーダルダイアログ]]によって[[再読み込み]]を本当に実行するか確認するのが普通です。
;; [11] [[安全なメソッド]]も参照。
;; [23] [[冪等なメソッド]]であっても、[[再読込]]までの間に自身または他者により他の操作が行われていた場合、
元とは異なる結果になるかもしれません。[[冪等なメソッド]]であっても[[安全なメソッド]]でなければ、
確認するべきかもしれません。ただし現在の [[Web]] で [[navigate]]
可能な[[要求メソッド]]の中では、[[冪等]]で[[非安全]]なものはありませんから、
問題とはなりません。 ([[Web Forms 2.0]] を実装していた [[Webブラウザー]]では
[CODE(HTTP)@en[[[PUT]]]] と [CODE(HTTP)@en[[[DELETE]]]] への [[navigate]]
があり得ました。)
[75] 最近、[[Chrome]] は[[認証ダイアログ]]後の[[再読込]]でも、
[[安全]]でないとき[[モーダルダイアログ]]で確認するようになりました。
[TIME[2020-01-11T01:44:51.600Z]]
* [CODE(DOMi)@en[Location]] インターフェイス [CODE(DOMm)@en[reload]] メソッド
[13] [CODE(DOMi)@en[[[Location]]]] [[インターフェイス]]の
[DFN[[CODE(DOMm)@en[[[reload]]]]]] [[メソッド]]は、
次のようにしなければ[['''なりません''']]。
[FIG(steps)[
= [34] [VAR[キャッシュ上書き]]を、第1引数を [CODE(IDL)@en[[[boolean]]]] として解釈した結果に設定します。
= [43] [[文脈オブジェクト]]の[F[[[関係する[CODE(DOMi)@en[Document]]]]]]の[F[起源][文書の起源]]と[[入口設定群オブジェクト]]の[F[起源]]が[[同じ起源ドメイン]]でなければ、
== [44] [CODE(DOMe)@en[SecurityError]] [[例外]]を[[投げ]]、ここで停止します [SRC[>>12]]。
= [26] [[現在走っているタスク]]が[[利用者]]による[[閲覧文脈]]の [[resize]]
に起因する [CODE(DOMe)@en[[[resize]]]] の [[dispatch]] を行っているものなら、
== [45] [[閲覧文脈]]の [[repaint]] を行い、ここで停止します [SRC[>>12]]。
= [27] [[閲覧文脈]]の[F[活性文書]]が [F[[[[CODE(HTMLe)@en[iframe]] [CODE(HTMLa)@en[srcdoc]]文書]]]]なら、
== [46] [[閲覧文脈]]の[F[閲覧文脈包含子]]について
[[[CODE(HTMLe)@en[iframe]]の属性を再処理]]します。 [SRC[>>12]]
= [28] それ以外で、[[閲覧文脈]]の[F[活性文書]]が [F[reload override flag]] を設定されているなら、
== [29] [[overridden reload]] を実行します。[VAR[[[原始閲覧文脈]]]]は、[[閲覧文脈]]とします。 [SRC[>>12]] [VAR[キャッシュ上書き]]も引き渡します。
[[例外]]が[[投げ]]られたら、[[再度投げ]]ます [SRC[>>12]]。
= [30] それ以外なら、
== [31] [[エントリー更新]]のため [[navigate]] します [SRC[>>12]]。
[FIG(list members middle)[
: [VAR[[[navigate]] する[[閲覧文脈]]]] :[[閲覧文脈]] [SRC[>>12]]
: [VAR[新しい[[資源]]]] : [[閲覧文脈]]の[F[活性文書]]の[F[文書の番地]] [SRC[>>12]]
: [VAR[[[置換有効]]]]:[[真]] [SRC[>>12]]
: [VAR[[[例外有効]]]]:[[真]] [SRC[>>12]]
: [VAR[[[原始閲覧文脈]]]]:[[閲覧文脈]] [SRC[>>12]]
: [VAR[[[reload-triggered navigation]]]] :[[真]] [SRC[>>12]]
: [VAR[キャッシュ上書き]] : [VAR[キャッシュ上書き]]
: [VAR[エントリー更新するエントリー]] : [VAR[閲覧文脈]]の[F[セッション履歴]]の[F[現在エントリー]]
]FIG]
[[例外]]が[[投げ]]られたら、[[再度投げ]]ます [SRC[>>12]]。
]FIG]
;; [25] [[閲覧文脈]]とは、[[文脈オブジェクト]]の[F[文書]]の[F[閲覧文脈]]を指すと思われます。
;; [22] [[利用者]]が[[再読込]]を指示した場合と違って、
[[冪等メソッド]]でなくても確認ダイアログは出ず、常に [CODE(HTTP)@en[GET]]
となる [SRC[>>12]] ようです。
[24] [[IE]] と [[Firefox]] は [[overridden reload]] に対応しているようですが、
[[Chrome]] は対応していないようです。 [TIME[2015-05-06T08:14:43.800Z]]
[35] [[HTML Standard]] はなぜか[[引数]]を規定していませんが、実際には省略可能な
[CODE(IDL)@en[[[boolean]]]] 型の[[引数]]が1つあるようです。
[47] [CODE(DOMm)@en[reload]] [[メソッド]]は、 [CODE(IDL xattr)@en[Unforgeable]]
です [SRC[>>12]]。
[41] [CODE(DOMi)@en[[[PluginArray]]]] [[インターフェイス]]の
[CODE(DOMm)@en[[[refresh]]]] [[メソッド]]は、本メソッド相当の動作をすることがあります。
* 再読込要求
[65] [[要求]]は、
[DFN[[F[reload-navigation flag]]]] を持ちます。
初期値は[[偽]]です。 [SRC[[CITE[Fetch Standard]]]]
[63] [CODE[Request]] [[インターフェイス]]の
[DFN[[CODE(DOMa)@en[isReloadNavigation]]]]
[[IDL属性]]の[[取得器]]は、次のようにします [SRC[[CITE[Fetch Standard]]]]。
[FIG(steps)[
= [64] [[文脈オブジェクト]]の [F[reload-navigation flag]] を [CODE(IDL)@en[boolean]] で返します。
]FIG]
[61] [[navigate]] [[アルゴリズム]]は、[[引数]]として
[DFN[[VAR[reload-triggered navigation]]]] を持ちます [SRC[[CITE[HTML Standard]]]]。
[[再読込]]の時に設定されます。
;; [[navigate]]、[[履歴の探索]]参照。
* overridden reload
[36] [[overridden reload]] は、 [CODE(JS)@en[[[document.open]]]] により生成されたページの再読込を行うものです。
;; [CODE(JS)@en[[[document.open]]]] を参照。
* 歴史
[1] [CITE@en-US[Window Object 1.0]]
( ([TIME[2006-04-08 02:19:28 +09:00]] 版))
<http://www.w3.org/TR/Window/#dfn-reload>
[2] [CITE@en[Web Applications 1.0 r5709 Make document.reload() reload the input to document.write(), not reload the URL of the page. Also, a number of editorial fixes.]]
( ([TIME[2010-12-08 07:10:00 +09:00]] 版))
<http://html5.org/tools/web-apps-tracker?from=5708&to=5709>
[3] [CITE@en[Web Applications 1.0 r8400 Turns out location.reload() does work even when you have a fragment identifier...]]
( ([TIME[2014-01-17 02:51:00 +09:00]] 版))
<http://html5.org/tools/web-apps-tracker?from=8399&to=8400>
[32] [CITE@en-US[Location.reload() - Web API Interfaces | MDN]]
([TIME[2015-04-20 10:22:31 +09:00]] 版)
<https://developer.mozilla.org/en-US/docs/Web/API/Location/reload>
[33] [CITE@ja[location.reloadはhref属性で使うと処理が完了するまで待ちになる at HouseTect, JavaScriptな情報をあなたに]]
([[HouseTect, JavaScriptな情報をあなたに]] 著, [TIME[2012-04-02 15:07:38 +09:00]] 版)
<http://hisasann.com/housetect/2008/03/locationreloadhref.html>
[42] [CITE@en[1069724 – Multiple HTTP2 Connections on shift-reload]]
([TIME[2015-08-28 11:54:24 +09:00]] 版)
<https://bugzilla.mozilla.org/show_bug.cgi?id=1069724>
[48] [CITE@en[Merge effective script origin into origin · whatwg/html@8a843f2]]
([TIME[2016-03-31 18:13:58 +09:00]] 版)
<https://github.com/whatwg/html/commit/8a843f2169a6864a3024c4329528dccb2051d275>
[49] [CITE@en[Editorial: turn "exceptions enabled" into a flag]]
( ([[annevk]]著, [TIME[2016-05-02 16:13:36 +09:00]]))
<https://github.com/whatwg/html/commit/879edbfcb25586caec8df93f303a434a700a18bc>
[50] [CITE@en[1267474 – Cache-Control: immutable]]
( ([TIME[2016-06-06 11:11:13 +09:00]]))
<https://bugzilla.mozilla.org/show_bug.cgi?id=1267474>
[51] [CITE@en[Issue 505048 - chromium - Chrome makes more conditional re-validation requests than other browsers - Monorail]]
( ([TIME[2016-06-06 11:12:07 +09:00]]))
<https://bugs.chromium.org/p/chromium/issues/detail?id=505048>
[52] [CITE@en[Issue 600636 - chromium - Change behavior of Reload to (validate main resource + regular load) instead of the current forced reload which triggers conditional requests on all the things - Monorail]]
( ([TIME[2016-06-06 11:12:40 +09:00]]))
<https://bugs.chromium.org/p/chromium/issues/detail?id=600636>
[53] [CITE[Reload, reloaded - Google ドキュメント]]
( ([TIME[2016-06-06 11:15:19 +09:00]]))
<https://docs.google.com/document/d/1vwx8WiUASKyC2I-j2smNhaJaQQhcWREh7PC3HiIAQCo/edit?pref=2&pli=1>
[54] [CITE@en[Issue 578941 - chromium - document.location.reload('''['''false''']''') always reloads from Server instead of Cache - Monorail]]
( ([TIME[2016-06-06 11:16:10 +09:00]]))
<https://bugs.chromium.org/p/chromium/issues/detail?id=578941>
[FIG(quote)[
[FIGCAPTION[
[55] [CITE@en[Issue 42528 - chromium - Chrome/Chromium caches negative DNS responses and ignores changes to /etc/resolv.conf - Monorail]]
( ([TIME[2016-06-16 21:23:06 +09:00]]))
<https://bugs.chromium.org/p/chromium/issues/detail?id=42528>
]FIGCAPTION]
>
> You should be able to workaround your problem by hitting refresh, which should bypass that cache. (There are
> some exceptions, let me know if you are hitting them).
]FIG]
[56] [CITE@en[Issue 44386 - chromium - The "Reload" link on the network error page does not actually do a reload - Monorail]]
( ([TIME[2016-06-16 21:32:49 +09:00]]))
<https://bugs.chromium.org/p/chromium/issues/detail?id=44386>
[58] [CITE@en[Fix reloads to not wipe out future session history]]
([[domenic]]著, [TIME[2016-08-25 23:22:44 +09:00]])
<https://github.com/whatwg/html/commit/6c777d89fa177cbae2a0671ca9d681d7c81688e3>
[59] [CITE@en[For users on very slow connections, block document.written scripts · Issue #17 · WICG/interventions]]
([TIME[2017-07-15 23:49:56 +09:00]])
<https://github.com/WICG/interventions/issues/17>
[60] [CITE@en[747812 - Re-submitted POST request (page reload) does not contain Content-Type - chromium - Monorail]]
( ([TIME[2017-08-21 01:49:07 +09:00]]))
<https://bugs.chromium.org/p/chromium/issues/detail?id=747812>
[62] [CITE@en[Set request's reload-navigation flag for reloads]]
([[yutakahirano]]著, [TIME[2018-04-27 16:20:41 +09:00]])
<https://github.com/whatwg/html/commit/3072f1d71fc66c792412e1f5785f047f637545b9>
[66] [CITE@en[Introduce reload-navigation flag by yutakahirano · Pull Request #685 · whatwg/fetch]]
([TIME[2018-05-01 13:59:52 +09:00]])
<https://github.com/whatwg/fetch/pull/685>
[67] [CITE@en[Set request's reload-navigation flag when the navigation is reload-trigerred by yutakahirano · Pull Request #3592 · whatwg/html]]
([TIME[2018-05-01 14:01:37 +09:00]])
<https://github.com/whatwg/html/pull/3592>
[68] [CITE@en[Proposal: FetchEvent.navigationLoadType · Issue #1167 · w3c/ServiceWorker]]
([TIME[2018-05-01 14:02:04 +09:00]])
<https://github.com/w3c/ServiceWorker/issues/1167>
[69] [CITE@en[FetchEvent.prototype.isReload is no longer part of the specification by cdumez · Pull Request #8669 · w3c/web-platform-tests]]
([TIME[2018-05-01 14:07:00 +09:00]])
<https://github.com/w3c/web-platform-tests/pull/8669>
[70] [CITE@en[Editorial: move definition of "reload-navigation flag"]]
([[yutakahirano]]著, [TIME[2018-05-28 19:09:59 +09:00]])
<https://github.com/whatwg/fetch/commit/efe088f656a79af08d98d904e4c5550dc3edc403>
[71] [CITE@en[Move definition of reload-navigation flag · Issue #732 · whatwg/fetch]]
([TIME[2018-06-01 01:03:43 +09:00]])
<https://github.com/whatwg/fetch/issues/732>
[72] [CITE@en[Move definition of "reload-navigation flag" by yutakahirano · Pull Request #739 · whatwg/fetch]]
([TIME[2018-06-01 01:03:55 +09:00]])
<https://github.com/whatwg/fetch/pull/739>
[73] [CITE@en[document.open() can make a document's URL go out of sync with its history entry · Issue #3885 · whatwg/html]]
([TIME[2018-09-05 22:40:11 +09:00]])
<https://github.com/whatwg/html/issues/3885>
[74] [CITE@en[Remove overridden reload concept]]
([[TimothyGu]]著, [TIME[2018-08-18 05:31:49 +09:00]])
<https://github.com/whatwg/html/commit/6440ccae7340ea41d3eb5bf8ff0b3b27363eda85>
[18] [CITE@en[556002 - document.open() and write() after parsing is complete breaks reload button - we reload new, not original document]]
([TIME[2018-09-05 23:38:22 +09:00]])
<https://bugzilla.mozilla.org/show_bug.cgi?id=556002>
[19] [CITE@en[document.open() simplifications, part 2 by TimothyGu · Pull Request #3946 · whatwg/html]]
([TIME[2018-09-05 23:39:10 +09:00]])
<https://github.com/whatwg/html/pull/3946>