document.readyState === 'complete' 是浏览器确认HTML解析完成且子资源加载完毕的信号,但不保证图片解码、字体渲染或第三方脚本初始化;需结合具体目标(如img.load、font.load、iframe.contentDocument.readyState等)精准判断。

document.readyState === 'complete' 是最接近“完全加载”的标准信号
它代表 HTML 文档解析完成,且所有子资源(img、link、script、iframe)均已下载并触发各自加载事件。这不是“视觉上看起来加载完了”,而是浏览器内核确认的资源就绪点。
但要注意:complete 不保证图片已解码、字体已渲染、Canvas 已绘制、或第三方脚本(如 analytics)已完成初始化——这些属于更高层语义,需额外判断。
- 不要只监听一次
readystatechange事件:状态可能从loading→interactive→complete快速跳变,事件回调里必须检查document.readyState === 'complete',不能只靠触发次数 -
interactive时 DOM 可操作,但img.naturalWidth可能仍为 0;complete才大概率拿到真实尺寸 - 若页面含大量
async脚本或fetch请求,complete并不等待它们——它们是异步任务,和 HTML 加载生命周期无关
动态插入的内容(如 AJAX 替换 DOM)没有 readyState 自动更新
你用 element.innerHTML = htmlString 或 element.append(...) 插入新节点后,浏览器不会重置 document.readyState,也不会触发 DOMContentLoaded。此时“是否加载完”取决于你自己的逻辑边界。
- 图片是否显示?要单独监听每个
img的load或检查img.complete——否则可能拿到 0×0 尺寸 - 图表是否渲染?ECharts/Chart.js 通常提供
chart.setOption()的回调,或chartInstance.on('finished', handler)类似钩子,别依赖全局事件 - 字体是否可用?用
document.fonts.load('16px "Inter"')返回 Promise,比等complete更精准
iframe 动态加载完成 ≠ 子页面 DOM 就绪(尤其跨域)
iframe.onload 在现代浏览器中仅表示 iframe 元素本身加载完毕(HTTP 响应头到达),对跨域 iframe 来说,这跟子页面的 document.readyState 完全无关。
立即学习“前端免费学习笔记(深入)”;
- 同域 iframe:可读取
iframe.contentDocument.readyState,值为complete时才真正就绪 - 跨域 iframe:无法访问其
contentDocument,onload后只能通过postMessage等待子页主动通知“我 ready 了” - 设了
display: none的 iframe,onload会被静默丢弃——改用visibility: hidden或先插入再隐藏
aria-busy 和 loading 状态需要手动配对控制
辅助技术依赖 aria-busy="true" 暂停阅读流,但它不是自动开关,必须由 JS 显式管理生命周期。
- 只加在直接承载动态内容的容器上,比如
<div id="chart-container" role="region" aria-label="用户行为热力图">,而非整个 <code>body - 开始请求时设
aria-busy="true",成功/失败回调里**立刻**设回"false";漏掉任一路径都会让屏幕阅读器卡住 - 避免和
aria-live混用:二者语义冲突,aria-busy="true"会暂停所有aria-live区域播报 - 视觉上的 spinner 必须配合文本提示(如
<span aria-live="polite">加载中…</span>),否则对视障用户等于“此处无内容”
真正的难点不在“怎么监听”,而在于明确你要等的是什么:是 DOM 结构?是图片像素?是字体轮廓?还是某个第三方库的内部状态?每个目标对应不同的检测手段,混用就会出问题。



















