popstate

直列化済み状態

[16] 直列化済み状態 (serialized state) (旧状態オブジェクト (state object) ) は、利用者インターフェイスの状態を表すオブジェクトです >>15。

[17] 状態オブジェクトは、セッション履歴エントリー中に設定されることがあります。

[18] 著者は pushState や replaceState により状態オブジェクトを指定できます。

[19] 著者は popstate イベントにより状態オブジェクトを受け取ることができます。

`history.state` 属性 (DOM)

[22] History インターフェイスの state IDL属性の取得器は、次のようにしなければなりません >>21。

[25] 文脈オブジェクトの文書の完全に活性が偽なら、
1. [23] SecurityError 例外を投げ、ここで停止します。
[26] 文脈オブジェクトの state を返します。

[24] History オブジェクトは、 state を持ちます。初期値は null です >>21。

[27] 履歴の探索と pushState/replaceState で値が設定されます。

`pushState` メソッド、`replaceState` メソッド

[29] History インターフェイスの pushState メソッドと replaceState メソッドは、次のようにしなければなりません >>28。

[57] データを、第1引数を必須の any として解釈した結果に設定します。
[58] 題名を、第2引数を必須の USVString として解釈した結果に設定します。
[59] URL を、第3引数を省略可能な DOMString? として解釈した結果に設定します。省略時の既定値は、 null とします。
[60] 文書を、文脈オブジェクトの文書に設定します。
[83] 文書が完全に活性でなければ、
1. [61] SecurityError 例外を投げ、ここで停止します。
[62] 利用者エージェントの判断で、ここで停止して構いません。
[63] 利用者動作によって起動された場合以外の時や、短時間で連続して実行された時、 データが巨大すぎる場合などに、本メソッド呼び出しを無視できます。
[64] 直列化済みデータを、 StructuredSerializeForStorage (データ, 文脈オブジェクトのRealm) の結果に設定します。例外が投げられたら、それを再度投げ、ここで停止します。
[70] 現在のURLを、文脈オブジェクトの文書のURLに設定します。
[65] URL が null 以外なら、
1. [67] 新URL を、URLを文書に対して構文解析した結果に設定します。
2. [66]
  - [68] 新URLが失敗
  - [50] 新URLのURL記録と現在のURLを比較した時、 path、query、素片を除く部品が異なる
  - [69] 新URLの起源と文書の起源が同じ起源ではない場合で、 新URLのURL記録と現在のURLを比較した時、 pathとqueryの一方または両方が異なる
  ... のいずれかの場合、
  1. [71] SecurityError 例外を投げ、ここで停止します。
[51] それ以外の場合、
1. [52] 新URLを、文書の閲覧文脈のセッション履歴の現在エントリーの URL に設定します。
[37] URLおよび履歴更新手順群を実行します。
文書
文書
新URL
新URL
直列化済みデータ
直列化済みデータ
題名
題名
状態pushフラグ
本メソッドは pushState であるか否か
[78] 文脈オブジェクトの state を、 StructuredDeserialize (直列化済みデータ, 文脈オブジェクトのRealm) の結果に設定します。例外が投げられたら、文脈オブジェクトの state を、 null に設定します。
[79] 現在エントリーの文書の最新エントリーは、現在エントリーとします。
[80] 現在のURLと新しいURLが異なるなら、
1. [81] webNavigation API の onHistoryStateUpdated を呼び出します。 遷移型と遷移修飾子群は適宜設定します。現在時刻も引き渡します。仕様書なし

[53] >>50 が同じ起源かどうかの判断ではないので、 userinfo の有無や値も (あれば) 判定基準となります。

[30] 両メソッドは文書の番地を変更することができるものですが、文書の起源や実効スクリプト起源や文書のドメインを変更することはできません。この意味で同一起源ポリシーを緩和するものではありません。更に、 document.domain を使っても変更可能な範囲を拡大することはできません。

[31] 文書の起源ではなく文書の番地の起源が問題となりますから、文書の起源と同じ起源であっても about:blank や data: URL が文書の番地となっている時、 http: や https: の URL に変更することはできません。この意味で同一起源ポリシーより制限が厳しいと言うこともできますが、両メソッドの趣旨が文書の番地を変更するものですから、当然の制約でもあります。

[32] 砂箱によって異なる起源で動作するスクリプトは素片識別子以外を変更することもできません。