浏览器仅在用户主动导航且页面“脏”时才触发beforeunload弹窗;必须同步设置e.returnValue(不能异步)、标记isDirty状态(监听input/change等),SPA需用路由守卫或useBlocker手动拦截。

浏览器只在用户主动离开且页面“脏”时才允许弹出确认框,beforeunload 本身不能自定义文案、不能异步触发、也不能由 JS 主动调起——写对逻辑比写对语法难得多。
为什么 beforeunload 绑定后完全不弹窗
绝大多数失效不是因为代码写错,而是没满足浏览器的两个硬性前提:
- 页面必须处于“已变更”状态(即有未保存的用户输入),否则浏览器直接忽略事件
- 监听器中必须同步设置
e.returnValue或返回字符串,不能放在fetch().then()、setTimeout等异步回调里 - 在 Vue/React 中用
useEffect或mounted注册但没return cleanup,会导致重复绑定,部分浏览器静默拒收 -
history.pushState()或路由跳转(如router.push)不会触发该事件,它只响应用户主动导航行为(关标签、输新 URL、点链接、刷新)
如何正确标记“页面已变更”状态
靠监听所有 input、change、textarea、select 是基础,但容易漏掉动态插入的表单控件或富文本编辑器内容变化:
- 初始设
let isDirty = false,在表单首次加载后重置为false - 用事件委托监听
document上的input和change,避免漏掉后续 append 的元素 - 对
contenteditable元素,需额外监听input+blur,因为某些输入法下input不稳定 - 成功提交后,务必手动执行
isDirty = false;不要依赖响应式框架的 reactivity 自动清空——它可能滞后于事件触发时机
beforeunload 里的 e.preventDefault() 还要不要写
要写,但仅作兼容。现代浏览器(Chrome 60+、Firefox 80+、Edge 79+)已强制忽略自定义文案,统一显示“离开此页面?更改可能不会被保存。”:
-
e.preventDefault()在多数新版浏览器中仍是必需的,否则returnValue不生效 -
e.returnValue = 'xxx'必须存在,否则旧版 Safari 或 IE 可能不弹 - 不要在
beforeunload里做任何副作用操作(如发请求、改 DOM、调alert),浏览器会忽略或报错 - 该事件无法被取消阻止(
e.stopPropagation()无效),也无法捕获异常——出错就静默失败
SPA 路由跳转时怎么补上离开提示
单页应用中,beforeunload 对前端路由跳转(如 Vue Router 的 router.push、React Router 的 navigate)完全无感,必须手动拦截:
- Vue Router:在
beforeEach导航守卫里判断isDirty,若为真则next(false)并弹出自定义模态框(非confirm) - React Router v6.4+:用
useBlocker,传入isDirty作为条件,它会在路由变化前暂停并交由你决定是否放行 - 注意:此时不能再用原生
confirm,因为 SPA 跳转不触发beforeunload,且confirm会阻塞 JS 执行,导致路由卡死 - 推荐统一用轻量级自定义弹窗(如
div+position: fixed),避免阻塞渲染和焦点管理问题
真正麻烦的从来不是“怎么让它弹出来”,而是“怎么确保它只在该弹的时候弹、弹完就彻底消失、不残留 DOM、不干扰屏幕阅读器、也不在 SPA 跳转时失灵”。这些边界条件,才是线上环境里最常出问题的地方。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











