onbeforeunload 事件

定义和用法

onbeforeunload 事件在文档即将被卸载时发生。

此事件允许您在确认对话框中显示一条消息,通知用户是要停留还是离开当前页面。

出现在确认框中的默认消息,在不同的浏览器中是不同的。但是,标准消息类似于“您确定要离开此页面吗?”。此消息无法删除。

但是,您可以将自定义消息与默认消息一起编写。请参阅此页面上的第一个例子。注释:只适用于 Internet Explorer。

注释:如果 onbeforeunload 事件没有分配给 <body> 元素,则必须将该事件分配/附加到 window 对象上,并使用 returnValue 属性创建自定义消息(请参见下面的语法示例)。

实例

在页面即将卸载时执行 JavaScript:

<body onbeforeunload="return myFunction()">

亲自试一试

语法

在 HTML 中:

<element onbeforeunload="myScript">

亲自试一试

在 JavaScript 中:

object.onbeforeunload = function(){myScript};

亲自试一试

在 JavaScript 中,使用 addEventListener() 方法:

object.addEventListener("beforeunload", myScript);

亲自试一试

注释:Internet Explorer 8 或更早的版本不支持 addEventListener() 方法

技术细节

冒泡: 不支持
可取消: 支持
事件类型: 如果从用户界面生成,UiEvent。否则 Event
支持的 HTML 标签: <body>
DOM 版本: Level 2 Events

浏览器支持

表中的数字注明了完全支持该事件的首个浏览器版本。

事件 Chrome IE Firefox Safari Opera
onbeforeunload 支持 支持 支持 支持 15.0