History 接口允许操作浏览器的曾经在标签页或者框架里访问的会话历史记录。
属性
History.length
返回一个整数,该整数表示会话历史中元素的数目,包括当前加载的页。例如,在一个新的选项卡加载的一个页面中,这个属性返回1。
History.state
返回一个表示历史堆栈顶部的状态的值。这是一种可以不必等待popstate 事件而查看状态而的方式。
方法
History.back()
前往上一页, 用户可点击浏览器左上角的返回按钮模拟此方法. 等价于 history.go(-1)
.
ps: 当浏览器会话历史记录处于第一页时调用此方法没有效果,而且也不会报错。
History.forward()
在浏览器历史记录里前往下一页,用户可点击浏览器左上角的前进按钮模拟此方法. 等价于 history.go(1)
.
ps: 当浏览器历史栈处于最顶端时( 当前页面处于最后一页时 )调用此方法没有效果也不报错。
History.go()
通过当前页面的相对位置从浏览器历史记录( 会话记录 )加载页面。比如:参数为-1的时候为上一页,参数为1的时候为下一页。
History.pushState(state,title,url)
//state:一个与指定历史记录相关联的状态对象,当popstate事件触发时,会把该对象传入回调函数。可以为null。
//title:页面的标题。但当前大多数浏览器都不支持或忽略这个值。可以为null。
//url:添加或修改的history的网址。为了安全性,必须保持与当前URL同一个域。
按指定的名称和URL(如果提供该参数)将数据push进会话历史栈,数据被DOM进行不透明处理;你可以指定任何可以被序列化的javascript对象。
History.replaceState(state,title,url)
按指定的数据,名称和URL(如果提供该参数),更新历史栈上最新的入口。这个数据被DOM 进行了不透明处理。你可以指定任何可以被序列化的javascript对象。