com.gargoylesoftware.htmlunit.javascript.host.html

Class HTMLOptionsCollection

java.lang.Object

net.sourceforge.htmlunit.corejs.javascript.ScriptableObject

com.gargoylesoftware.htmlunit.javascript.HtmlUnitScriptable

com.gargoylesoftware.htmlunit.javascript.host.html.HTMLOptionsCollection

All Implemented Interfaces:

Serializable, Cloneable, net.sourceforge.htmlunit.corejs.javascript.ConstProperties, net.sourceforge.htmlunit.corejs.javascript.debug.DebuggableObject, net.sourceforge.htmlunit.corejs.javascript.Scriptable, net.sourceforge.htmlunit.corejs.javascript.SymbolScriptable

public class HTMLOptionsCollection
extends HtmlUnitScriptable

This is the array returned by the "options" property of Select.

Author:

David K. Taylor, Christian Sell, Marc Guillemot, Daniel Gredler, Bruce Faulkner, Ahmed Ashour, Ronald Brill

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class net.sourceforge.htmlunit.corejs.javascript.ScriptableObject

net.sourceforge.htmlunit.corejs.javascript.ScriptableObject.KeyComparator

Field Summary

Fields inherited from class net.sourceforge.htmlunit.corejs.javascript.ScriptableObject

CONST, DONTENUM, EMPTY, PERMANENT, READONLY, UNINITIALIZED_CONST

Fields inherited from interface net.sourceforge.htmlunit.corejs.javascript.Scriptable

NOT_FOUND

Constructor Summary

Constructors

Constructor and Description
HTMLOptionsCollection() Creates an instance.
HTMLOptionsCollection(HtmlUnitScriptable parentScope) Creates an instance.

Method Summary

Modifier and Type	Method and Description
void	add(Object newOptionObject, Object beforeOptionObject) Adds a new item to the option collection.
Object	get(int index, net.sourceforge.htmlunit.corejs.javascript.Scriptable start) Returns the object at the specified index.
NodeList	getChildNodes() Returns the child nodes of the current element.
String	getClassName() Returns the JavaScript class name.
int	getLength() Returns the number of elements in this array.
int	getSelectedIndex() Returns the value of the selectedIndex property.
boolean	has(int index, net.sourceforge.htmlunit.corejs.javascript.Scriptable start)
void	initialize(HtmlSelect select) Initializes this object.
Object	item(int index) Returns the object at the specified index.
void	put(int index, net.sourceforge.htmlunit.corejs.javascript.Scriptable start, Object newValue) Sets the index property.
void	put(String name, net.sourceforge.htmlunit.corejs.javascript.Scriptable start, Object value) If IE is emulated, and this class does not have the specified property, and the owning select *does* have the specified property, this method delegates the call to the parent select element.
void	remove(int index) Removes the option at the specified index.
void	setLength(int newLength) Changes the number of options: removes options if the new length is less than the current one else add new empty options to reach the new length.
void	setSelectedIndex(int index) Sets the value of the selectedIndex property.

Methods inherited from class com.gargoylesoftware.htmlunit.javascript.HtmlUnitScriptable

clone, equivalentValues, get, getBrowserVersion, getDefaultValue, getDomNodeOrDie, getDomNodeOrNull, getPrototype, getScriptableFor, getStartingScope, getWindow, getWindow, getWithPreemption, hasInstance, initParentScope, makeScriptableFor, setClassName, setDomNode, setDomNode, setParentScope

Methods inherited from class net.sourceforge.htmlunit.corejs.javascript.ScriptableObject

applyDescriptorToAttributeBitset, associateValue, avoidObjectDetection, buildDataDescriptor, callMethod, callMethod, checkPropertyChange, checkPropertyDefinition, defineClass, defineClass, defineClass, defineConst, defineConstProperty, defineFunctionProperties, defineOwnProperties, defineOwnProperty, defineOwnProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, delete, delete, delete, deleteProperty, deleteProperty, ensureScriptable, ensureScriptableObject, ensureSymbolScriptable, get, get, getAllIds, getArrayPrototype, getAssociatedValue, getAttributes, getAttributes, getAttributes, getAttributes, getAttributes, getClassPrototype, getDefaultValue, getExternalArrayData, getExternalArrayLength, getFunctionPrototype, getGeneratorFunctionPrototype, getGetterOrSetter, getGetterOrSetter, getIds, getObjectPrototype, getOwnPropertyDescriptor, getParentScope, getProperty, getProperty, getProperty, getPropertyIds, getPrototype, getTopLevelScope, getTopScopeValue, getTypedProperty, getTypedProperty, getTypeOf, has, has, hasProperty, hasProperty, hasProperty, isAccessorDescriptor, isConst, isDataDescriptor, isEmpty, isExtensible, isFalse, isGenericDescriptor, isGetterOrSetter, isSealed, isTrue, preventExtensions, put, putConst, putConstProperty, putProperty, putProperty, putProperty, querySlot, redefineProperty, sameValue, sealObject, setAttributes, setAttributes, setAttributes, setAttributes, setAttributes, setCommonDescriptorProperties, setExternalArrayData, setGetterOrSetter, setPrototype, size

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

HTMLOptionsCollection

public HTMLOptionsCollection()

Creates an instance.

HTMLOptionsCollection

public HTMLOptionsCollection(HtmlUnitScriptable parentScope)

Creates an instance.

Parameters:

parentScope - parent scope

Method Detail

getClassName

public String getClassName()

Returns the JavaScript class name.

Specified by:

getClassName in interface net.sourceforge.htmlunit.corejs.javascript.Scriptable

Overrides:

getClassName in class HtmlUnitScriptable

Returns:

the JavaScript class name

initialize

public void initialize(HtmlSelect select)

Initializes this object.

Parameters:

select - the HtmlSelect that this object will retrieve elements from

get

public Object get(int index,
                  net.sourceforge.htmlunit.corejs.javascript.Scriptable start)

Returns the object at the specified index.

Specified by:

get in interface net.sourceforge.htmlunit.corejs.javascript.Scriptable

Overrides:

get in class net.sourceforge.htmlunit.corejs.javascript.ScriptableObject

Parameters:

index - the index

start - the object that get is being called on

Returns:

the object or NOT_FOUND

put

public void put(String name,
                net.sourceforge.htmlunit.corejs.javascript.Scriptable start,
                Object value)

If IE is emulated, and this class does not have the specified property, and the owning select *does* have the specified property, this method delegates the call to the parent select element.

Specified by:

put in interface net.sourceforge.htmlunit.corejs.javascript.Scriptable

Overrides:

put in class HtmlUnitScriptable

Parameters:

name -

start -

value -

item

public Object item(int index)

Returns the object at the specified index.

Parameters:

index - the index

Returns:

the object or NOT_FOUND

put

public void put(int index,
                net.sourceforge.htmlunit.corejs.javascript.Scriptable start,
                Object newValue)

Sets the index property.

Specified by:

put in interface net.sourceforge.htmlunit.corejs.javascript.Scriptable

Overrides:

put in class net.sourceforge.htmlunit.corejs.javascript.ScriptableObject

Parameters:

index - the index

start - the scriptable object that was originally invoked for this property

newValue - the new value

getLength

public int getLength()

Returns the number of elements in this array.

Returns:

the number of elements in the array

setLength

public void setLength(int newLength)

Changes the number of options: removes options if the new length is less than the current one else add new empty options to reach the new length.

Parameters:

newLength - the new length property value

add

public void add(Object newOptionObject,
                Object beforeOptionObject)

Adds a new item to the option collection.

Implementation Note: The specification for the JavaScript add() method actually calls for the optional newIndex parameter to be an integer. However, the newIndex parameter is specified as an Object here rather than an int because of the way Rhino and HtmlUnit process optional parameters for the JavaScript method calls. If the newIndex parameter were specified as an int, then the Undefined value for an integer is specified as NaN (Not A Number, which is a Double value), but Rhino translates this value into 0 (perhaps correctly?) when converting NaN into an int. As a result, when the newIndex parameter is not specified, it is impossible to make a distinction between a caller of the form add(someObject) and add (someObject, 0). Since the behavior of these two call forms is different, the newIndex parameter is specified as an Object. If the newIndex parameter is not specified by the actual JavaScript code being run, then newIndex is of type net.sourceforge.htmlunit.corejs.javascript.Undefined. If the newIndex parameter is specified, then it should be of type java.lang.Number and can be converted into an integer value.

This method will call the put(int, Scriptable, Object) method for actually adding the element to the collection.

According to the Microsoft DHTML reference page for the JavaScript add() method of the options collection, the index parameter is specified as follows:

Optional. Integer that specifies the index position in the collection where the element is placed. If no value is given, the method places the element at the end of the collection.

Parameters:

newOptionObject - the DomNode to insert in the collection

beforeOptionObject - An optional parameter which specifies the index position in the collection where the element is placed. If no value is given, the method places the element at the end of the collection.

See Also:

put(int, Scriptable, Object)

remove

public void remove(int index)

Removes the option at the specified index.

Parameters:

index - the option index

has

public boolean has(int index,
                   net.sourceforge.htmlunit.corejs.javascript.Scriptable start)

Specified by:

has in interface net.sourceforge.htmlunit.corejs.javascript.Scriptable

Overrides:

has in class HtmlUnitScriptable

getSelectedIndex

public int getSelectedIndex()

Returns the value of the selectedIndex property.

Returns:

the selectedIndex property

setSelectedIndex

public void setSelectedIndex(int index)

Sets the value of the selectedIndex property.

Parameters:

index - the new value

getChildNodes

public NodeList getChildNodes()

Returns the child nodes of the current element.

Returns:

the child nodes of the current element