HTMLOptionsCollection

{{ APIRef("HTML DOM") }}

The HTMLOptionsCollection interface represents a collection of <option> HTML elements (in document order) and offers methods and properties for selecting from the list as well as optionally altering its items. This object is returned only by the options property of select.

{{InheritanceDiagram}}

Instance properties

• {{domxref("HTMLOptionsCollection.length")}}
  • : Returns or sets the number of options in the collection.
• {{domxref("HTMLOptionsCollection.selectedIndex")}}
  • : The index number of the first selected {{HTMLElement("option")}} element. The value -1 indicates no element is selected.

Instance methods

This interface inherits the methods of its parent, HTMLCollection.

• {{domxref("HTMLOptionsCollection.add()")}}
  • : Appends an {{domxref("HTMLOptionElement")}} or {{domxref("HTMLOptGroupElement")}} element to the collection of option elements or adds it before a specified option.
• {{domxref("HTMLOptionsCollection.remove()")}}
  • : Removes the element at the specified index from the options collection.

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

• {{DOMxRef("HTMLOptionElement")}}
• {{DOMxRef("HTMLCollection")}}
• {{DOMxRef("HTMLOptGroupElement")}}
• {{DOMxRef("HTMLSelectElement")}}
• Indexed collections guide