HTMLAllCollection

Интерфейс HTMLAllCollection представляет собой коллекцию всех элементов документа, доступных по индексу (как массив) и по id элемента. Он возвращается свойством document.all.

HTMLAllCollection имеет очень похожую структуру с HTMLCollection, но существуют многочисленные тонкие различия в поведении — например, HTMLAllCollection может вызываться как функция, а его метод item() может вызываться со строкой, представляющей атрибут id или атрибут name элемента.

HTMLAllCollection.length Только для чтения

Возвращает количество элементов в коллекции.

HTMLAllCollection.item()

Возвращает элемент, расположенный по указанному смещению в коллекции, или элемент со значением, заданным для атрибута id или name . Возвращает null , если элемент не найден.

HTMLAllCollection.namedItem()

Возвращает первый элемент в коллекции, у которого атрибут id или атрибут name соответствует заданному строковому имени, или null , если такого элемента нет.

Помимо вышеперечисленных методов, к элементам в HTMLAllCollection можно получить доступ по целочисленным индексам и именам строковых свойств. Атрибут HTML id может содержать : и . в качестве допустимых символов, что потребовало бы использования квадратных скобок для доступа к свойствам. collection[i] эквивалентно collection.item(i), где i может быть целым числом, строкой, содержащей целое число, или строкой, представляющей id.

Объект HTMLAllCollection является вызываемым. Когда он вызывается без аргументов или с undefined, он возвращает null. В противном случае он возвращает то же значение, что и метод item(), когда ему передаются те же аргументы.

По историческим причинам document.all — это объект, который по следующим причинам ведет себя как undefined:

• Он ослабленно равен undefined и null.
• Он ложный в контексте булевых значений.
• Его typeof равен "undefined".

Это специальное поведение гарантирует, что код вроде:

if (document.all) {
  // Assume that we are in IE; provide special logic
}
// Assume that we are in a modern browser

Продолжит обеспечивать современное поведение, даже если код выполняется в браузере, который реализует document.all по соображениям совместимости.

Однако во всех других контекстах document.all остается объектом. Например:

• Он не строго равен ни undefined ни null.
• При использовании в левой части оператора нулевого слияния (??) или оператора необязательной цепочки (?.) он не приведет к сокращению выражения.

• HTMLCollection