com.gargoylesoftware.htmlunit.javascript

Class SimpleScriptable

java.lang.Object

net.sourceforge.htmlunit.corejs.javascript.ScriptableObject

com.gargoylesoftware.htmlunit.javascript.HtmlUnitScriptable

com.gargoylesoftware.htmlunit.javascript.SimpleScriptable

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

Direct Known Subclasses:

AbstractList, ActiveXObject, ActiveXObjectImpl, ANGLE_instanced_arrays, Atomics, AudioBuffer, AudioListener, AudioParam, BarProp, Blob, Cache, CacheStorage, CanvasGradient, CanvasPattern, CanvasRenderingContext2D, CaretPosition, ClientRect, ClientRectList, Collator, Console, Coordinates, Credential, CredentialsContainer, Crypto, CryptoKey, CSS, CSSRule, CSSRuleList, CSSStyleDeclaration, CSSValue, CustomElementRegistry, DataTransfer, DataTransferItem, DataTransferItemList, DateTimeFormat, DOMError, DOMException, DOMImplementation, DOMMatrixReadOnly, DOMParser, DOMPointReadOnly, DOMRectReadOnly, DOMStringList, DOMStringMap, DOMTokenList, Enumerator, Event, EventTarget, EXT_texture_filter_anisotropic, External, FileList, FileSystem, FileSystemDirectoryReader, FileSystemEntry, FontFace, FormData, Gamepad, GamepadButton, Geolocation, Headers, History, HTMLOptionsCollection, IDBCursor, IDBFactory, IDBIndex, IDBKeyRange, IDBObjectStore, IdleDeadline, ImageBitmap, ImageBitmapRenderingContext, ImageData, InputDeviceCapabilities, InstallTrigger, IntersectionObserver, IntersectionObserverEntry, Intl, Iterator, KeyframeEffect, Location, MediaDeviceInfo, MediaError, MediaKeys, MediaKeyStatusMap, MediaKeySystemAccess, MediaList, MessageChannel, MIDIInputMap, MIDIOutputMap, MimeType, MozRTCIceCandidate, MozRTCSessionDescription, MSXMLScriptable, MutationObserver, MutationRecord, NamedNodeMap, Namespace, NamespaceCollection, Navigator, Netscape, NodeFilter, NodeIterator, NumberFormat, OES_element_index_uint, OES_standard_derivatives, OES_texture_float, OES_texture_float_linear, Path2D, PaymentAddress, PerformanceEntry, PerformanceNavigation, PerformanceObserver, PerformanceObserverEntryList, PerformanceTiming, PeriodicWave, Permissions, Position, PositionError, Presentation, Promise, PushManager, PushSubscription, PushSubscriptionOptions, Range, ReadableStream, Reflect, Request, Response, RTCCertificate, RTCIceCandidate, RTCSessionDescription, RTCStatsReport, Screen, Selection, SharedArrayBuffer, SimpleArray, SpeechSynthesisVoice, Storage, StorageManager, StyleMedia, StyleSheet, StyleSheetList, SubtleCrypto, SVGAngle, SVGAnimatedAngle, SVGAnimatedBoolean, SVGAnimatedEnumeration, SVGAnimatedInteger, SVGAnimatedLength, SVGAnimatedLengthList, SVGAnimatedNumber, SVGAnimatedNumberList, SVGAnimatedPreserveAspectRatio, SVGAnimatedRect, SVGAnimatedString, SVGAnimatedTransformList, SVGLength, SVGLengthList, SVGMatrix, SVGNumber, SVGNumberList, SVGPathSeg, SVGPathSegList, SVGPoint, SVGPointList, SVGPreserveAspectRatio, SVGRect, SVGStringList, SVGTransform, SVGTransformList, SVGUnitTypes, SyncManager, TextDecoder, TextEncoder, TextMetrics, TextRange, TextTrackCueList, TimeRanges, Touch, TouchList, TreeWalker, URL, URLSearchParams, V8BreakIterator, ValidityState, VideoPlaybackQuality, WEBGL_compressed_texture_s3tc, WEBGL_debug_renderer_info, WebGL2RenderingContext, WebGLActiveInfo, WebGLBuffer, WebGLFramebuffer, WebGLProgram, WebGLQuery, WebGLRenderbuffer, WebGLRenderingContext, WebGLSampler, WebGLShader, WebGLShaderPrecisionFormat, WebGLSync, WebGLTexture, WebGLTransformFeedback, WebGLUniformLocation, WebGLVertexArrayObject, WebkitSpeechGrammar, WebkitSpeechGrammarList, XMLSerializer, XPathEvaluator, XPathExpression, XPathNSResolver, XPathResult, XSLTProcessor

public class SimpleScriptable
extends HtmlUnitScriptable
implements Cloneable

Base class for Rhino host objects in HtmlUnit.

Author:

Mike Bowler, David K. Taylor, Marc Guillemot, Chris Erskine, Daniel Gredler, 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
SimpleScriptable()

Method Summary

Modifier and Type	Method and Description
SimpleScriptable	clone()
protected Object	equivalentValues(Object value)
Object	get(String name, net.sourceforge.htmlunit.corejs.javascript.Scriptable start) Gets a named property from the object.
BrowserVersion	getBrowserVersion() Gets the browser version currently used.
Object	getDefaultValue(Class<?> hint) Returns the JavaScript default value of this object.
DomNode	getDomNodeOrDie() Returns the DOM node that corresponds to this JavaScript object or throw an exception if one cannot be found.
DomNode	getDomNodeOrNull() Returns the DOM node that corresponds to this JavaScript object or null if a node hasn't been set.
net.sourceforge.htmlunit.corejs.javascript.Scriptable	getPrototype(Class<? extends SimpleScriptable> javaScriptClass) Gets the prototype object for the given host class.
protected SimpleScriptable	getScriptableFor(Object object) Returns the JavaScript object that corresponds to the specified object.
protected net.sourceforge.htmlunit.corejs.javascript.Scriptable	getStartingScope() Gets the scriptable used at starting scope for the execution of current script.
Window	getWindow() Gets the window that is the top scope for this object.
protected static Window	getWindow(net.sourceforge.htmlunit.corejs.javascript.Scriptable s) Gets the window that is the top scope for the specified object.
protected Object	getWithPreemption(String name) Called by get(String, Scriptable) to allow retrieval of the property before the prototype chain is searched.
boolean	has(int index, net.sourceforge.htmlunit.corejs.javascript.Scriptable start)
boolean	hasInstance(net.sourceforge.htmlunit.corejs.javascript.Scriptable instance)
protected void	initParentScope(DomNode domNode, SimpleScriptable scriptable) Initialize the parent scope of a newly created scriptable.
protected boolean	isReadOnlySettable(String name, Object value)
SimpleScriptable	makeScriptableFor(DomNode domNode) Builds a new the JavaScript object that corresponds to the specified object.
void	setCaseSensitive(boolean caseSensitive) Sets case sensitivity of all properties of this scriptable.
void	setDomNode(DomNode domNode) Sets the DOM node that corresponds to this JavaScript object.
protected void	setDomNode(DomNode domNode, boolean assignScriptObject) Sets the DOM node that corresponds to this JavaScript object.
void	setHtmlElement(HtmlElement htmlElement) Sets the HTML element that corresponds to this JavaScript object.

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

defineFunctionProperties, defineProperty, getClassName, put, setClassName, setParentScope

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

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

Methods inherited from class java.lang.Object

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

Constructor Detail

SimpleScriptable

public SimpleScriptable()

Method Detail

get

public Object get(String name,
                  net.sourceforge.htmlunit.corejs.javascript.Scriptable start)

Gets a named property from the object. Normally HtmlUnit objects don't need to overwrite this method as properties are defined on the prototypes from the XML configuration. In some cases where "content" of object has priority compared to the properties consider using utility getWithPreemption(String).

Specified by:

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

Overrides:

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

getWithPreemption

protected Object getWithPreemption(String name)

Called by 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!

Parameters:

name - the property name

Returns:

Scriptable.NOT_FOUND if not found

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 net.sourceforge.htmlunit.corejs.javascript.ScriptableObject

getDomNodeOrDie

public DomNode getDomNodeOrDie()

Returns the DOM node that corresponds to this JavaScript object or throw an exception if one cannot be found.

Returns:

the DOM node

getDomNodeOrNull

public DomNode getDomNodeOrNull()

Returns the DOM node that corresponds to this JavaScript object or null if a node hasn't been set.

Returns:

the DOM node or null

setDomNode

public void setDomNode(DomNode domNode)

Sets the DOM node that corresponds to this JavaScript object.

Parameters:

domNode - the DOM node

setDomNode

protected void setDomNode(DomNode domNode,
                          boolean assignScriptObject)

Sets the DOM node that corresponds to this JavaScript object.

Parameters:

domNode - the DOM node

assignScriptObject - If true, call setScriptObject on domNode

setHtmlElement

public void setHtmlElement(HtmlElement htmlElement)

Sets the HTML element that corresponds to this JavaScript object.

Parameters:

htmlElement - the HTML element

getScriptableFor

protected SimpleScriptable getScriptableFor(Object object)

Returns the JavaScript object that corresponds to the specified object. New JavaScript objects will be created as needed. If a JavaScript object cannot be created for a domNode then NOT_FOUND will be returned.

Parameters:

object - a DomNode or a WebWindow

Returns:

the JavaScript object or NOT_FOUND

makeScriptableFor

public SimpleScriptable makeScriptableFor(DomNode domNode)

Builds a new the JavaScript object that corresponds to the specified object.

Parameters:

domNode - the DOM node for which a JS object should be created

Returns:

the JavaScript object

initParentScope

protected void initParentScope(DomNode domNode,
                               SimpleScriptable scriptable)

Initialize the parent scope of a newly created scriptable.

Parameters:

domNode - the DOM node for the script object

scriptable - the script object to initialize

getPrototype

public net.sourceforge.htmlunit.corejs.javascript.Scriptable getPrototype(Class<? extends SimpleScriptable> javaScriptClass)

Gets the prototype object for the given host class.

Parameters:

javaScriptClass - the host class

Returns:

the prototype

getDefaultValue

public Object getDefaultValue(Class<?> hint)

Returns the JavaScript default value of this object. This is the JavaScript equivalent of a toString() in Java.

Specified by:

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

Overrides:

getDefaultValue in class HtmlUnitScriptable

Parameters:

hint - a hint as to the format of the default value (ignored in this case)

Returns:

the default value

getWindow

public Window getWindow()
                 throws RuntimeException

Gets the window that is the top scope for this object.

Returns:

the window associated with this object

Throws:

RuntimeException - if the window cannot be found, which should never occur

getWindow

protected static Window getWindow(net.sourceforge.htmlunit.corejs.javascript.Scriptable s)
                           throws RuntimeException

Gets the window that is the top scope for the specified object.

Parameters:

s - the JavaScript object whose associated window is to be returned

Returns:

the window associated with the specified JavaScript object

Throws:

RuntimeException - if the window cannot be found, which should never occur

getStartingScope

protected net.sourceforge.htmlunit.corejs.javascript.Scriptable getStartingScope()

Gets the scriptable used at starting scope for the execution of current script.

Returns:

the scope as defined in JavaScriptEngine.callFunction(com.gargoylesoftware.htmlunit.html.HtmlPage, net.sourceforge.htmlunit.corejs.javascript.Function, net.sourceforge.htmlunit.corejs.javascript.Scriptable, java.lang.Object[], com.gargoylesoftware.htmlunit.html.DomNode) or JavaScriptEngine.execute(com.gargoylesoftware.htmlunit.html.HtmlPage, java.lang.String, java.lang.String, int).

getBrowserVersion

public BrowserVersion getBrowserVersion()

Gets the browser version currently used.

Returns:

the browser version

hasInstance

public boolean hasInstance(net.sourceforge.htmlunit.corejs.javascript.Scriptable instance)

Specified by:

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

Overrides:

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

equivalentValues

protected Object equivalentValues(Object value)

Overrides:

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

clone

public SimpleScriptable clone()

Overrides:

clone in class Object

setCaseSensitive

public void setCaseSensitive(boolean caseSensitive)

Sets case sensitivity of all properties of this scriptable.

Parameters:

caseSensitive - case sensitive or no

isReadOnlySettable

protected boolean isReadOnlySettable(String name,
                                     Object value)

Overrides:

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