Back to Content

HTMLOptionsCollection: selectedIndex property

files/en-us/web/api/htmloptionscollection/selectedindex/index.md

latest1.3 KB
Original Source

{{APIRef("HTML DOM")}}

The selectedIndex property of the {{DOMxRef("HTMLOptionsCollection")}} interface is the numeric index of the first selected {{HTMLElement("option")}} element, if any, or −1 if no <option> is selected. Setting this property selects the option at that index and deselects all other options in this collection, while setting it to -1 deselects any currently selected elements. It is exactly equivalent to the {{domxref("HTMLSelectElement.selectedIndex", "selectedIndex")}} property of the {{domxref("HTMLSelectElement")}} that owns this collection.

Value

A number.

Examples

js
const optionColl = document.getElementById("select").options;
console.log(`selected option: ${optionColl.selectedIndex}`); // the index of the first selected option, or -1 if no option is selected
optionColl.selectedIndex = 0; // selects the first item
optionColl.selectedIndex = -1; // deselects any selected option

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

  • {{DOMxRef("HTMLOptionsCollection.length")}}
  • {{DOMxRef("HTMLOptionsCollection.add()")}}
  • {{DOMxRef("HTMLOptionsCollection.remove()")}}
  • {{DOMxRef("HTMLOptionsCollection")}}
  • {{DOMxRef("HTMLOptionElement")}}
  • {{DOMxRef("HTMLOptGroupElement")}}
  • {{DOMxRef("HTMLSelectElement")}}