此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

BeforeUnloadEvent:returnValue 属性

已弃用: 不再推荐使用该特性。虽然一些浏览器仍然支持它,但也许已从相关的 web 标准中移除,也许正准备移除或出于兼容性而保留。请尽量不要使用该特性,并更新现有的代码;参见本页面底部的兼容性表格以指导你作出决定。请注意,该特性随时可能无法正常工作。

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

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

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

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

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

示例

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

规范

Specification
HTML
# dom-beforeunloadevent-returnvalue

浏览器兼容性