0

0

如何使用javascript操作浏览器历史_history API有哪些方法?

幻影之瞳

幻影之瞳

发布时间:2025-12-25 20:31:02

|

782人浏览过

|

来源于php中文网

原创

JavaScript History API通过pushState、replaceState和popstate实现SPA路由控制:pushState添加历史记录并更新URL,replaceState替换当前记录,popstate监听前进后退事件以响应状态变化。

如何使用javascript操作浏览器历史_history api有哪些方法?

JavaScript 的 History API 允许你在不刷新页面的前提下,操作浏览器的会话历史(session history),实现单页应用(SPA)中的路由跳转、前进后退控制和 URL 状态管理。核心是 window.history 对象,它不是只读的,可以安全地增删改当前会话的历史记录。

pushState():添加新历史记录

向历史中**追加一条新记录**,改变 URL(可选),但不触发页面刷新或重新加载。

  • 语法:history.pushState(state, title, url)
  • state:一个可被序列化的对象,随该历史项一起保存,后续通过 popstate 事件可读取(例如:{page: 'detail', id: 123}
  • title:目前大多数浏览器忽略该参数,传空字符串 '' 即可
  • url:新的相对路径(如 '/post/456')或绝对路径;必须同源,否则报错

示例:history.pushState({type: 'article', id: 789}, '', '/article/789'); —— 地址栏变为 /article/789,历史栈多了一条记录。

replaceState():替换当前历史记录

用新状态**覆盖当前历史项**,URL 改变但不新增历史条目,用户点击「后退」不会回到上一个状态。

立即学习Java免费学习笔记(深入)”;

  • 语法与 pushState 完全一致:history.replaceState(state, title, url)
  • 常用于更新 URL 参数而不留痕(比如筛选条件变化、滚动位置保存)

示例:history.replaceState({sort: 'date'}, '', '?sort=date&limit=20'); —— 当前地址栏更新,但后退键仍指向更早的页面。

popstate 事件:监听前进/后退操作

当用户点击浏览器「前进」「后退」按钮,或调用 history.back()/history.forward() 时触发,**仅在历史记录切换且 state 非 null 时触发**。

  • 监听方式:window.addEventListener('popstate', (e) => { console.log(e.state); });
  • e.state 是 push/replace 时传入的 state 对象(可能为 null
  • 注意:直接调用 pushStatereplaceState 不会触发 popstate

这是实现 SPA 路由响应的核心机制——根据 e.state 或当前 location.pathname 渲染对应内容。

其他实用方法和属性

  • history.length:当前会话历史总条数(包含当前页),只读
  • history.state:当前历史项的 state 值(即最近一次 push/replace 设置的,或初始页面的 null)
  • history.back() / history.forward() / history.go(n):模拟用户导航行为(go(-1) 等价于 back()

⚠️ 注意:所有 History API 操作都受同源策略限制;跨域 URL 会抛出安全错误。

基本上就这些。掌握 pushStatereplaceStatepopstate 就能构建完整的前端路由逻辑,无需依赖服务端跳转。实际使用中建议封装统一的路由函数,并配合 location 解析做兜底,避免状态丢失。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

254

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

1089

2024.03.01

sort排序函数用法
sort排序函数用法

sort排序函数的用法:1、对列表进行排序,默认情况下,sort函数按升序排序,因此最终输出的结果是按从小到大的顺序排列的;2、对元组进行排序,默认情况下,sort函数按元素的大小进行排序,因此最终输出的结果是按从小到大的顺序排列的;3、对字典进行排序,由于字典是无序的,因此排序后的结果仍然是原来的字典,使用一个lambda表达式作为key参数的值,用于指定排序的依据。

409

2023.09.04

session失效的原因
session失效的原因

session失效的原因有会话超时、会话数量限制、会话完整性检查、服务器重启、浏览器或设备问题等等。详细介绍:1、会话超时:服务器为Session设置了一个默认的超时时间,当用户在一段时间内没有与服务器交互时,Session将自动失效;2、会话数量限制:服务器为每个用户的Session数量设置了一个限制,当用户创建的Session数量超过这个限制时,最新的会覆盖最早的等等。

336

2023.10.17

session失效解决方法
session失效解决方法

session失效通常是由于 session 的生存时间过期或者服务器关闭导致的。其解决办法:1、延长session的生存时间;2、使用持久化存储;3、使用cookie;4、异步更新session;5、使用会话管理中间件。

776

2023.10.18

cookie与session的区别
cookie与session的区别

本专题整合了cookie与session的区别和使用方法等相关内容,阅读专题下面的文章了解更详细的内容。

97

2025.08.19

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

761

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

221

2023.09.04

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

26

2026.03.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
React 教程
React 教程

共58课时 | 6万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 3.4万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 3.6万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号