JavaScript: The Definitive Guide, Fourth Edition

Name

HTMLSelectElement.add( ) — insert an <option> element

Availability

DOM Level 1 HTML

Synopsis

void add(HTMLElement element, 
         HTMLElement before) 
    throws DOMException;

Arguments

element

The HTMLOptionElement to be added.

before

The element of the options array before which the new element should be added. If this argument is null, element is appended at the end of the options array.

Throws

This method throws a DOMException with a code of NOT_FOUND_ERR if the before argument specifies an object that is not a member of the options array.

Description

This method adds a new <option> element to this <select> element. element is an HTMLOptionElement that represents the <option> element to be added. before specifies the HTMLOptionElement before which element is to be added. If before is part of an OPTGROUP, element is always inserted as part of that same group. If before is null, element becomes the last child of the <select> element.

See Also

Select object in the client-side reference section