PopStateEvent | Web API

在此页

句法
popstate 事件
规范
浏览器兼容性
另请参阅
相关话题

PopStateEvent is an event handler for the popstate event on the window.

A popstate event is dispatched to the window every time the active history entry changes between two history entries for the same document. If the history entry being activated was created by a call to history.pushState() or was affected by a call to history.replaceState() ， popstate event's state property contains a copy of the history entry's state object.

注意 : Just calling history.pushState() or history.replaceState() won't trigger a popstate event. The popstate event is only triggered by doing a browser action such as a clicking on the back button (or calling history.back() in JavaScript). And the event is only triggered when the user navigates between two history entries for the same document.

注意 : Browsers used to handle the popstate event differently on page load, but now they behave the same. Firefox never emitted a popstate event on page load. Chrome did until version 34, while Safari did until version 10.0.

句法

window.onpopstate = funcRef;

funcRef 是处理程序函数。

popstate 事件

As an example, a page at http://example.com/example.html running the following code will generate alerts as indicated:

window.onpopstate = function(event) {
  alert("location: " + document.location + ", state: " + JSON.stringify(event.state));
};
history.pushState({page: 1}, "title 1", "?page=1");
history.pushState({page: 2}, "title 2", "?page=2");
history.replaceState({page: 3}, "title 3", "?page=3");
history.back(); // alerts "location: http://example.com/example.html?page=1, state: {"page":1}"
history.back(); // alerts "location: http://example.com/example.html, state: null
history.go(2);  // alerts "location: http://example.com/example.html?page=3, state: {"page":3}

Note that even though the original history entry (for http://example.com/example.html ) has no state object associated with it, a popstate event is still fired when we activate that entry after the second call to history.back() .

规范

规范	状态	注释
HTML 实时标准 The definition of 'PopStateEvent' in that specification.	实时标准	初始定义

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`PopStateEvent`	Chrome 4	Edge ≤18	Firefox 4	IE ?	Opera Yes	Safari Yes	WebView Android Yes	Chrome Android 18	Firefox Android 4	Opera Android Yes	Safari iOS Yes	Samsung Internet Android 1.0
`state`	Chrome 4	Edge 12	Firefox 4	IE ?	Opera Yes	Safari Yes	WebView Android Yes	Chrome Android 18	Firefox Android 4	Opera Android Yes	Safari iOS Yes	Samsung Internet Android 1.0

在此页

句法

popstate 事件

规范

浏览器兼容性

图例

另请参阅

元数据

相关话题