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

Window:load 事件

· 52CE 我爱测

**`load`** 事件在整个页面及所有依赖资源如样式表和图片都已完成加载时触发。它与 Document/DOMContentLoaded_event 不同,后者只要页面 DOM 加载完成就触发,无需等待依赖资源的加载。

load 事件在整个页面及所有依赖资源如样式表和图片都已完成加载时触发。它与 Document/DOMContentLoaded_event 不同,后者只要页面 DOM 加载完成就触发,无需等待依赖资源的加载。

该事件不可取消,也不会冒泡。

[!NOTE] 所有以 load 命名的事件都不会传递到 Window 上,即使 bubbles 初始化为 true。要在 window 上捕获 load 事件,相关的 load 事件必须直接绑定到 window 上。

[!NOTE] 当主文档加载完成时,load 事件将在 window 上触发,但其有两个被修改的属性:target 为 document,以及 path 为 undefined。这是由遗留的一致性问题导致的。

语法

在如 EventTarget.addEventListener 等方法中使用事件名称,或设置事件处理器属性。

addEventListener("load", (event) => {});

onload = (event) => {};

事件类型

一个通用的 Event。

示例

当页面完全加载后在控制台打印一段信息:

window.addEventListener("load", (event) => {
  console.log("page is fully loaded");
});

也可以使用 onload 事件处理器属性实现:

window.onload = (event) => {
  console.log("page is fully loaded");
};

交互示例

HTML

<div class="controls">
  <button id="reload" type="button">Reload</button>
</div>

<div class="event-log">
  <label for="eventLog">Event log:</label>
  <textarea
    readonly
    class="event-log-contents"
    rows="8"
    cols="30"
    id="eventLog"></textarea>
</div>
body {
  display: grid;
  grid-template-areas: "control log";
}

.controls {
  grid-area: control;
  display: flex;
  align-items: center;
  justify-content: center;
}

.event-log {
  grid-area: log;
}

.event-log-contents {
  resize: none;
}

label,
button {
  display: block;
}

#reload {
  height: 2rem;
}

JavaScript

const log = document.querySelector(".event-log-contents");
const reload = document.querySelector("#reload");

reload.addEventListener("click", () => {
  log.textContent = "";
  setTimeout(() => {
    window.location.reload(true);
  }, 200);
});

window.addEventListener("load", (event) => {
  log.textContent += "load\n";
});

document.addEventListener("readystatechange", (event) => {
  log.textContent += `readystate: ${document.readyState}\n`;
});

document.addEventListener("DOMContentLoaded", (event) => {
  log.textContent += `DOMContentLoaded\n`;
});

结果

交互示例

规范

浏览器兼容性

参见

  • Document readyState API
  • 相关事件
    • Document/DOMContentLoaded_event
    • Document/readystatechange_event
    • Window/beforeunload_event
    • Window/unload_event

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

资料来源与适用范围

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

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

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