浏览器与 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 成员变化不会改变集合本身。

HTMLCollection 与 NodeList 更新行为对比

完整示例与验证

下面的示例让 ul 初始只包含两个紧邻的 li,因此 children、querySelectorAll("li") 和 childNodes 的初始长度都为 2。新增第三个元素后,两个实时集合会立即反映变化,静态集合保持原值。

html
<!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>

预期输出

text
初始 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 变化。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

HTMLCollection 与 NodeList

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通