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

Example

HTML

<form>
  <select id="myFormControl">
    <option id="o1">Opt 1</option>
    <option id="o2">Opt 2</option>
  </select>
</form>

JavaScript

elem1 = document.forms[0]['myFormControl']['o1']; // Returns the HTMLOptionElement representing #o1

Specifications

Specification Status Comment
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 HTML Living Standard

Browser compatibility

DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
namedItemChrome Full support YesEdge Full support 12
Notes
Full support 12
Notes
Notes namedItem 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.
Firefox Full support 4IE Full support Yes
Notes
Full support Yes
Notes
Notes namedItem 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.
Opera Full support YesSafari Full support YesWebView Android Full support YesChrome Android Full support YesFirefox Android Full support 4Opera Android Full support YesSafari iOS Full support YesSamsung Internet Android Full support Yes

Legend

Full support
Full support
See implementation notes.
See implementation notes.

See also