Método getElementsByName() del Documento DOM HTML

Definición y uso

getElementsByName() El método devuelve una colección de elementos que tienen un nombre específico.

getElementsByName() El método devuelve en tiempo real NodeList.

NodeList

NodeList Es una colección de nodos similar a un array (lista).

Se puede acceder a los nodos de la lista mediante índice. El índice comienza en 0.

longitud El atributo devuelve el número de nodos en la lista de elementos.

Por favor, consulte también:

Método getElementById()

Método getElementsByTagName()

Método getElementsByClassName()

Método querySelector()

Método querySelectorAll()

Manual de referencia de NodeList

Ejemplo

Ejemplo 1

Obtener todos los elementos con nombre "fname":

let elements = document.getElementsByName("fname");

Intente usted mismo

Ejemplo 2

Devuelve la cantidad de elementos con name="animal":

let num = document.getElementsByName("animal").length;

Intente usted mismo

Ejemplo 3

Verificar todos los elementos <input> de tipo "checkbox" y nombre "animal":

const collection = document.getElementsByName("animal");
for (let i = 0; i < collection.length; i++) {
  if (collection[i].type == "checkbox") {
    collection[i].checked = true;
  }
}

Intente usted mismo

Sintaxis

document.getElementsByName(name)

Parámetros

Parámetros Descripción
name Obligatorio. Valor de la propiedad name del elemento.

Valor devuelto

Tipo Descripción
Objeto

Objeto NodeList.

Conjunto de elementos con nombre especificado.

Se ordenan según el orden en que los elementos aparecen en el documento.

Compatibilidad del navegador

document.getElementsByName() Es una característica del nivel DOM 1 (1998).

Se admite en todos los navegadores:

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
Soporte 9-11 Soporte Soporte Soporte Soporte