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

• str is a DOMString

Return value

• item is a HTMLOptionElement.

Examples

<form>
  <select id="myFormControl">
    <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

Browser compatibility

[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.