浏览器与 Web API / 系统课时
HTMLCollection 与 NodeList
HTMLCollection 与 NodeList
HTMLCollection 和 NodeList 都是浏览器提供的类数组集合,但它们在节点范围、产生方式和更新行为上并不相同。本课通过同一段 DOM 变更代码,观察实时集合与静态快照的差异,并建立可靠的选择与遍历规则。
学习目标
- 区分
HTMLCollection与NodeList的常见来源和成员类型。 - 理解实时集合、静态集合以及
childNodes的特殊情况。 - 根据读取、遍历和 DOM 修改需求选择合适的处理方式。
两类集合来自哪里
HTMLCollection 只包含元素节点,常见来源包括 children、getElementsByTagName() 和 getElementsByClassName()。这些 API 返回的集合通常是实时的,读取 length 或索引时会反映当前 DOM。
NodeList 可以包含不同类型的节点。querySelectorAll() 返回静态 NodeList,而 childNodes 返回实时 NodeList。因此,“NodeList 一定静态”是错误结论,必须同时看集合类型和具体产生它的 API。
| 比较项 | HTMLCollection | NodeList |
|---|---|---|
| 常见成员 | 仅元素节点 | 元素或其他节点 |
| 常见来源 | children、getElementsBy* |
querySelectorAll、childNodes |
| 更新行为 | 通常实时 | 可能静态,也可能实时 |
| 访问方式 | 下标、item()、部分 API 支持 namedItem() |
下标、item() |
直接 forEach() |
通常不提供 | 现代浏览器通常提供 |
更新行为的核心差异
实时集合不是事件监听器,也不会异步推送变化。它更像一个始终连接 DOM 的视图:每次读取 length、索引或成员时,浏览器依据当前结构给出结果。静态集合则保存查询时匹配到的节点引用,之后 DOM 成员变化不会改变集合本身。

完整示例与验证
下面的示例让 ul 初始只包含两个紧邻的 li,因此 children、querySelectorAll("li") 和 childNodes 的初始长度都为 2。新增第三个元素后,两个实时集合会立即反映变化,静态集合保持原值。
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<title>集合类型对比</title>
</head>
<body>
<ul id="items"><li>A</li><li>B</li></ul>
<script>
const list = document.querySelector("#items");
// children 是实时 HTMLCollection。
const liveElements = list.children;
// querySelectorAll 返回静态 NodeList。
const staticNodes = list.querySelectorAll("li");
// childNodes 返回实时 NodeList,本例中没有空白文本节点。
const liveNodes = list.childNodes;
console.log(`初始 HTMLCollection: ${liveElements.length}`);
console.log(`初始静态 NodeList: ${staticNodes.length}`);
console.log(`初始 childNodes NodeList: ${liveNodes.length}`);
const item = document.createElement("li");
item.textContent = "C";
list.append(item);
console.log(`新增后 HTMLCollection: ${liveElements.length}`);
console.log(`新增后静态 NodeList: ${staticNodes.length}`);
console.log(`新增后 childNodes NodeList: ${liveNodes.length}`);
console.log(`HTMLCollection 第一个: ${liveElements[0].textContent}`);
console.log(`NodeList.item(0): ${staticNodes.item(0).textContent}`);
</script>
</body>
</html>预期输出
初始 HTMLCollection: 2
初始静态 NodeList: 2
初始 childNodes NodeList: 2
新增后 HTMLCollection: 3
新增后静态 NodeList: 2
新增后 childNodes NodeList: 3
HTMLCollection 第一个: A
NodeList.item(0): A实际 HTML 若在子元素之间包含缩进和换行,childNodes 还会包含文本节点,长度可能大于元素数量。只关心元素时应使用 children,不要依赖 childNodes.length 代表标签数量。
选择与遍历建议
需要 CSS 选择器能力和稳定快照时,优先使用 querySelectorAll()。需要持续读取某个容器当前的直接元素子节点时,可使用 children。无论哪种集合,都可以用 for...of 遍历;需要 map()、filter() 或固定成员副本时,先调用 Array.from(collection)。
修改实时集合对应的 DOM 时,避免使用递增下标一边遍历一边删除,因为集合会缩短并导致跳项。更稳妥的方式是先转成数组,再执行删除;或者从末尾向前遍历。
易混淆点
类数组集合拥有 length 和数字索引,但不是 Array,不能默认调用所有数组方法。NodeList 是否实时由来源 API 决定;HTMLCollection 虽然通常实时,也不应把它当作 DOM 变化通知机制。
children 只返回直接元素子节点,querySelectorAll() 可以查询任意后代。选择 API 时应先明确节点范围,再考虑集合是否需要自动反映 DOM 变化。