セッション履歴エントリー (Web)

[2] セッション履歴エントリー (session history entry) は、セッション履歴中のエントリーです。

状態

[4] セッション履歴エントリーは、次のものから構成されます。

URL (必須) >>1: 資源の URL です。
状態オブジェクト (state object): 利用者インターフェイスの状態を表すオブジェクト >>1。
題名 (title): 文書のその時点での状態を説明するもの (利用者が履歴上で navigate するためのもの)。 >>1
Document オブジェクト >>1: 資源の文書です。
初期文書かどうか: 初期「about:blank」文書かどうかを表します。 navigate などの際に用いられます。
要求メソッドその他 navigate の引数: 本セッション履歴エントリーを作成した navigate の引数 (URL 以外)。 fetch の引数など、履歴の探索で再度 navigate するために使います。 replaceState/pushState で変更されることがあります。
始点閲覧文脈: 履歴の探索で使う始点閲覧文脈。
時刻: 作成時刻。結合セッション履歴におけるエントリーの整列に用いられます。
閲覧文脈: 本セッション履歴エントリーを持つセッション履歴を持つ閲覧文脈。
閲覧文脈名: 履歴の探索で読み書きされます。
フォームデータ >>1
スクロール復元モード >>1: スクロール位置を Webブラウザーが自動的に復元するべきか、スクリプトに委ねるべきかのモードです。
スクロール位置 >>1
その他: その他の情報も含められます >>1。

[20] セッション履歴エントリーの構成や、エントリー作成・変更時の値の詳細は、 HTML Standard では規定されておらず、ほぼ利用者エージェントに任されているようです。

[22] 履歴の探索や pushState では、セッション履歴エントリーを構成する各状態が更新されることがあります。 (セッション履歴エントリーの文書については次章を参照。)

[32] 次のような状態を保存するべきかもしれません。

[9] 利用者エージェント定義の状態を持つエントリーを持続的利用者状態付きエントリー (an entry with persisted user state) といいます >>1。利用者エージェント定義の状態には、フォームデータ、スクロール位置その他が含まれます >>1。

pushState も参照。

[37] セッション履歴エントリーエントリーからの持続的利用者状態の復元 (restore persisted user state) は、次のようにしなければなりません >>36。

[38] エントリーのスクロール復元モードが auto なら、
1. [39] 文書やスクロール可能領域 (子供閲覧文脈を除く。) のスクロール位置を復元して構いません。
[40] その他必要に応じて文書やレンダリングを更新して構いません。

[41] その他とは、フォーム制御子の値の復元や、テキスト入力系フォーム制御子の要素の dir 属性値の復元などを行えます >>36。

[25] 閲覧文脈は、文書を利用者に示す (present) ものです >>23。閲覧文脈は、セッション履歴を持ちます >>23。セッション履歴は、その閲覧文脈において過去、現在、未来に示される Document オブジェクトのリストです >>23, >>24。閲覧文脈は、その各文書に対して強い参照を持ちます >>21。

[27] ある時点においては、閲覧文脈にはいずれか1つの文書が示されており、これを活性文書といいます >>23。セッション履歴のうち、いずれか1つが現在エントリーとなります。履歴の探索の途中の (スクリプトからは観測できない) 状態を除き、現在エントリーの文書が活性文書です。

[26] 厳密にはセッション履歴はセッション履歴エントリーのリストです。セッション履歴エントリーは文書を保持していますが、それ以外の情報も保持しています。複数のセッション履歴エントリーの文書が同じ文書である場合もあります >>1。

[12] 同じ文書となることがあるのは、隣接するセッション履歴エントリーのみです >>1。

[16] 同じ URL であってもセッション履歴エントリーの文書が同じとは限りません。また異なるセッション履歴に属するエントリーの文書は同じにはなりません。

[18] 利用者エージェントは、ページごとに追加できる状態オブジェクト数に上限を設けて構いません >>1。つまり同じ文書を保持するセッション履歴エントリーの個数に上限を設けることができます。上限に達したら、状態オブジェクトを持つ最古のもの (= 同じ文書を持つ、索引の小さい方から2番目のもの) から削除していきます。

pushState を参照。