Métodos Clássicos no DOM: getElementById e TagName
⚡ Curso de DOM • Web-ZoneWare

Métodos Clássicos de Seleção: getElementById, getElementsByClassName e getElementsByTagName

Lição 5 de 50

Métodos Clássicos de Seleção: getElementById, getElementsByClassName e getElementsByTagName

⚡ Módulo 1 • Aula 05 de 50 • MARCO DE 10%

Explore a mecânica dos três métodos clássicos e históricos de busca e seleção de elementos no DOM: compreenda a velocidade de busca indexada de document.getElementById(), o comportamento das coleções vivas (Live HTMLCollection) retornadas por getElementsByClassName() e getElementsByTagName(), e as armadilhas de mutação em tempo real ao iterar sobre elementos.

1. A Família Clássica de Métodos de Seleção

Antes da introdução dos métodos universais baseados em seletores CSS (querySelector e querySelectorAll), o JavaScript dependia historicamente de um trio de métodos nativos da especificação DOM Level 1 e HTML5:

  • document.getElementById(id): Busca um único elemento pelo atributo de identificador único.
  • element.getElementsByTagName(tag): Busca todos os elementos com a tag especificada.
  • element.getElementsByClassName(classe): Busca todos os elementos que possuem as classes CSS informadas.

2. `document.getElementById()`: O Campeão Absoluto de Velocidade

O método getElementById() é a forma mais rápida de capturar um elemento em qualquer navegador web. O motivo dessa velocidade extraordinária é de engenharia interna: os motores dos navegadores (como o Blink do Chrome ou o Gecko do Firefox) mantêm uma tabela hash indexada em memória C++ associando cada id diretamente ao endereço de memória do nó correspondente.

Graças a essa indexação, a busca não precisa percorrer a árvore do documento: ela é resolvida em complexidade de tempo constante O(1).

🎯

Regras Fundamentais de Uso:

  • Sem o símbolo de cerquilha: Passe apenas o nome do identificador (ex: document.getElementById("painel"), e NUNCA "#painel").
  • Exclusividade de IDs: O padrão HTML exige que cada id seja estritamente único por página. Caso existam acidentalmente IDs duplicados no documento, o método retornará exclusivamente a primeira ocorrência encontrada na ordem da árvore.
  • Retorno direto ou null: Retorna uma instância de HTMLElement caso o elemento exista, ou null se nada for encontrado.

3. Seleção Múltipla com `TagName` e `ClassName`

Ao contrário do getElementById, os métodos getElementsByTagName e getElementsByClassName possuem três características muito distintas:

  1. Estão no Plural (getElements...): Não retornam um elemento individual, mas sim uma coleção de elementos.
  2. Funcionam em Subárvores (Escopo Relativo): Enquanto o getElementById existe apenas no objeto document, você pode executar getElementsByTagName e getElementsByClassName a partir de qualquer elemento pai, restringindo a busca aos filhos daquele bloco específico:
    JavaScript 3 linhas
    const menuPrincipal = document.getElementById("menu-principal");
    // Busca botões APENAS dentro do menu, ignorando o restante da página:
    const botoesMenu = menuPrincipal.getElementsByTagName("button");
    
  3. Múltiplas Classes Simultâneas: O getElementsByClassName permite passar mais de uma classe separada por espaço, retornando apenas elementos que possuam todas as classes simultaneamente:
    JavaScript 1 linha
    const itensAtivos = document.getElementsByClassName("cartao destaque ativo");
    

4. O Que É uma Coleção Viva (Live HTMLCollection)?

Aqui reside um dos conceitos mais importantes e perigosos do DOM clássico: o retorno de getElementsByTagName e getElementsByClassName NÃO é um Array tradicional de JavaScript, mas sim uma HTMLCollection Viva (Live Collection).

⚡

A Definição de “Viva” (Live):
A coleção mantém um canal aberto em tempo real com a árvore do DOM. Se novos elementos forem criados ou se classes forem removidas da página por qualquer script, a HTMLCollection atualiza seu tamanho (length) e seus elementos instantaneamente e automaticamente, sem que você precise executar a busca novamente!

A Perigosa Armadilha da Mutação em Loop

Imagine que você deseja remover a classe alerta de todos os avisos da tela:

JavaScript 8 linhas
// ❌ CÓDIGO PROBLEMÁTICO COM LOOP INFINITO OU ELEMENTOS PULADOS:
const alertas = document.getElementsByClassName("alerta");
 
for (let i = 0; i < alertas.length; i++) {
    // Ao remover a classe, o elemento é expulso da coleção viva imediatamente!
    // O tamanho alertas.length diminui e os índices seguintes são deslocados!
    alertas[i].classList.remove("alerta");
}

5. Como Converter HTMLCollection em Array Moderno

Uma HTMLCollection é um objeto semelhante a um array (possui índices numéricos e a propriedade length), mas não possui métodos úteis como .map(), .filter(), .forEach() ou .reduce().

Para iterar com segurança e imutabilidade, a melhor prática do JavaScript moderno é converter a coleção em um Array real imediatamente utilizando o Spread Operator ou Array.from():

JavaScript 10 linhas
const colecaoViva = document.getElementsByClassName("cartao");
 
// Opção A: Spread Operator moderno (Recomendado)
const cartoesArray = [...colecaoViva];
 
// Opção B: Array.from() nativo
const cartoesArray2 = Array.from(colecaoViva);
 
// Agora você tem acesso a todos os métodos funcionais do JavaScript!
cartoesArray.forEach(cartao => console.log(cartao.textContent));
JavaScript Moderno (ES6+)
metodos-classicos-selecao.js
JavaScript 52 linhas
// =====================================================================
// LAB: EXPLORANDO GETELEMENTBYID, TAGNAME E A NATUREZA DAS LIVE COLLECTIONS
// =====================================================================
 
console.log("=== LABORATÓRIO DE MÉTODOS CLÁSSICOS DE SELEÇÃO ===");
 
// 1. Criando estrutura de teste dinâmica
const container = document.createElement("section");
container.id = "painel-usuarios";
 
container.innerHTML = `
    <h3 id="titulo-painel">Gestão de Acessos</h3>
    <ul id="lista-membros">
        <li class="usuario adm">Carlos Mendes (Administrador)</li>
        <li class="usuario operador">Fernanda Lima (Operador)</li>
        <li class="usuario visitante">Lucas Rocha (Visitante)</li>
    </ul>
`;
 
document.body.appendChild(container);
 
// 2. Testando getElementById (Elemento único de alta performance)
const titulo = document.getElementById("titulo-painel");
console.log("1. getElementById capturado:", titulo.textContent);
 
// 3. Testando getElementsByTagName com escopo restrito
const lista = document.getElementById("lista-membros");
const itensLi = lista.getElementsByTagName("li");
console.log("2. Total de tags  encontradas:", itensLi.length);
 
// 4. Testando a natureza VIVA (LIVE) de getElementsByClassName
const colecaoUsuarios = document.getElementsByClassName("usuario");
console.log("n--- TESTANDO A NATUREZA VIVA (LIVE COLLECTION) ---");
console.log("Total inicial de usuários na coleção:", colecaoUsuarios.length); // 3
 
// Criamos um novo elemento dinamicamente e inserimos na lista
const novoUsuario = document.createElement("li");
novoUsuario.className = "usuario adm";
novoUsuario.textContent = "Renata Vasconcelos (Administrador)";
lista.appendChild(novoUsuario);
 
// ATENÇÃO: A variável colecaoUsuarios atualizou-se SOZINHA sem nova busca!
console.log("Total de usuários após inserção no DOM:", colecaoUsuarios.length); // 4 (AUTOMÁTICO!)
 
// 5. Convertendo para Array real e utilizando forEach funcional
console.log("n--- CONVERSÃO PARA ARRAY REAL COM SPREAD OPERATOR ---");
const usuariosArray = [...colecaoUsuarios];
 
usuariosArray.forEach((userEl, index) => {
    const isAdm = userEl.classList.contains("adm");
    console.log(`[Usuário #${index + 1}] ${userEl.textContent} -> Privilégio: ${isAdm ? "TOTAL (ADM)" : "PADRÃO"}`);
});
🛠️ Laboratório Prático & Prática Imediata

Aplique o que você aprendeu nesta lição

Utilize nossas ferramentas online gratuitas para experimentar os conceitos ou teste o código ao vivo no Playground IDE.

💻 Desenvolvedor & Código

Editor de Códigos Web Online

Ambiente com destaque de sintaxe para você testar tags, tabelas e scripts na hora.

Abrir Ferramenta Online
⚡ Live Code Studio

Playground Web Online

Escreva seu código HTML, CSS ou JavaScript e veja o resultado renderizado ao vivo no navegador com zero configuração.

⚡ Codificar no Playground IDE
Foto de Web-Zoneware
✓ Verificado
🎓 Tutor & Coordenador da Web Academy

Web-Zoneware

Tutor Técnico & Desenvolvedor Full-Stack

Desenvolvedor web e instrutor focado na formação prática de novos programadores. Defensor ferrenho de código semântico, arquitetura limpa e acessibilidade W3C/WCAG, dedicando-se a construir cursos estruturados em metodologia passo a passo com execução ao vivo no Playground IDE.

Especialidades: HTML5 Semântico CSS3 & Flexbox/Grid JavaScript Moderno Acessibilidade WCAG 2.2 Didática Prática
Rolar para cima