Document: getElementsByName() method

The getElementsByName() method of the Document object returns a NodeList Collection of elements with a given name attribute in the document.


Syntax

getElementsByName(name)


Parameters

name

The value of the name attribute of the element(s) we are looking for.


Return value

A live NodeList collection, meaning it automatically updates as new elements with the same name are added to, or removed from, the document.


Examples

<!doctype html>
<html lang="en">
  <head>
    <title>Example: using document.getElementsByName</title>
  </head>
  <body>
    <input type="hidden" name="up" />
    <input type="hidden" name="down" />
  </body>
</html>

const up_names = document.getElementsByName("up");
console.log(up_names[0].tagName); // displays "INPUT"


Notes

The name attribute can only be applied in (X)HTML documents.

The returned NodeList Collection contains all elements with the given name, such as <meta>, <object>, and even elements which do not support the name attribute at all.


Source: Mozilla, https://developer.mozilla.org/en-US/docs/Web/API/Document/getElementsByName
Creative Commons License This work is licensed under a Creative Commons Attribution-ShareAlike 2.5 License.

Last modified: Friday, July 21, 2023, 10:23 AM