The getElementsByName()
method of the Document
object returns a NodeList
Collection of elements with a given name
in the document.
Syntax
var elements = document.getElementsByName(name);
- elements is a live
NodeList
Collection, meaning it automatically updates as new elements with the samename
are added to/removed from the document. - name is the value of the
name
attribute of the element(s).
Example
<!DOCTYPE html> <html lang="en"> <title>Example: using document.getElementsByName</title> <input type="hidden" name="up"> <input type="hidden" name="down"> <script> var up_names = document.getElementsByName("up"); console.log(up_names[0].tagName); // displays "INPUT" </script> </html>
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.
The getElementsByName method works differently in IE10 and below. There, getElementsByName()
also returns elements that have an id
attribute with the specified value. Be careful not to use the same string as both a name
and an id
.
The getElementsByName method works differently in IE. There, getElementsByName()
does not return all elements which may not have a name
attribute (such as <span>
).
Both IE and Edge return an HTMLCollection
, not a NodeList
Specifications
Specification | Status | Comment |
---|---|---|
HTML Living Standard The definition of 'Document.getElementsByName()' in that specification. |
Living Standard | |
Document Object Model (DOM) Level 2 HTML Specification The definition of 'Document.getElementsByName()' in that specification. |
Obsolete | Initial definition |
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
getElementsByName | Chrome Full support 1 | Edge
Full support
12
| Firefox Full support 1 | IE
Full support
5
| Opera Full support 5 | Safari Full support 1 | WebView Android Full support 1 | Chrome Android Full support 18 | Firefox Android Full support 4 | Opera Android Full support 10.1 | Safari iOS Full support 1 | Samsung Internet Android Full support 1.0 |
Legend
- Full support
- Full support
- See implementation notes.
- See implementation notes.
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 namedocument.querySelector()
to return references to elements via CSS selectors like'div.myclass'