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