监听浏览器后退行为需通过popstate事件、路由守卫或平台专属生命周期间接实现:Web端用popstate监听历史栈变化;Vue Router推荐beforeRouteLeave守卫;uniapp用onBackPress;小程序可用page-container全链路拦截。

监听浏览器后退行为,本质是识别“用户意图离开当前页面”这一动作,而不是直接捕获“后退按钮被按下”。因为现代浏览器(包括移动端 WebView、微信小程序内嵌页、uniapp H5 等)没有原生的 backbutton 事件,必须通过历史栈变化或平台专属生命周期来间接感知。
用 popstate 监听历史栈变化(Web/H5 通用方案)
这是最基础、兼容性最好的 Web 层方案。当用户点击后退/前进按钮、调用 history.back() 或手势返回时,浏览器会触发 popstate 事件。
- 它只响应由
pushState或replaceState写入的历史记录变化,普通 URL 跳转不会触发 - 需在路由就绪后注册监听,避免重复绑定(建议在根组件
mounted或onLoad中添加,unmounted或onUnload中移除) - 通过
event.state可携带自定义标记(如{ from: 'payment' }),用于区分后退来源 - 注意:Vue Router / React Router 等已内部监听 popstate,若额外监听,需避免逻辑冲突——推荐优先使用框架守卫,仅在需要精细控制(如阻止跳转并 push 回当前页)时才手动干预
用 beforeRouteLeave 守卫判断导航方向(Vue Router 推荐)
组件级守卫能更语义化地响应“即将离开”,适合表单页、支付页等需确认的场景。
- 它不区分后退/前进/编程式跳转,但可通过
from和to的路径、name 或 meta 字段推断意图(例如from.path === '/form' && to.path === '/'很可能为后退) - 结合
history.state或路由state参数(router.push({ path: '/next', state: { step: 2 } }))可增强判断可靠性 - 调用
next(false)可取消导航;next('/save-draft')可重定向;next()则放行 - ⚠️ 注意:它无法拦截原生物理返回键的默认行为(如安卓返回键),仅对路由系统内的导航生效
uniapp / 小程序专用:onBackPress 生命周期(移动端首选)
这是 uniapp 提供的平台级返回事件钩子,覆盖 Android 物理键、iOS 侧滑、导航栏返回按钮三大入口,真正实现“一次编码,全端生效”。
-
options.from明确返回来源:'backbutton'(物理键)、'navigateBack'(API 调用)、'navigationBar'(左上角按钮) - 函数返回
true即阻止默认行为,之后可自由弹窗、保存、跳转;返回false或无返回值则按原逻辑退出 - 实战建议:在表单页中检查
this.isDirty,调用uni.showModal确认;在引导流程第二步,直接uni.navigateTo({ url: '/step1' })而非后退 - 兼容兜底:对不支持
onBackPress的环境(如部分旧版小程序),可用onUnload+uni.setStorageSync记录状态,在上一页onShow中恢复或提示
微信小程序进阶:page-container 全链路拦截
针对 iOS 侧滑返回、安卓物理键、导航栏按钮三者无法统一控制的痛点,page-container 提供容器级拦截能力。
- 将页面内容包裹在
内,所有退出操作都会先触发onClose事件,而非直接卸载页面 - 在
onClose中可同步执行数据保存、弹窗确认、甚至阻止关闭(e.detail.cancel = true) - 配合自定义导航栏使用效果更佳,彻底摆脱“返回键不可控”的被动局面
- 注意:需基础库 2.28.0+,且仅限小程序平台,H5 不适用











