Manual de Referência DOM HTMLCollection

Objeto HTMLCollection

O objeto HTMLCollection é uma lista de elementos HTML semelhante a um array.

Métodos como getElementsByTagName() retornam HTMLCollection.

Atributos e métodos

Você pode usar os seguintes atributos e métodos no objeto HTMLCollection:

Atributo / Método Descrição
item() Retorna o elemento na posição especificada da HTMLCollection.
length Retorna o número de elementos na HTMLCollection.
namedItem() Retorna o elemento com ID ou nome especificado na HTMLCollection.

Exemplo

Exemplo

Obter a HTMLCollection:

var x = document.getElementsByTagName("P");
// Retornar a coleção de todos os elementos P no documento

Experimente você mesmo

Exemplo

Emitir o número de elementos <p> no documento:

var x = document.getElementsByTagName("P");
document.write(x.length);

Experimente você mesmo

Exemplo

Percore a iteração de cada elemento na HTMLCollection:

x = document.getElementsByTagName("*");
l = x.length;
for (i = 0; i < l; i++) {
  document.write(x[i].tagName + "<br>");
}

Experimente você mesmo