Document.getElementsByName()

O métodogetElementsByName() 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

<!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> (en-US), e até os elementos o qual não suporta o atributo nome para todos.

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.

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>).

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

Especificações

Epecificação	Status	Comentário
HTML Living Standard The definition of 'Document.getElementsByName()' in that specification.	Padrão em tempo real
Document Object Model (DOM) Level 2 HTML Specification The definition of 'Document.getElementsByName()' in that specification.	Obsoleto	Definição Inicial

Compatibilidade com Nagevagores

BCD tables only load in the browser

Veja também

document.getElementById() para retornar uma referência para um elemento por um único id
document.getElementsByTagName() para retornar referências para elementos com o mesmo nome tag
document.querySelector() para retornar referências para elementos via seletores CSS como 'div.myclass'