讲师中心 微信公众号
AI工具推荐 视频效率加速

HTML页面加载时由于脚本加载位置导致的DOM未就绪异常

风浩姑娘_5191

风浩姑娘_5191

发布时间:2026-06-18 07:34:00

|

884人浏览过

|

来源于php中文网

原创

脚本放在<head>中执行时document.getElementById返回null,因为浏览器自上而下解析HTML,遇到<script>即暂停解析并执行,此时<body>尚未解析、DOM元素不存在;defer属性可确保外部脚本在DOM构建完成后按序执行,但内联脚本不支持defer,须用DOMContentLoaded事件包裹。

html页面加载时由于脚本加载位置导致的dom未就绪异常

脚本在 <head> 里直接执行,document.getElementById 返回 null,不是代码写错了,是它根本没机会找到元素。

为什么 <script> 放在 <head> 里会找不到 DOM 元素

浏览器解析 HTML 是从上到下线性进行的。当它读到 <head> 里的 <script> 标签时,会立刻暂停 HTML 解析、下载(如果是外部脚本)、并执行脚本 —— 此时 <body> 甚至还没开始解析,所有页面元素都不存在于 DOM 中。

  • document.querySelector('#submit-btn') 或 document.getElementById('form') 一定返回 null
  • 对 null 调用 .addEventListener() 或 .innerHTML = ... 就会抛出 TypeError
  • 错误常静默发生:控制台报错,但页面看起来“只是没反应”
  • 即使脚本体积很小、本地加载快,也不能依赖“它大概率能等到”,因为规范就是“遇到就执行”

defer 是最稳妥的通用解法

给 <script src="main.js"></script> 加上 defer 属性,浏览器就会把它变成“等 DOM 构建完再执行”,且保持多个 defer 脚本的声明顺序。

  • 必须用于外部脚本(src 属性存在),内联脚本不支持 defer
  • 脚本仍会并行下载,不阻塞 HTML 解析,但执行时机被严格推迟到 DOMContentLoaded 前
  • 比把脚本挪到 </body> 前更可靠:后者依赖开发者手动维护位置,defer 是声明式保证
  • 兼容性好(IE9+),现代项目可放心用

哪些情况不能只靠 defer?

有些脚本本身不操作 DOM,但依赖其他脚本先执行(比如 jQuery 插件、或需要 window.$ 存在);或者你用了 async,它不保序也不等 DOM —— 这些时候 defer 不够用。

Html2md
Html2md

使用 Readability + Turndown 将 HTML 页面转换为干净的、Agent 友好的 Markdown。去除导航栏、广告、页脚、Cookie 横幅、社交按钮等干扰元素。支持 URL...

下载

立即学习“前端免费学习笔记(深入)”;

  • 依赖库未加载完成:确保 jQuery 的 <script src="jquery.js" defer></script> 在插件脚本之前
  • 用了 async:它会尽快执行,完全不管 DOM 状态,适合分析统计类无依赖脚本
  • 需要精确控制时机:比如等图片加载完再初始化轮播图,就得用 load 事件或 IntersectionObserver,而不是只等 DOM
  • 内联脚本无法加 defer:只能包一层 document.addEventListener('DOMContentLoaded', () => { ... })

别信“加个 alert 就好了”这种临时方案

有人发现把 alert('wait') 写在获取元素前,脚本突然能运行了 —— 这不是修复,是掩盖问题。用户关掉弹窗的瞬间,DOM 恰好构建完毕,纯属巧合。

  • alert 阻塞主线程,但 HTML 解析不受影响,所以“多出来的等待时间”让 DOM 赶上了
  • 网络稍慢、设备稍卡,这个“巧合”就失效,错误重现
  • 用 setTimeout 延迟几秒也一样不可靠:DOM 就绪时间不是固定值,而是取决于 HTML 规模和解析速度
  • 真正要解决的,是让脚本执行逻辑和 DOM 生命周期对齐,不是靠猜时间

最易被忽略的一点:defer 只对有 src 的脚本生效;如果你把初始化逻辑写在 <script>...</script> 内联块里,它依然会在解析到时立刻执行 —— 即使它下面紧跟着你要操作的 <div id="app"></div>。

热门AI工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

相关专题

更多
html版权符号
html版权符号

html版权符号是“©”,可以在html源文件中直接输入或者从word中复制粘贴过来,php中文网还为大家带来html的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

6555

2023.06.14

html在线编辑器
html在线编辑器

html在线编辑器是用于在线编辑的工具,编辑的内容是基于HTML的文档。它经常被应用于留言板留言、论坛发贴、Blog编写日志或等需要用户输入普通HTML的地方,是Web应用的常用模块之一。php中文网为大家带来了html在线编辑器的相关教程、以及相关文章等内容,供大家免费下载使用。

3652

2023.06.21

html网页制作
html网页制作

html网页制作是指使用超文本标记语言来设计和创建网页的过程,html是一种标记语言,它使用标记来描述文档结构和语义,并定义了网页中的各种元素和内容的呈现方式。本专题为大家提供html网页制作的相关的文章、下载、课程内容,供大家免费下载体验。

3330

2023.07.31

html空格
html空格

html空格是一种用于在网页中添加间隔和对齐文本的特殊字符,被用于在网页中插入额外的空间,以改变元素之间的排列和对齐方式。本专题为大家提供html空格的相关的文章、下载、课程内容,供大家免费下载体验。

3339

2023.08.01

html是什么
html是什么

HTML是一种标准标记语言,用于创建和呈现网页的结构和内容,是互联网发展的基石,为网页开发提供了丰富的功能和灵活性。本专题为大家提供html相关的各种文章、以及下载和课程。

4999

2023.08.11

html字体大小怎么设置
html字体大小怎么设置

在网页设计中,字体大小的选择是至关重要的。合理的字体大小不仅可以提升网页的可读性,还能够影响用户对网页整体布局的感知。php中文网将介绍一些常用的方法和技巧,帮助您在HTML中设置合适的字体大小。

3281

2023.08.11

html转txt
html转txt

html转txt的方法有使用文本编辑器、使用在线转换工具和使用Python编程。本专题为大家提供html转txt相关的文章、下载、课程内容,供大家免费下载体验。

3089

2023.08.31

html文本框代码怎么写
html文本框代码怎么写

html文本框代码:1、单行文本框【<input type="text" style="height:..;width:..;" />】;2、多行文本框【textarea style=";height:;"></textare】。

2708

2023.09.01

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

20

2026.10.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
GDB 17.2 官方文档集合
GDB 17.2 官方文档集合

共0课时 | 0人学习

Bootstrap 入门安装配置
Bootstrap 入门安装配置

共0课时 | 0人学习

38+ PhpStorm 提示和技巧
38+ PhpStorm 提示和技巧

共1课时 | 227人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn