jQuery $(document).ready()与原生JS DOMContentLoaded对比

作者:流萤时间:2026-11-18 13:43:34浏览:440

深入对比jQuery $(document).ready()与原生JavaScript DOMContentLoaded事件的触发时机、底层实现原理、异步状态补偿差异与迁移改造实操方法。

分类:Web 前端技术 阅读时长:约 8 分钟 关键词:DOM 就绪时序 / 原生重构 / 性能优化
jQuery $(document).ready()与原生JS DOMContentLoaded对比
图 0:jQuery $(document).ready() 与原生 DOMContentLoaded 的核心属性对比概述
核心结论先行:$(document).ready() 与原生 DOMContentLoaded 事件的触发时机在页面常规加载过程中完全一致——两者都在浏览器完成 HTML 结构解析并构建出完整的 DOM 树后立刻触发,无需等待外部高清图片、视频或样式表加载完毕。核心差异在于:原生 DOMContentLoaded 是瞬时分发的单次事件,若脚本在其触发之后才绑定监听,回调将彻底失效;而 jQuery 的 $(document).ready() 具备内部状态机与异步延迟补发机制,无论在就绪前还是就绪后注册,回调函数均能稳定执行。现代前端工程在遵循合理放置 <script> 标签或使用 defer 属性的前提下,推荐全量使用原生语法,以节省约 30KB 以上的库体积。

一、触发时机与页面生命周期定位

为了让页面操作交互能够尽早生效,开发者通常希望在 DOM 节点可用时立即运行初始化脚本,而不是等待页面上所有的多媒体资源全部下载完。理解两者的首要前提,是理清浏览器加载 HTML 文档的标准生命周期。

当浏览器请求 HTML 文档后,渲染引擎按顺序解析字节流并逐步构建 DOM 树。在这个流水线中,有两个极其关键的时间截点:

  • DOM 就绪截点(DOM Ready):浏览器已将 HTML 全部解析成 DOM 节点树,所有的 DOM 查询和属性绑定均可安全操作,但外部图片、嵌套的 iframe 以及部分异步媒体资源仍在后台网络传输。
  • 页面完全加载截点(Window Load):页面上的所有依赖资源(包括大图、样式表、字体文件等)已完全下载并解码完毕,对应全局 window.onload 事件。

原生 DOMContentLoaded 与 jQuery $(document).ready() 都精准锚定在“DOM 就绪截点”。两者的目标一致:缩短可交互时间(TTI, Time to Interactive),避免不必要的静态资源等待。

jQuery $(document).ready()与原生JS DOMContentLoaded对比
图 1:浏览器加载生命周期与 DOM 就绪事件、完全加载事件的时序关系

二、底层实现原理与机制差异

尽管常规加载流中的触发时钟相同,但底层运行机制存在本质区别。这也是许多从 jQuery 转向原生 JavaScript 的开发者容易踩坑的深层原因。

1. 原生 DOMContentLoaded:瞬时标准广播

原生 DOMContentLoaded 是 W3C 与 WHATWG 标准规范下的 DOM 级事件。浏览器内核在文档解析结束时,在 document 对象上向外广播该事件一次。

因为是单次事件派发,它具有“无状态记忆”的特征。如果在该事件触发完毕之后,某段脚本才通过 document.addEventListener('DOMContentLoaded', fn) 挂载监听函数,该监听器将永远不会被调用,造成代码执行假死。

2. jQuery $(document).ready():带状态记忆的 Deferred 管道

jQuery 的 $(document).ready() 绝非仅仅是 addEventListener 的语法糖,其实质是一个基于内部 jQuery.Deferred()(现等价于 Promise 模型)的状态机包装。其核心处理逻辑包含以下关键环节:

  1. 预先检测文档状态:在执行绑定前,首先检查 document.readyState。若状态为 'complete',或文档已处于 'interactive' 且未在老旧 IE 下被锁定,说明 DOM 已经就绪。
  2. 状态补偿执行:如果发现页面已经就绪,jQuery 并不会傻傻去监听早已过期的事件,而是直接调用 window.setTimeout(jQuery.ready),借助微任务或异步事件队列,保证传入的回调函数立刻在下一个时钟周期执行。
  3. 事件监听保底:若页面仍在解析中(document.readyState === 'loading'),jQuery 会同时在 document 上监听 DOMContentLoaded,并在 window 上监听 load 兜底。一旦任意一个触发,便将内部 Deferred 状态置为已解决(Resolved)。
jQuery $(document).ready()与原生JS DOMContentLoaded对比
图 2:原生 DOMContentLoaded 的单次广播机制与 jQuery ready 状态机处理流程对比

三、语法形式与调用方式对照

在日常书写中,两者的调用形式与参数传递也有明显不同。熟练掌握标准写法有助于编写规范的代码。

1. jQuery 的四种写法(推荐首选简写)

jQuery 历史上演进出多种等效书写方式,现代规范中最推荐采用简洁的 $(function) 形式:

// 方式一:标准显式写法
$(document).ready(function() {
  console.log("DOM 已就绪");
});

// 方式二:官方推荐的简洁语法(等价于方式一)
$(function() {
  console.log("DOM 已就绪,首选简洁写法");
});

// 方式三:传递 $ 符号作为局部形参(防止全局 $ 冲突)
jQuery(function($) {
  $('#my-element').addClass('active');
});

// 方式四:过时的废弃写法(不建议使用)
$().ready(function() { /* ... */ });

2. 原生 JavaScript 的标准写法

现代原生 JavaScript 使用标准的事件监听 API:

// 现代浏览器原生监听标准写法
document.addEventListener('DOMContentLoaded', function(event) {
  console.log("原生 DOM 树解析完成");
  const el = document.getElementById('my-element');
  el.classList.add('active');
});

// 使用箭头函数的现代简明写法
document.addEventListener('DOMContentLoaded', () => {
  console.log("原生 DOM 树已就绪");
});
注意细节:监听对象的挂载位置
原生 DOMContentLoaded 事件的标准分发对象是 document。虽然现代部分浏览器在 window 上也可以捕获到冒泡的该事件,但在规范实现中,始终推荐在 document 上调用 addEventListener,以确保跨平台最严格的兼容性。

四、核心差异点横向对照

在实际生产环境中,选型决策通常取决于以下关键维度的差异表现:

对比维度 jQuery $(document).ready() 原生 DOMContentLoaded
本质与规范 JavaScript 库封装(Deferred / 状态机) W3C / WHATWG DOM 级规范原生事件
资源开销 需引入完整 jQuery 库文件(压缩后约 30KB+) 0 额外字节,浏览器内核引擎原生支持
事后注册(晚期绑定) 支持。即使页面早已加载完毕,仍会异步补发执行 不支持。事件已过则不再触发,回调被遗弃
执行微时序 即使立即触发,也会被包裹在异步任务队列中执行 在事件派发当下同步依次调用所有已绑定的监听函数
多次独立调用 支持。多次调用 $(fn) 会放入队列依次执行 支持。通过 addEventListener 注册多个回调依次执行
链式支持 返回 jQuery 包装集对象,支持链式链式语法 addEventListener 返回 undefined
异常隔离 某一回调报错不影响外部主事件循环,易打断链 某一回调未捕获异常会在当前线程抛出,但不影响同级捕获

五、从 jQuery ready 迁移至原生 JS 的实操方案

在前端工程化体系成熟的今天,移除庞大的 jQuery 运行时、走向轻量纯原生已是大势所趋。但迁移不能简单粗暴地将 $(document).ready(fn) 全局替换为 document.addEventListener('DOMContentLoaded', fn),必须依据脚本的实际引入时机分类处理。

jQuery $(document).ready()与原生JS DOMContentLoaded对比
图 3:从 jQuery ready 迁移到原生 JavaScript 的四步排查与实施流程

方案 A:直接放置在文档底部或使用 defer 属性(现代推荐,零包装)

如果你的 <script> 标签位于 HTML 结构中的 </body> 闭合标签之前,或者在引入时添加了 defer 属性,浏览器解析到该脚本时 DOM 树早已构建就绪。

此时,根本不需要任何 ready 或 DOMContentLoaded 监听器包裹,直接书写顶层代码即可,不仅减少代码层级,还能提高执行速度:

<!-- 示例:放在 </body> 前的脚本直接执行 -->
<script>
  // 直接操作 DOM,此时节点均已解析完成
  const button = document.querySelector('#submit-btn');
  button.addEventListener('click', handleSubmit);
</script>

方案 B:编写健壮的原生 ready 封装函数(完全对齐 jQuery 行为)

对于在 <head> 中引入的公共通用脚本,或者可能被动态按需载入(如异步模块加载、微前端子模块注入)的业务代码,必须使用检查 document.readyState 的健壮封装函数,确保任何时机下都能万无一失地触发:

/**
 * 健壮的原生 DOM 就绪封装(等价于 jQuery ready 的双重保障)
 * @param {Function} callback - DOM 就绪后执行的回调函数
 */
function domReady(callback) {
  if (typeof callback !== 'function') return;

  // 1. 如果当前文档状态不是 loading,说明 DOM 解析已经完成
  if (document.readyState !== 'loading') {
    // 放入微任务队列执行,保持与原生事件相同的异步预期
    queueMicrotask(callback);
  } else {
    // 2. 如果仍在 loading 阶段,正常监听 DOMContentLoaded 事件
    document.addEventListener('DOMContentLoaded', callback, { once: true });
  }
}

// 使用示例:无论何时何地调用,均可安全保证执行
domReady(() => {
  console.log("原生 DOM 树稳定就绪,安全执行初始化!");
});
技术细节:为什么是 document.readyState !== 'loading'?
document.readyState 有三个可能值:'loading'(加载解析中)、'interactive'(文档解析完成,DOM 可交互)和 'complete'(全部资源加载完毕)。只要状态不再是 'loading',就说明 DOMContentLoaded 已经触发完毕或正在同步执行中,此时挂载常规事件监听必将错过,唯有直接执行回调才能避免执行丢失。

六、技术选型决策与总结

技术选择始终取决于实际业务场景与维护约束。以下是清晰的选择依据与决策建议:

jQuery $(document).ready()与原生JS DOMContentLoaded对比
图 4:全维度特性矩阵与实际业务场景技术选型决策图

1. 全面采用原生标准的场景

  • 新建工程或组件库:无论使用 Vue、React、Svelte 等现代组件化框架,还是开发独立的原生 Web Components,DOM 的生命周期已由框架或浏览器标准驱动,无需任何第三方 DOM 库。
  • 对加载性能有严苛要求的页面:电商导购、广告落地页等高度依赖首屏渲染转化率的场景,省去 jQuery 的 30KB+ 体积能直接改善 Largest Contentful Paint (LCP) 指标。
  • 脚本已被模块化管理:使用 <script type="module"> 的现代模块化代码天然具备类似于 defer 的延迟解析执行特性,无需包裹任何 ready 容器。

2. 继续保留 jQuery ready 的场景

  • 历史系统小规模维护:系统已有数十万行基于 jQuery 及其周边插件(如旧版 DataTables、Chosen、Bootstrap 3)的代码,盲目替换入口 ready 逻辑不仅没有实质性能收益,反而容易因为异步时序差异引入回归故障。
  • 整站全局公共脚本已强制加载 jQuery:当架构层无法剔除 jQuery 基础库时,直接使用简写 $(function() { ... }) 仍是符合团队历史协作惯性的合理选择。

总结而言,$(document).ready() 是特定历史时期为了抹平浏览器实现差异并提供优雅链式语法的优秀工程产物;而在现代 Web 标准高度统一的当下,原生的 DOMContentLoaded 配合 document.readyState 检查机制,已成为性能更好、标准明确且零依赖的首选实践方案。

作者最新文章
相关文章
更多