The HTMLSelectElement.namedItem()
method returns the HTMLOptionElement
corresponding to the HTMLOptionElement
whose name
or id
match the specified name, or null
if no option matches.
In JavaScript, using the array bracket syntax with a String
, like selectElt["value"]
is equivalent to selectElt
.namedItem("value")
.
Syntax
var item = collection.namedItem[str]; var item = collection[str];
Parameters
- str is a
DOMString
Return value
- item is a
HTMLOptionElement
.
Examples
<form> <select id="myFormControl" type="textarea"> <option id="o1">Opt 1</option> <option id="o2">Opt 2</option> </select> </form>
elem1 = document.forms[0]["myFormControl"]["o1"]; // Returns the HTMLOptionElement representing #o1
Specifications
Specification | Status | Comment |
---|---|---|
WHATWG HTML Living Standard The definition of 'HTMLSelectElement.namedItem()' in that specification. |
Living Standard | No change since the latest snapshot, HTML5. |
HTML5 The definition of 'HTMLSelectElement.namedItem()' in that specification. |
Recommendation | Initial definition, snapshot of WHATWG HTML Living Standard |
Browser compatibility
Feature | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Edge | Opera | Safari (WebKit) |
---|---|---|---|---|---|---|---|
Basic support | (Yes) | (Yes) | 4.0 (2.0) | (Yes)[1] | (Yes)[1] | (Yes) | ? |
Feature | Android | Edge | Firefox Mobile (Gecko) | IE Phone | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | (Yes) | (Yes) | 4.0 (2.0) | (Yes) | (Yes) | ? |
[1] Does not appear to take the name
attribute into account (only the id
attribute) on Internet Explorer and Edge. There is a bug report to Microsoft about this.
See also
HTMLSelectElement
that implements it.