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

Document:DOMContentLoaded 事件

· 52CE 我爱测

当 HTML 文档完全解析,且所有延迟脚本(`<script defer src="…">` 和 `<script type="module">`)下载和执行完毕后,会触发 **`DOMContentLoaded`** 事件。它不会等待图片、子框架和异步脚本等其他内容完成加载。

当 HTML 文档完全解析,且所有延迟脚本(<script defer src="…"> 和 <script type="module">)下载和执行完毕后,会触发 DOMContentLoaded 事件。它不会等待图片、子框架和异步脚本等其他内容完成加载。

DOMContentLoaded 不会等待样式表加载,但延迟脚本会等待样式表,而且 DOMContentLoaded 事件排在延迟脚本之后。此外,非延迟或异步的脚本(如 <script>)将等待已解析的样式表加载。

另一个事件——Window/load_event——只能用于检测完全加载的页面。有一个常见的错误就是在 DOMContentLoaded 事件更合适时使用了 load 事件。

这个事件不可取消。

语法

在类似于 EventTarget.addEventListener 这样的方法中使用事件名称,或设置事件处理器属性。

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

onDOMContentLoaded = (event) => {};

事件类型

通用 Event。

示例

基本用法

document.addEventListener("DOMContentLoaded", (event) => {
  console.log("DOM 完全加载和解析");
});

延迟 DOMContentLoaded

<script>
  document.addEventListener("DOMContentLoaded", (event) => {
    console.log("DOM 完全加载和解析");
  });

  for (let i = 0; i < 1_000_000_000; i++);
  // 这段同步脚本将会延迟 DOM 解析,
  // 所以 DOMContentLoaded 事件将会延迟执行。
</script>

检查加载是否已经完成

在你的脚本有机会运行前,DOMContentLoaded 可能就已经被触发。所以你在决定添加一个事件监听器前最好先检查一下。

function doSomething() {
  console.info("DOM 加载了");
}

if (document.readyState === "loading") {
  // 此时加载尚未完成
  document.addEventListener("DOMContentLoaded", doSomething);
} else {
  // `DOMContentLoaded` 已经被触发
  doSomething();
}

[!NOTE] 这里不存在竞争条件——文档不可能在 if 检查和 addEventListener() 调用之间被加载。JavaScript 采用的是运行到完成语义,这意味着如果文档在事件循环的某个特定时间点正在加载,那么在下一个循环之前它是不可能被加载的,而在下一个循环中,doSomething 处理程序已经附加并将被触发。

运行实例

HTML

<div class="controls">
  <button id="reload" type="button">重新加载</button>
</div>

<div class="event-log">
  <label for="eventLog">事件日志:</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";
});

结果

运行实例

规范

浏览器兼容性

参见

  • 相关事件:Window/load_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

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

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