大网数据广告活动
Web 标准与前端开发

History

· 52CE 我爱测

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

HTML DOM

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

属性

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

  • History.length
    • : 返回一个整数(Integer),该整数表示会话历史中元素的数目,包括当前加载的页。例如,在一个新的选项卡加载的一个页面中,这个属性返回 1。
  • History.scrollRestoration
    • : 允许 Web 应用程序在历史导航上显式地设置默认滚动恢复行为。此属性可以是自动的(auto)或者手动的(manual)。
  • History.state
    • : 返回一个表示历史堆栈顶部的状态的任意(any)值。这是一种不必等待 Window/popstate_event 事件而查看状态的方式。

方法

History 接口不继承任何方法。

  • History.back()

    • : 此异步方法转到浏览器会话历史的上一页,与用户单击浏览器的 <kbd>Back</kbd> 按钮的行为相同。等价于 history.go(-1)。

      调用此方法回到会话历史的第一页之前没有效果并且不会引发异常。

  • History.forward()

    • : 此异步方法转到浏览器会话历史的下一页,与用户单击浏览器的 <kbd>Forward</kbd> 按钮的行为相同。等价于 history.go(1)。

      调用此方法超越浏览器历史记录中最新的页面没有效果并且不会引发异常。

  • History.go()

    • : 通过当前页面的相对位置从浏览器历史记录(会话记录)异步加载页面。比如:参数为 -1 的时候为上一页,参数为 1 的时候为下一页。当你指定了一个越界值(例如:当会话历史记录中没有之前访问的页面时,则传参的值为 -1,那么这个方法没有任何效果也不会报错。调用没有参数的 go() 方法或者参数值为 0 时,重新载入当前页面。Internet Explorer 允许你指定一个字符串,而不是整数,以转到历史记录列表中的特定 URL。
  • History.pushState()

    • : 按指定的名称和 URL(如果提供该参数)将数据 push 进会话历史栈,数据被 DOM 进行不透明处理;你可以指定任何可以被序列化的 javascript 对象。请注意,除了 Safari 所有浏览器现在都忽略了 title 参数。更多的信息,请看使用 History API。
  • History.replaceState()

    • : 按指定的数据、名称和 URL(如果提供该参数),更新 history 栈上最新的条目。这个数据被 DOM 进行了不透明处理。你可以指定任何可以被序列化的 javascript 对象。请注意,除了 Safari 所有浏览器现在都忽略了 title 参数。更多的信息,请看使用 History API。

规范

浏览器兼容性

参见

  • Window.history 返回当前会话的 history 状态

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。