[23] Location インターフェイス の
replaceメソッド は、置換有効 で navigate
することを指示するものです。 同じく assignメソッド は、原則として置換有効 とせずに navigate
することを指示するものです。
仕様書 [19] HTML Standard (2016-03-14 22:44:13 +09:00 版) https://html.spec.whatwg.org/#location [1] HTML Standard (2015-04-25 04:40:19 +09:00 版) https://html.spec.whatwg.org/#dom-location-assign [7] HTML Standard (2015-04-25 04:40:19 +09:00 版) https://html.spec.whatwg.org/#dom-location-replace 性質 [28] assign メソッド も replace
メソッド も、 Unforgeable です >>1 , >>7
メソッドの処理 [24] assign メソッド は、次のようにしなければなりません
>>1 [29] URL を、第1引数を USVString として解釈した結果に設定します。[25] 文脈オブジェクト の関係するDocument 起源文書の起源 と入口設定群オブジェクト の起源 が同じ起源ドメイン でなければ、[26] SecurityError 例外 を投げ 、ここで停止します。[27] 結果 を、入口設定群オブジェクト に対して URL
をURLの構文解析 した結果に設定します。[31] 結果 が失敗 なら、[32] SyntaxError 例外 を投げ てここで停止します。[30] 文脈オブジェクト と 結果 のURL記録 について
Location-object navigate
[9] replace メソッド は、次のようにしなければなりません
>>7 [2] URL を、第1引数を USVString として解釈した結果に設定します。[3] 結果 を、入口設定群オブジェクト に対して URL
をURLの構文解析 した結果に設定します。[4] 結果 が失敗 なら、[5] SyntaxError 例外 を投げ てここで停止します。[6] 文脈オブジェクト と 結果 のURL記録 について
Location-object navigate置換有効
[8] location.assign とは違って location.replace
では起源 の検査は行われません。つまり他の任意のフレーム から呼び出すことができます。navigate 処理 [10] Location オブジェクト のメソッド
replace, assign を実行したり、
各URL分解属性 の設定器 に値を設定したりすると、 navigate
が発生します。これらは、 URL を組み立てた後、本項のような処理を実行します。
[11] location.reload も navigate を発生させますが、
処理は少し違っています。[12] 仕様書 上の手順である
Location-object navigateLocation-object-setter navigateLocation オブジェクト オブジェクト と
URL記録 URL について、
次のように navigate することをいいます >>19
navigate する閲覧文脈 閲覧文脈 。新しい資源 URL 。原始閲覧文脈 現職設定群オブジェクト の有責閲覧文脈 。置換有効 >>13 [38] ただし例外 が投げ られたら、再度投げ ます >>19
[22] ここでいう閲覧文脈 は、オブジェクト の文書 の閲覧文脈 と思われますが、
明記されていません。[13] ここで、置換有効 >>19 [15] location.replace真 [34] location.assign[33] 閲覧文脈 のセッション履歴 が初期about:blank文書 のみなら、
真 。[14] それ以外なら、偽 。[35] その他[21] 閲覧文脈 のセッション履歴 が初期about:blank文書 のみなら、
真 。[20] それ以外で、オブジェクト の関係するDocument completely loaded なら、偽 。[36] それ以外で、現在走っているタスク が信用済みクリック なら、偽 。[37] それ以外なら、真 。
歴史 [16] Clarify the error handling for Location#{assign,replace} · whatwg/html@9cbe9b3
(2015-08-30 09:55:05 +09:00 版)
https://github.com/whatwg/html/commit/9cbe9b33bd969ad0590370ad97a3e282226dfd9c
[17] Define security around Window, WindowProxy, and Location properly · whatwg/html@acae3df
(2016-03-13 23:39:57 +09:00 版)
https://github.com/whatwg/html/commit/acae3df652b382e9f4f1d1b4dc7e08e2b00df821
[18] Merge effective script origin into origin · whatwg/html@8a843f2
(2016-03-31 18:13:20 +09:00 版)
https://github.com/whatwg/html/commit/8a843f2169a6864a3024c4329528dccb2051d275
[39] Editorial: turn "exceptions enabled" into a flag
( (annevk 著, 2016-05-02 16:13:36 +09:00 ))
https://github.com/whatwg/html/commit/879edbfcb25586caec8df93f303a434a700a18bc
[40] Bug 158061 – location.href and location.assign() differ in Referer
( (2016-05-26 09:55:09 +09:00 ))
https://bugs.webkit.org/show_bug.cgi?id=158061
[41] 17041 – Setting location before the page is done loading shouldn't always be a replace load
( (2016-08-26 14:02:50 +09:00 ))
https://www.w3.org/Bugs/Public/show_bug.cgi?id=17041