com.gargoylesoftware.htmlunit.javascript.host.dom

Class AbstractList

java.lang.Object

net.sourceforge.htmlunit.corejs.javascript.ScriptableObject

com.gargoylesoftware.htmlunit.javascript.HtmlUnitScriptable

com.gargoylesoftware.htmlunit.javascript.SimpleScriptable

com.gargoylesoftware.htmlunit.javascript.host.dom.AbstractList

All Implemented Interfaces:

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

Direct Known Subclasses:

HTMLCollection, NodeList

public class AbstractList
extends SimpleScriptable
implements net.sourceforge.htmlunit.corejs.javascript.Function

The parent class of NodeList and HTMLCollection.

Author:

Daniel Gredler, Marc Guillemot, Chris Erskine, Ahmed Ashour, Frank Danek

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	AbstractList.EffectOnCache Cache effect of some changes.

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

Modifier	Constructor and Description
	AbstractList() Creates an instance.
	AbstractList(DomNode domeNode, boolean attributeChangeSensitive) Creates an instance.
protected	AbstractList(DomNode domNode, List<?> initialElements) Creates an instance with an initial cache value.

Method Summary

Methods

Modifier and Type	Method and Description
protected void	addElementIds(List<String> idList, List<Object> elements) Adds the ids of the collection's elements to the idList.
boolean	avoidObjectDetection() Only needed to make collections like document.all available but "invisible" when simulating Firefox.
Object	call(net.sourceforge.htmlunit.corejs.javascript.Context cx, net.sourceforge.htmlunit.corejs.javascript.Scriptable scope, net.sourceforge.htmlunit.corejs.javascript.Scriptable thisObj, Object[] args)
protected List<Object>	computeElements() Returns the elements whose associated host objects are available through this collection.
net.sourceforge.htmlunit.corejs.javascript.Scriptable	construct(net.sourceforge.htmlunit.corejs.javascript.Context cx, net.sourceforge.htmlunit.corejs.javascript.Scriptable scope, Object[] args)
protected AbstractList	create(DomNode parentScope, List<?> initialElements) Constructs a new instance with an initial cache value.
protected Object	equivalentValues(Object other) Called for the js "==".
Object	get(int index, net.sourceforge.htmlunit.corejs.javascript.Scriptable start) Returns the element at the specified index, or Scriptable.NOT_FOUND if the index is invalid.
protected Iterable<DomNode>	getCandidates() Gets the DOM node that have to be examined to see if they are matching.
protected AbstractList.EffectOnCache	getEffectOnCache(HtmlAttributeChangeEvent event) Gets the effect of the change on an attribute of the reference node on this collection's cache.
List<Object>	getElements() Gets the HTML elements from cache or retrieve them at first call.
Object[]	getIds() .
int	getLength() Returns the length.
protected net.sourceforge.htmlunit.corejs.javascript.Scriptable	getScriptableForElement(Object object) Gets the scriptable for the provided element that may already be the right scriptable.
protected Object	getWithPreemption(String name) Returns the element or elements that match the specified key.
protected Object	getWithPreemptionByName(String name, List<Object> elements) Helper for getWithPreemption(String) when finding by id doesn't get results.
boolean	has(int index, net.sourceforge.htmlunit.corejs.javascript.Scriptable start)
boolean	has(String name, net.sourceforge.htmlunit.corejs.javascript.Scriptable start)
protected boolean	isMatching(DomNode node) Indicates if the node should belong to the collection.
Object	item(Object index) Returns the item or items corresponding to the specified index or key.
void	setAvoidObjectDetection(boolean newValue)
protected void	setDomNode(DomNode domNode, boolean assignScriptObject) Sets the DOM node that corresponds to this JavaScript object.
String	toString()

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

clone, get, getBrowserVersion, getDefaultValue, getDomNodeOrDie, getDomNodeOrNull, getPrototype, getScriptableFor, getStartingScope, getWindow, getWindow, hasInstance, initParentScope, isReadOnlySettable, makeScriptableFor, setCaseSensitive, setDomNode, setHtmlElement

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

defineFunctionProperties, defineProperty, getClassName, setClassName, setParentScope

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

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

Methods inherited from class java.lang.Object

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

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

delete, delete, get, getClassName, getDefaultValue, getParentScope, getPrototype, hasInstance, put, put, setParentScope, setPrototype

Constructor Detail

AbstractList

public AbstractList()

Creates an instance.

AbstractList

public AbstractList(DomNode domeNode,
            boolean attributeChangeSensitive)

Creates an instance.

Parameters:

domeNode - the DomNode

attributeChangeSensitive - indicates if the content of the collection may change when an attribute of a descendant node of parentScope changes (attribute added, modified or removed)

AbstractList

protected AbstractList(DomNode domNode,
            List<?> initialElements)

Creates an instance with an initial cache value.

Parameters:

domNode - the DomNode

initialElements - the initial content for the cache

Method Detail

avoidObjectDetection

public boolean avoidObjectDetection()

Only needed to make collections like document.all available but "invisible" when simulating Firefox.

Overrides:

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

setAvoidObjectDetection

public void setAvoidObjectDetection(boolean newValue)

Parameters:

newValue - the new value

call

public Object call(net.sourceforge.htmlunit.corejs.javascript.Context cx,
          net.sourceforge.htmlunit.corejs.javascript.Scriptable scope,
          net.sourceforge.htmlunit.corejs.javascript.Scriptable thisObj,
          Object[] args)

Specified by:

call in interface net.sourceforge.htmlunit.corejs.javascript.Callable

Specified by:

call in interface net.sourceforge.htmlunit.corejs.javascript.Function

construct

public final net.sourceforge.htmlunit.corejs.javascript.Scriptable construct(net.sourceforge.htmlunit.corejs.javascript.Context cx,
                                                              net.sourceforge.htmlunit.corejs.javascript.Scriptable scope,
                                                              Object[] args)

Specified by:

construct in interface net.sourceforge.htmlunit.corejs.javascript.Function

get

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

Returns the element at the specified index, or Scriptable.NOT_FOUND if the index is invalid.

Specified by:

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

Overrides:

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

setDomNode

protected void setDomNode(DomNode domNode,
              boolean assignScriptObject)

Description copied from class: SimpleScriptable

Sets the DOM node that corresponds to this JavaScript object.

Overrides:

setDomNode in class SimpleScriptable

Parameters:

domNode - the DOM node

assignScriptObject - If true, call setScriptObject on domNode

getElements

public List<Object> getElements()

Gets the HTML elements from cache or retrieve them at first call.

Returns:

the list of HtmlElement contained in this collection

computeElements

protected List<Object> computeElements()

Returns the elements whose associated host objects are available through this collection.

Returns:

the elements whose associated host objects are available through this collection

getCandidates

protected Iterable<DomNode> getCandidates()

Gets the DOM node that have to be examined to see if they are matching. Default implementation looks at all descendants of reference node.

Returns:

the nodes

isMatching

protected boolean isMatching(DomNode node)

Indicates if the node should belong to the collection. Belongs to the refactoring effort to improve HTMLCollection's performance.

Parameters:

node - the node to test. Will be a child node of the reference node.

Returns:

false here as subclasses for concrete collections should decide it.

getWithPreemption

protected Object getWithPreemption(String name)

Returns the element or elements that match the specified key. If it is the name of a property, the property value is returned. If it is the id of an element in the array, that element is returned. Finally, if it is the name of an element or elements in the array, then all those elements are returned. Otherwise, Scriptable.NOT_FOUND is returned.

Called by SimpleScriptable.get(String, Scriptable) to allow retrieval of the property before the prototype chain is searched.

IMPORTANT: This method is invoked *very* often by Rhino. If you override this method, the implementation needs to be as fast as possible!

Overrides:

getWithPreemption in class SimpleScriptable

Parameters:

name - the property name

Returns:

Scriptable.NOT_FOUND if not found

create

protected AbstractList create(DomNode parentScope,
                  List<?> initialElements)

Constructs a new instance with an initial cache value.

Parameters:

parentScope - the parent scope, on which we listen for changes

initialElements - the initial content for the cache

Returns:

the newly created instance

getWithPreemptionByName

protected Object getWithPreemptionByName(String name,
                             List<Object> elements)

Helper for getWithPreemption(String) when finding by id doesn't get results.

Parameters:

name - the property name

elements - the children elements.

Returns:

Scriptable.NOT_FOUND if not found

getLength

public final int getLength()

Returns the length.

Returns:

the length

item

public Object item(Object index)

Returns the item or items corresponding to the specified index or key.

Parameters:

index - the index or key corresponding to the element or elements to return

Returns:

the element or elements corresponding to the specified index or key

See Also:

MSDN doc

toString

public String toString()

Overrides:

toString in class Object

equivalentValues

protected Object equivalentValues(Object other)

Called for the js "==".

Overrides:

equivalentValues in class SimpleScriptable

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 SimpleScriptable

has

public boolean has(String name,
          net.sourceforge.htmlunit.corejs.javascript.Scriptable start)

Specified by:

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

Overrides:

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

getIds

public Object[] getIds()

.

Specified by:

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

Overrides:

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

addElementIds

protected void addElementIds(List<String> idList,
                 List<Object> elements)

Adds the ids of the collection's elements to the idList.

Parameters:

idList - the list to add the ids to

elements - the collection's elements

getEffectOnCache

protected AbstractList.EffectOnCache getEffectOnCache(HtmlAttributeChangeEvent event)

Gets the effect of the change on an attribute of the reference node on this collection's cache.

Parameters:

event - the change event

Returns:

the effect on cache

getScriptableForElement

protected net.sourceforge.htmlunit.corejs.javascript.Scriptable getScriptableForElement(Object object)

Gets the scriptable for the provided element that may already be the right scriptable.

Parameters:

object - the object for which to get the scriptable

Returns:

the scriptable