Document.getElementsByName()

O método**getElementsByName()** do objeto Document retorna uma coleção de elementos NodeList com um dado name (en-US) no documento.

Sintaxe

var elementos = document.getElementsByName(nome);
  • elementos é uma coleção ativa de NodeList, significando que ele atualiza automaticamente com os novos elementos com o mesmo nome que são adicionados/removidos do documento.
  • nome é um valor do atributo nome dos elemento(s).

Exemplo

html
<!doctype html>
<html lang="en">
  <title>Exemplo: usando document.getElementsByName</title>

  <input type="hidden" name="up" />
  <input type="hidden" name="down" />

  <script>
    var up_nomes = document.getElementsByName("up");
    console.log(up_nomes[0].tagName); // exibindo o campo "INPUT"
  </script>
</html>

Notas

O atributo name (en-US) pode somente ser aplicado nos documentos (X)HTML.

A coleção retornada NodeList contém todos os elementos com o respectivo nome, tal como <meta>, <object> (en-US), e até os elementos o qual não suporta o atributo nome para todos.

Aviso: O método getElementsByName trabalha diferentemente em IE10 e anteriores. Além de que, getElementsByName() também retorna elementos que tem um atributo id com o valor especificado. Seja cuidadoso para não usar a mesma string como ambos nome e id.

Aviso: O método getElementsByName trabalha diferentemente no IE. Portanto, getElementsByName() não retorna todos os elementos no qual não pode ter um atributo nome (tal como <span>).

Aviso: Ambos IE e Edge retorna um HTMLCollection, e não um NodeList

Especificações

Specification
HTML Standard
# dom-document-getelementsbyname-dev

Compatibilidade com navegadores

BCD tables only load in the browser

Veja também