HTMLAllCollection

实例属性

HTMLAllCollection.length 只读

返回集合中项目的数量。

实例方法

HTMLAllCollection.item()

返回位于集合中指定偏移位置的元素，或者返回其 id 或 name 属性具有指定值的元素。如果未找到任何元素，则返回 null。

HTMLAllCollection.namedItem()

返回集合中第一个其 id 或 name 属性与给定的字符串名称匹配的元素，如果没有匹配的元素，则返回 null。

JavaScript 中的用法

索引访问

除了上述方法外，可以通过整数索引和字符串属性名称来访问 HTMLAllCollection 中的元素。HTML id 属性可能包含 : 和 . 作为有效字符，这需要使用方括号属性访问。collection[i] 等同于 collection.item(i)，其中 i 可以是整数、包含整数的字符串或表示 id 的字符串。

作为函数调用

HTMLAllCollection 对象是可调用的。当无参数调用或传入 undefined 时，它返回 null。否则，当传入相同参数时，它返回与 item() 方法相同的值。

特殊类型转换行为

由于历史原因，document.all 是一个在以下方面表现得像 undefined 的对象：

• 它与 undefined 和 null 是宽松相等的。
• 在布尔上下文中，它是假值。
• 它的 typeof 结果是 "undefined"。

这些特殊行为确保了如下代码能够正常工作：

if (document.all) {
  // 假设我们是在 IE 浏览器中；提供特殊逻辑
}
// 假设我们是在一个现代浏览器中

即使代码在出于兼容性原因实现了 document.all 的浏览器中运行，它也将继续提供现代浏览器的行为。

然而，在所有其他上下文中，document.all 仍然是一个对象。例如：

• 它与 undefined 或 null 都不是严格相等的。
• 当在空值合并运算符（??）或可选链运算符（?.）的左侧使用时，它不会导致表达式短路。

规范

浏览器兼容性

参见

• HTMLCollection