history

History 接口允许操作浏览器的曾经在标签页或者框架里访问的会话历史记录。

属性

History 接口不继承于任何属性。

History.length （只读）

返回一个整数，该整数表示会话历史中元素的数目，包括当前加载的页。例如，在一个新的选项卡加载的一个页面中，这个属性返回1。

History.scrollRestoration

允许web应用程序在历史导航上显示的设置默认滚动恢复行为。此属性可以是自动或者手动的。

History.state （只读）

返回一个表示历史堆栈顶部的状态的值。这是一种可以不必等待 popstate 事件而查看状态的方式。

方法

History 接口不继承任何方法。

History.back()

在浏览器历史记录里前往上一页，用户可点击浏览器左上角的返回，等价于 history.go(-1)

当浏览器会话历史记录处于第一页时调用此方法没有效果，而且也不会报错。

History.forward()

在浏览器历史记录里前往下一页，用户可点击浏览器左上角的前进，等价于 history.go(1)

当浏览器历史栈处于最顶端时( 当前页面处于最后一页时 )调用此方法没有效果也不报错。

History.go()

通过当前页面的相对位置从浏览器历史记录加载页面，参数为-1的时候为上一页，参数为1的时候为下一页。如果当前页为第一页，前面已经没有页面了，传参的值为-1，那么这个方法没有任何效果也不会报错。调用没有参数的 go() 方法或者不是整数的参数时也没有效果。

History.pushState()

按指定的名称和URL将数据push进会话历史栈，数据对DOM进行不透明处理，可以指定任何可以被序列化的JavaScript对象。

History.replaceState()

按指定的数据名称和URL更新历史栈上的最新入口。这个数据被DOM进行了不透明处理。可以指定任何可以被序列化的JavaScript对象。