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>, 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

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
getElementsByNameChrome Full support 1Edge Full support 12
Notes
Full support 12
Notes
Notes Returns an HTMLCollection, not a NodeList
Firefox Full support YesIE Full support Yes
Notes
Full support Yes
Notes
Notes Returns an HTMLCollection, not a NodeList
Opera Full support YesSafari Full support YesWebView Android Full support YesChrome Android Full support YesFirefox Android Full support YesOpera Android Full support YesSafari iOS Full support YesSamsung Internet Android ?

Legend

Full support  
Full support
Compatibility unknown  
Compatibility unknown
See implementation notes.
See implementation notes.

Veja também