浏览器与 Web API / 系统课时

DOMContentLoaded 与脚本执行时机

DOMContentLoaded 与脚本执行时机

本课通过一组可运行文件比较普通脚本、defer、async 和 DOMContentLoaded 的执行关系。完成后,你能根据脚本是否依赖 DOM、其他脚本或加载顺序选择正确策略,并准确解释节点为什么在某个时刻仍不可用。

学习目标

  • 判断不同脚本加载方式何时下载、执行以及是否阻塞 HTML 解析
  • 解释 DOMContentLoaded 的触发条件与不等待的资源
  • 编写在页面已加载或延迟注入时都安全的初始化逻辑

四种时机的本质差异

浏览器读取 HTML 时会逐步构建 DOM。普通脚本遇到后通常暂停解析并立即执行;defer 与 async 都可并行下载,但前者等待解析完成并保持文档顺序,后者下载完成就执行,顺序和 DOM 可用程度都不稳定。

普通脚本、defer、async 与 DOMContentLoaded 时间线

方式 执行时机 顺序保证 适合场景
普通脚本 解析遇到脚本时执行 按文档顺序 必须立即运行且只依赖前方 DOM
defer DOM 解析完成后、事件触发前 按文档顺序 页面交互与相互依赖的脚本
async 下载完成后立即执行 不保证 独立统计、广告或无依赖组件
DOMContentLoaded DOM 与延迟脚本准备完成后触发 按监听器注册顺序调用 统一等待 DOM 就绪

DOMContentLoaded 不等待图片等普通资源加载,也不等待尚未完成的 async 脚本。defer 只对带 src 的外部经典脚本有效,在内联脚本上添加该属性不会得到同样效果。

搭建可验证的最小项目

创建三个文件。index.html 在不同位置记录 DOM 状态,两个外部脚本分别使用 defer 和 async。

html
<!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:

js
// defer 执行时 DOM 已解析完成,可以安全读取 #app
console.log("defer", document.querySelector("#app")?.textContent);

async.js:

js
// async 时机不固定,因此必须容忍目标节点尚不存在
console.log(
  "async",
  document.querySelector("#app")?.textContent ?? "节点尚不可用"
);

在文件目录启动静态服务器:

bash
python -m http.server 8000

预期结果

text
终端显示: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。

js
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 ?? "未找到节点");
});

预期输出

text
DOM 已创建

该写法适合无法控制脚本注入时间的工具代码。普通业务页面若已经使用 defer 或模块脚本,通常可以直接初始化,不必为每个文件重复包一层事件监听。

验证边界与常见误判

DOMContentLoaded 表示 DOM 可遍历,不表示图片、字体和所有网络请求都完成;确实需要等待完整页面资源时才监听 load。排查顺序应先看脚本标签属性,再看脚本所在位置,最后在 Console 记录 document.readyState 与时间戳。

不要依赖一次刷新观察到的 async 顺序,因为缓存、网络和文件大小都会改变结果。正确设计应假定它可能在解析期间、解析完成后,甚至 DOMContentLoaded 之后执行。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

DOMContentLoaded 与脚本执行时机

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通