登录
首页 >  文章 >  前端

如何通过HTML的document.readyState判断文档当前的加载解析状态

时间:2026-05-24 18:48:24 364浏览 收藏

你在学习文章相关的知识吗?本文《如何通过HTML的document.readyState判断文档当前的加载解析状态》,主要介绍的内容就涉及到,如果你想提升自己的开发能力,就不要错过这篇文章,大家要知道编程理论基础和实战操作都是不可或缺的哦!

document.readyState 的取值有 uninitialized、loading、interactive、complete、loaded 五种,现代标准稳定可用的仅 loading、interactive、complete;它用于在 DOM 可交互但资源未全加载时介入,比 onload 和 DOMContentLoaded 更底层可控。

如何通过HTML的document.readyState判断文档当前的加载解析状态

document.readyState 的取值有哪些

它不是布尔值,也不是百分比,而是一个只读字符串,浏览器根据当前文档生命周期返回以下五个值之一:uninitialized(极少见,仅旧IE)、loadinginteractivecomplete,部分规范还提过 loaded(已基本弃用)。现代标准中,实际能稳定观测到的只有 loadinginteractivecomplete 三种。

什么时候该监听 readyState 而不是用 onload 或 DOMContentLoaded

当你需要在 interactive 阶段就介入(比如页面刚可交互但图片/脚本还在加载),或需兼容老环境(如 IE8–10)时,document.readyState 比事件更底层、更可控。但要注意:

  • onload 等待所有资源(图片、iframe、CSS)加载完毕,DOMContentLoaded 只等 DOM 解析完成,而 readyState === 'interactive' 表示 DOM 已构建完、JS 可执行、用户可交互——但它不保证 CSS 已解析完毕,可能样式未生效
  • interactive 阶段操作 DOM 是安全的,但若依赖 getComputedStyle 或布局计算,仍可能拿到未应用样式的值
  • 不要在 loading 阶段尝试访问 document.body,它大概率是 null

如何可靠监听 readyState 变化

直接轮询或一次性判断都容易漏掉状态,推荐用 readystatechange 事件 + 状态兜底:

document.addEventListener('readystatechange', () => {
  if (document.readyState === 'interactive') {
    console.log('DOM ready, user can interact');
  } else if (document.readyState === 'complete') {
    console.log('All resources loaded');
  }
});

// 兜底:防止事件没触发(如脚本动态插入后才监听)
if (document.readyState === 'complete') {
  // 立即执行
} else if (document.readyState === 'interactive') {
  // 立即执行(某些浏览器会跳过 interactive)
}

注意:readystatechangecomplete 前一定会触发 interactive,但某些场景(如内联脚本紧贴 )可能来不及监听到 interactive,所以判断逻辑不能只依赖事件回调。

常见误用和兼容陷阱

document.readyState 看似简单,但踩坑点很隐蔽:

  • 拼写错误:写成 document.readystate(少一个 S)会导致永远为 undefined
  • 大小写敏感:必须是全小写 'complete',不能写成 'Complete''COMPLETE'
  • iframe 场景下,每个 iframe 有自己的 document,要监听子帧需单独绑定:iframe.contentDocument.readyState
  • 服务端渲染(SSR)或微前端中,主应用可能已进入 complete,但子应用的 document 并非同一个对象,不能复用主应用的状态判断

真正难的不是知道它有几个值,而是理解每个值背后对应的浏览器内部阶段——比如 interactive 不等于“样式就绪”,也不等于“JS 执行完毕”,它只是 DOM 构建完成的信号,其余都得靠你自己验证。

好了,本文到此结束,带大家了解了《如何通过HTML的document.readyState判断文档当前的加载解析状态》,希望本文对你有所帮助!关注golang学习网公众号,给大家分享更多文章知识!

资料下载
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>