HTMLCollection

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨julio de 2015⁩.

La interfazHTMLCollection representa una colección genérica (objeto tipo array similar a arguments) de elementos (en orden de documento) y ofrece métodos y propiedades para seleccionarlos de la lista.

Nota:Esta interfaz se llamaHTMLCollection por razones históricas (antes del DOM moderno, las colecciones que implementaban esta interfaz sólo podían tener elementos HTML como sus ítems).

UnaHTMLCollection en el DOM de HTML está viva; se actualiza automáticamente cuando el documento subyacente cambia.

Propiedades

HTMLCollection.lengthRead only: Devuelve el numero de ítems en la colección.

Métodos

HTMLCollection.item(): Devuelve el nodo específicado en el índice en base cero dentro de la lista. Devuelvenull si el índice está fuera de rango.
HTMLCollection.namedItem(): Devuelve el nodo específico cuyo ID o, en último caso, cuyo nombre coincide con la cadena especificada porname. La coincidencia por nombre sólo se hace como último recurso, sólo en HTML, y sólo si el elemento referenciado soporta el atributoname. Devuelvenull si no existe ningún nodo con el nombre indicado.

Uso en JavaScript

HTMLCollection también expone a sus miembros directamente como propiedades tanto por name como por index. Los IDS de HTML deben contener: y. como caracteres válidos, los cuales necesitan del uso de corchetes para acceder a sus propiedades. Actualmente las HTMLCollections no reconocen los IDS puramente numéricos, lo que causaría conflicto con el acceso al estilo array, aunque HTML5 sí permite estos.

Por ejemplo, suponiendo que hay un elemento<form> en el documento y que suid es"myForm":

var elem1, elem2;// document.forms es un HTMLCollectionelem1 = document.forms[0];elem2 = document.forms.item(0);alert(elem1 === elem2); // muestra: "true"elem1 = document.forms.myForm;elem2 = document.forms.namedItem("myForm");alert(elem1 === elem2); // muestra: "true"elem1 = document.forms["named.item.with.periods"];