Document.getElementsByName()

Baseline Widely available

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

O método**getElementsByName()** do objeto Document retorna uma coleção de elementos NodeList com um dado name 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 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>, 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
# dom-document-getelementsbyname-dev

Compatibilidade com navegadores

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
getElementsByName

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
See implementation notes.
Has more compatibility info.

Veja também