public class HTMLOptionsCollection extends HtmlUnitScriptable
org.htmlunit.corejs.javascript.ScriptableObject.KeyComparator
CONST, DONTENUM, EMPTY, PERMANENT, READONLY, UNINITIALIZED_CONST
NOT_FOUND
Constructor and Description |
---|
HTMLOptionsCollection()
Creates an instance.
|
HTMLOptionsCollection(HtmlUnitScriptable parentScope)
Creates an instance.
|
Modifier and Type | Method and Description |
---|---|
void |
add(Object newOptionObject,
Object beforeOptionObject)
Adds a new item to the option collection.
|
Object |
get(int index,
org.htmlunit.corejs.javascript.Scriptable start)
Returns the object at the specified index.
|
int |
getLength()
Returns the number of elements in this array.
|
int |
getSelectedIndex()
Returns the value of the
selectedIndex property. |
void |
initialize(HtmlSelect select)
Initializes this object.
|
Object |
item(int index)
Returns the object at the specified index.
|
org.htmlunit.corejs.javascript.Scriptable |
iterator() |
void |
jsConstructor()
JavaScript constructor.
|
void |
put(int index,
org.htmlunit.corejs.javascript.Scriptable start,
Object newValue)
Sets the index property.
|
void |
put(String name,
org.htmlunit.corejs.javascript.Scriptable start,
Object value) |
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. |
clone, equivalentValues, get, getBrowserVersion, getClassName, getDefaultValue, getDomNodeOrDie, getDomNodeOrNull, getPrototype, getScriptableFor, getWindow, getWindow, getWindowFromTopCallScope, getWithPreemption, has, hasInstance, initParentScope, makeScriptableFor, setClassName, setDomNode, setDomNode, setParentScope, setupPromise, setupRejectedPromise
applyDescriptorToAttributeBitset, associateValue, avoidObjectDetection, buildDataDescriptor, callMethod, callMethod, checkPropertyChange, checkPropertyDefinition, defineClass, defineClass, defineClass, defineConst, defineConstProperty, defineFunctionProperties, defineOwnProperties, defineOwnProperty, defineOwnProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, delete, delete, delete, deleteProperty, 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
public HTMLOptionsCollection()
public HTMLOptionsCollection(HtmlUnitScriptable parentScope)
parentScope
- parent scopepublic void jsConstructor()
public void initialize(HtmlSelect select)
select
- the HtmlSelect that this object will retrieve elements frompublic Object get(int index, org.htmlunit.corejs.javascript.Scriptable start)
get
in interface org.htmlunit.corejs.javascript.Scriptable
get
in class org.htmlunit.corejs.javascript.ScriptableObject
index
- the indexstart
- the object that get is being called onpublic void put(String name, org.htmlunit.corejs.javascript.Scriptable start, Object value)
put
in interface org.htmlunit.corejs.javascript.Scriptable
put
in class HtmlUnitScriptable
public Object item(int index)
index
- the indexpublic void put(int index, org.htmlunit.corejs.javascript.Scriptable start, Object newValue)
put
in interface org.htmlunit.corejs.javascript.Scriptable
put
in class org.htmlunit.corejs.javascript.ScriptableObject
index
- the indexstart
- the scriptable object that was originally invoked for this propertynewValue
- the new valuepublic int getLength()
public void setLength(int newLength)
newLength
- the new length property valuepublic void add(Object newOptionObject, Object beforeOptionObject)
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 org.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.
newOptionObject
- the DomNode to insert in the collectionbeforeOptionObject
- 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.put(int, Scriptable, Object)
public void remove(int index)
index
- the option indexpublic int getSelectedIndex()
selectedIndex
property.selectedIndex
propertypublic void setSelectedIndex(int index)
selectedIndex
property.index
- the new valuepublic org.htmlunit.corejs.javascript.Scriptable iterator()
Copyright © 2002–2024 Gargoyle Software Inc.. All rights reserved.