BeforeUnloadEvent：returnValue 属性

已弃用：此功能不再推荐。尽管一些浏览器可能仍然支持它，但它可能已被从相关的 Web 标准中删除，可能正在被删除，或者可能仅出于兼容性目的而保留。避免使用它，并尽可能更新现有代码；请参阅本页面底部的兼容性表格，以指导您的决策。请注意，此功能可能随时停止工作。

当BeforeUnloadEvent 接口的returnValue属性设置为真值时，会触发浏览器生成的确认对话框，询问用户在尝试关闭或重新加载页面或导航到其他位置时是否确实想要离开页面。这旨在帮助防止未保存数据的丢失。

注意：returnValue 是一个遗留功能，最佳实践是通过在 BeforeUnloadEvent 对象上调用Event.preventDefault() 来触发对话框，同时设置 returnValue 以支持遗留情况。请参阅beforeunload 事件参考以获取详细的最新指南。

值

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

将其设置为几乎任何真值都会在页面关闭/重新加载时触发对话框，但是请注意，它还需要粘性激活。换句话说，只有当框架或任何嵌入式框架收到用户手势或用户交互时，浏览器才会显示对话框。如果用户从未与页面交互过，则没有要保存的用户数据，因此对话框没有合法的用例。

注意：对话框中显示了一个通用的浏览器指定的字符串。网页代码无法控制它。

示例

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

规范

规范
HTML 标准 # dom-beforeunloadevent-returnvalue

浏览器兼容性

BCD 表格仅在启用了 JavaScript 的浏览器中加载。