History: state プロパティ

Baseline 広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年7月以降、すべてのブラウザーで利用可能です。

state は History インターフェイスの読み取り専用プロパティで、履歴スタックの一番上の状態を表す値を返します。これは popstate イベントを待つことなく、状態を見ることができる方法です。

値

履歴スタックの一番上の状態です。この値は pushState() または replaceState() メソッドが使用されていない限り null です。

例

以下のコードでは、 history.state の値を pushState() メソッドを使用して値を履歴にプッシュする前に、ログに記録しています。次の行では、再びコンソールに値が記録され、 history.state に値があることが分かります。

// まだ履歴スタックを変更していないため、 null になります
console.log("History.state before pushState: ", history.state);

// スタックに何かプッシュします
history.pushState({ name: "Example" }, "pushState example", "page3.html");

// 状態は値になりました。
console.log("History.state after pushState: ", history.state);