HTMLSelectElement.namedItem()

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

Return value

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 Firefox (Gecko) Internet Explorer Edge Opera Safari (WebKit)
Basic support (Yes) 4.0 (2.0) (Yes)[1] (Yes)[1] (Yes) ?
Feature Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Basic support (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

License

© 2016 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-us/docs/web/api/htmlselectelement/nameditem