讲师中心 微信公众号
AI工具推荐 视频效率加速

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

星涛大大_3041

星涛大大_3041

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

|

803人浏览过

|

来源于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免费学习笔记(深入)”;

Java Maven Code Review
Java Maven Code Review

审查Java Maven项目(ZIP压缩包或GitLab仓库URL),检查代码规范、命名、模块边界、可维护性问题以及重复代码。

下载
  • 语法与 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)
  • 注意:直接调用 pushState 或 replaceState 不会触发 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 会抛出安全错误。

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

热门AI工具

更多
AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

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

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

529

2023.09.22

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

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

1658

2024.03.01

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

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

1118

2023.09.04

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

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

580

2023.10.17

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

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

876

2023.10.18

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

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

1826

2025.08.19

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

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

1598

2023.08.03

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

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

2364

2023.09.04

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

20

2026.09.30

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WebStorm 官方调试文档
WebStorm 官方调试文档

共0课时 | 0人学习

React 教程
React 教程

共58课时 | 12万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 6.6万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn