浏览器与 Web API / 系统课时
DOMContentLoaded 与脚本执行时机
DOMContentLoaded 与脚本执行时机
本课通过一组可运行文件比较普通脚本、defer、async 和 DOMContentLoaded 的执行关系。完成后,你能根据脚本是否依赖 DOM、其他脚本或加载顺序选择正确策略,并准确解释节点为什么在某个时刻仍不可用。
学习目标
- 判断不同脚本加载方式何时下载、执行以及是否阻塞 HTML 解析
- 解释
DOMContentLoaded的触发条件与不等待的资源 - 编写在页面已加载或延迟注入时都安全的初始化逻辑
四种时机的本质差异
浏览器读取 HTML 时会逐步构建 DOM。普通脚本遇到后通常暂停解析并立即执行;defer 与 async 都可并行下载,但前者等待解析完成并保持文档顺序,后者下载完成就执行,顺序和 DOM 可用程度都不稳定。

| 方式 | 执行时机 | 顺序保证 | 适合场景 |
|---|---|---|---|
| 普通脚本 | 解析遇到脚本时执行 | 按文档顺序 | 必须立即运行且只依赖前方 DOM |
defer |
DOM 解析完成后、事件触发前 | 按文档顺序 | 页面交互与相互依赖的脚本 |
async |
下载完成后立即执行 | 不保证 | 独立统计、广告或无依赖组件 |
DOMContentLoaded |
DOM 与延迟脚本准备完成后触发 | 按监听器注册顺序调用 | 统一等待 DOM 就绪 |
DOMContentLoaded 不等待图片等普通资源加载,也不等待尚未完成的 async 脚本。defer 只对带 src 的外部经典脚本有效,在内联脚本上添加该属性不会得到同样效果。
搭建可验证的最小项目
创建三个文件。index.html 在不同位置记录 DOM 状态,两个外部脚本分别使用 defer 和 async。
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>脚本执行时机</title>
<script>
// 此时 body 尚未解析,因此无法找到后面的 #app
console.log("head 普通脚本", document.querySelector("#app"));
// 回调会在 DOM 解析和 defer 脚本执行完成后运行
document.addEventListener("DOMContentLoaded", () => {
console.log("DOMContentLoaded", document.querySelector("#app")?.textContent);
});
</script>
<script defer src="./defer.js"></script>
<script async src="./async.js"></script>
</head>
<body>
<main id="app">DOM 已创建</main>
<script>
console.log("body 末尾普通脚本", document.querySelector("#app").textContent);
</script>
</body>
</html>defer.js:
// defer 执行时 DOM 已解析完成,可以安全读取 #app
console.log("defer", document.querySelector("#app")?.textContent);async.js:
// async 时机不固定,因此必须容忍目标节点尚不存在
console.log(
"async",
document.querySelector("#app")?.textContent ?? "节点尚不可用"
);在文件目录启动静态服务器:
python -m http.server 8000预期结果
终端显示:Serving HTTP on <HOST> port 8000 ...
浏览器访问 http://localhost:8000 后:
head 普通脚本一定得到 null。
body 末尾普通脚本一定得到“DOM 已创建”。
defer 一定在 DOM 解析完成后执行,并早于 DOMContentLoaded。
DOMContentLoaded 一定能读取“DOM 已创建”。
async 的日志位置不固定,读取结果取决于下载完成时机。<HOST> 的实际显示可能因操作系统和 Python 版本不同而变化。重复刷新时,async 日志顺序可能改变,这正是该模式不适合依赖 DOM 顺序或其他脚本的原因。
选择合适的加载策略
页面交互脚本优先使用 defer,因为它不阻塞解析、能访问完整 DOM,并保持多个脚本的文档顺序。只有脚本完全独立、提前或延后执行都不影响页面时,才使用 async。
普通脚本适合极少数必须立刻执行的初始化,例如在页面渲染前写入关键状态。若脚本放在 body 末尾,它也能访问前方 DOM,但会把结构位置与执行时机绑在一起,维护性通常不如 defer。
编写可重复调用的 DOM 初始化
脚本可能由普通页面、动态模块或浏览器扩展在不同时间注入。下面的辅助函数先检查 document.readyState:仍在解析就等待事件,否则立即执行,避免错过已经触发的 DOMContentLoaded。
function onDomReady(callback) {
if (document.readyState === "loading") {
// 解析期间注册一次性监听,避免初始化函数重复执行
document.addEventListener("DOMContentLoaded", callback, { once: true });
return;
}
// DOM 已就绪时直接调用,防止等待一个不会再次触发的事件
callback();
}
onDomReady(() => {
const app = document.querySelector("#app");
console.log(app?.textContent ?? "未找到节点");
});预期输出
DOM 已创建该写法适合无法控制脚本注入时间的工具代码。普通业务页面若已经使用 defer 或模块脚本,通常可以直接初始化,不必为每个文件重复包一层事件监听。
验证边界与常见误判
DOMContentLoaded 表示 DOM 可遍历,不表示图片、字体和所有网络请求都完成;确实需要等待完整页面资源时才监听 load。排查顺序应先看脚本标签属性,再看脚本所在位置,最后在 Console 记录 document.readyState 与时间戳。
不要依赖一次刷新观察到的 async 顺序,因为缓存、网络和文件大小都会改变结果。正确设计应假定它可能在解析期间、解析完成后,甚至 DOMContentLoaded 之后执行。