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
js
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
html
<!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>
js
const up_names = document.getElementsByName("up");
console.log(up_names[0].tagName); // displays "INPUT"
Notes
Specifications
Specification |
---|
HTML Standard # dom-document-getelementsbyname-dev |
Browser compatibility
BCD tables only load in the browser
See also
-
document.getElementById()
to return a reference to an element by its uniqueid
-
document.getElementsByTagName()
to return references to elements with the same tag name -
document.querySelector()
to return references to elements via CSS selectors like'div.myclass'