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

BeforeUnloadEvent:returnValue 属性

· 52CE 我爱测

BeforeUnloadEvent 接口的 **`returnValue`** 属性,当设置为真值时,会触发浏览器生成的确认对话框,提示用户在尝试关闭或重新加载页面或者导航到其他地方时,是否确实要离开该页面。此功能旨在避免未保存数据的丢失。

HTML DOM

BeforeUnloadEvent 接口的 returnValue 属性,当设置为真值时,会触发浏览器生成的确认对话框,提示用户在尝试关闭或重新加载页面或者导航到其他地方时,是否确实要离开该页面。此功能旨在避免未保存数据的丢失。

[!NOTE] returnValue 是一项遗留功能,最佳实践是通过调用 Event.preventDefault() 方法来触发对话框,同时设置 returnValue 以支持旧版情况。有关详细更新指南,请参阅 Window/beforeunload_event 事件参考。

值

returnValue 初始化为空字符串("")。

将其设置为任何接近真值的值都会导致在页面关闭或重新加载时触发对话框,但请注意,这还需要粘性激活。换句话说,只有当框架或任何嵌入式框架接收到用户手势或用户交互时,浏览器才会显示该对话框。如果用户从未与页面交互过,则不存在需要保存的用户数据,因此没有合理的使用场景需要显示该对话框。

[!NOTE] 对话框中显示的是浏览器指定的通用字符串。网页代码无法对其进行控制。

示例

参见 Window/beforeunload_event 事件参考页面以获取最佳实践示例。

规范

浏览器兼容性

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

资料来源与适用范围

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

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

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