This page was translated from English by the community. Learn more and join the MDN Web Docs community.

unload

当文档或一个子资源正在被卸载时, 触发 unload事件。

可冒泡（Bubbles） No
可取消（Cancelable） No
接口（Interface） Event
事件处理程序属性（Event handler property） onunload

它在下面两个事件后被触发:

  1. beforeunload (可取消默认行为的事件)
  2. pagehide

文档处于以下状态：

  • 所有资源仍存在 (图片, iframe 等.)
  • 对于终端用户所有资源均不可见
  • 界面交互无效 (window.open, alert, confirm 等.)
  • 错误不会停止卸载文档的过程

请注意unload事件也遵循文档树:父iframe会在子iframe卸载前卸载(参考下面的例子).

示例

<!DOCTYPE html>
<html>
  <head>
    <title>Parent Frame</title>
    <script>
      window.addEventListener('beforeunload', function(event) {
        console.log('I am the 1st one.');
      });
      window.addEventListener('unload', function(event) {
        console.log('I am the 3rd one.');
      });
    </script>
  </head>
  <body>
    <iframe src="child-frame.html"></iframe>
  </body>
</html>

下面是 child-frame.html的内容:

<!DOCTYPE html>
<html>
  <head>
    <title>Child Frame</title>
    <script>
      window.addEventListener('beforeunload', function(event) {
        console.log('I am the 2nd one.');
      });
      window.addEventListener('unload', function(event) {
        console.log('I am the 4th and last one…');
      });
    </script>
  </head>
  <body>
      ☻
  </body>
</html>

当父iframe被卸载，事件将按console.log() 消息描述的顺序触发。

规范

规范 状态 描述
UI Events
unload		 Working Draft

浏览器兼容性

BCD tables only load in the browser

参见