Package org.htmlunit.javascript
Class JavaScriptEngine
java.lang.Object
org.htmlunit.javascript.JavaScriptEngine
- All Implemented Interfaces:
AbstractJavaScriptEngine<org.htmlunit.corejs.javascript.Script>
public class JavaScriptEngine
extends Object
implements AbstractJavaScriptEngine<org.htmlunit.corejs.javascript.Script>
A wrapper for the Rhino JavaScript engine
that provides browser specific features.
Like all classes in this package, this class is not intended for direct use and may change without notice.
- See Also:
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionprivate class
Facility for ContextAction usage. -
Field Summary
FieldsModifier and TypeFieldDescriptionprivate HtmlUnitContextFactory
static final Object[]
ScriptRuntime.emptyArgs.private boolean
private JavaScriptExecutor
The JavaScriptExecutor corresponding to all windows of this Web clientprivate ThreadLocal
<Boolean> private JavaScriptConfiguration
static final String
Key used to place theHtmlPage
for which the JavaScript code is executed as thread local attribute in current context.static final String
Key used to place the scope in which the execution of some JavaScript code started as thread local attribute in current context.private static final org.apache.commons.logging.Log
private ThreadLocal
<List<PostponedAction>> private boolean
static final Object
org.htmlunit.corejs.javascript.Undefined.instance.private WebClient
-
Constructor Summary
ConstructorsConstructorDescriptionJavaScriptEngine
(WebClient webClient) Creates an instance for the specifiedWebClient
. -
Method Summary
Modifier and TypeMethodDescriptionprivate static void
additionalCtor
(Window window, Map<String, org.htmlunit.corejs.javascript.Scriptable> prototypesPerJSName, Method ctorMethod, String prop, String clazzName) void
addPostponedAction
(PostponedAction action) Adds an action that should be executed first when the script currently being executed has finished.static void
applyPolyfills
(WebClient webClient, BrowserVersion browserVersion, org.htmlunit.corejs.javascript.Context context, HtmlUnitScriptable scriptable) INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.static org.htmlunit.corejs.javascript.RhinoException
asJavaScriptException
(Window window, DOMException exception) INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
Encapsulates the givenDOMException
into a Rhino-compatible exception.callFunction
(HtmlPage page, org.htmlunit.corejs.javascript.Function javaScriptFunction, org.htmlunit.corejs.javascript.Scriptable thisObject, Object[] args, DomNode node) Calls a JavaScript function and return the result.callFunction
(HtmlPage page, org.htmlunit.corejs.javascript.Function function, org.htmlunit.corejs.javascript.Scriptable scope, org.htmlunit.corejs.javascript.Scriptable thisObject, Object[] args) Calls the given function taking care of synchronization issues.final <T> T
callSecured
(org.htmlunit.corejs.javascript.ContextAction<T> action, HtmlPage page) Forwards this to theHtmlUnitContextFactory
but with checking shutdown handling.org.htmlunit.corejs.javascript.Script
Deprecated.org.htmlunit.corejs.javascript.Script
compile
(HtmlPage owningPage, org.htmlunit.corejs.javascript.Scriptable scope, String sourceCode, String sourceName, int startLine) Compiles the specified JavaScript code in the context of a given scope.static HtmlUnitScriptable
configureClass
(ClassConfiguration config, org.htmlunit.corejs.javascript.Scriptable window, BrowserVersion browserVersion) Configures the specified class for access via JavaScript.private static void
configureConstants
(ClassConfiguration config, org.htmlunit.corejs.javascript.ScriptableObject scriptable) private static void
configureConstantsPropertiesAndFunctions
(ClassConfiguration config, org.htmlunit.corejs.javascript.ScriptableObject scriptable) Configures constants, properties and functions on the object.private static void
configureConstantsStaticPropertiesAndStaticFunctions
(ClassConfiguration config, org.htmlunit.corejs.javascript.ScriptableObject scriptable) Configures constants, static properties and static functions on the object.private static void
configureFunctions
(ClassConfiguration config, org.htmlunit.corejs.javascript.ScriptableObject scriptable) private static void
configureProperties
(ClassConfiguration config, org.htmlunit.corejs.javascript.ScriptableObject scriptable) static void
configureRhino
(WebClient webClient, BrowserVersion browserVersion, HtmlUnitScriptable scriptable) INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.private static void
configureStaticFunctions
(ClassConfiguration config, org.htmlunit.corejs.javascript.ScriptableObject scriptable) private static void
configureStaticProperties
(ClassConfiguration config, org.htmlunit.corejs.javascript.ScriptableObject scriptable) private static void
configureSymbolConstants
(ClassConfiguration config, org.htmlunit.corejs.javascript.ScriptableObject scriptable) private static void
configureSymbols
(ClassConfiguration config, org.htmlunit.corejs.javascript.ScriptableObject scriptable) static org.htmlunit.corejs.javascript.EcmaError
constructError
(String error, String message) private static void
defineConstructor
(Window window, org.htmlunit.corejs.javascript.Scriptable prototype, org.htmlunit.corejs.javascript.ScriptableObject constructor) private static void
deleteProperties
(org.htmlunit.corejs.javascript.Scriptable scope, String... propertiesToDelete) Deletes the properties with the provided names.(package private) void
static String
evaluateProxyAutoConfig
(BrowserVersion browserVersion, String content, URL url) Evaluates theFindProxyForURL
method of the specified content.Deprecated.Deprecated.execute
(HtmlPage page, org.htmlunit.corejs.javascript.Scriptable scope, String sourceCode, String sourceName, int startLine) Executes the specified JavaScript code in the context of a given page.execute
(HtmlPage page, org.htmlunit.corejs.javascript.Scriptable scope, org.htmlunit.corejs.javascript.Script script) Executes the specified JavaScript code in the context of a given page.Class
<? extends HtmlUnitScriptable> getJavaScriptClass
(Class<?> c) Gets the class of the JavaScript object for the node class.Gets the associated configuration.Returns the JavaScriptExecutor.long
Returns the javascript timeout.private static org.htmlunit.corejs.javascript.Scriptable
private WebClient
Returns the web client that this engine is associated with.protected void
handleJavaScriptException
(ScriptException scriptException, boolean triggerOnError) Handles an exception that occurred during execution of JavaScript code.protected void
Handles an exception that occurred during execution of JavaScript code.void
INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
Indicates that no postponed action should be executed.private void
Initializes all the JS stuff for the window.void
initialize
(WebWindow webWindow, Page page) Performs initialization for the given webWindow.private void
static boolean
boolean
Indicates if JavaScript is running in current thread.static boolean
isUndefined
(Object obj) static org.htmlunit.corejs.javascript.Scriptable
newArray
(org.htmlunit.corejs.javascript.Scriptable scope, int length) Create an array with a specified initial length.static org.htmlunit.corejs.javascript.Scriptable
Create an array with a specified initial length.static org.htmlunit.corejs.javascript.Scriptable
newArrayIteratorTypeEntries
(org.htmlunit.corejs.javascript.Scriptable scope, org.htmlunit.corejs.javascript.Scriptable arrayLike) INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
Create a new ArrayIterator of type NativeArrayIterator.ARRAY_ITERATOR_TYPE.ENTRIESstatic org.htmlunit.corejs.javascript.Scriptable
newArrayIteratorTypeKeys
(org.htmlunit.corejs.javascript.Scriptable scope, org.htmlunit.corejs.javascript.Scriptable arrayLike) INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
Create a new ArrayIterator of type NativeArrayIterator.ARRAY_ITERATOR_TYPE.KEYSstatic org.htmlunit.corejs.javascript.Scriptable
newArrayIteratorTypeValues
(org.htmlunit.corejs.javascript.Scriptable scope, org.htmlunit.corejs.javascript.Scriptable arrayLike) INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
Create a new ArrayIterator of type NativeArrayIterator.ARRAY_ITERATOR_TYPE.VALUESvoid
Disable starting of new js threads.void
INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
Process postponed actions, if any.static org.htmlunit.corejs.javascript.EcmaError
rangeError
(String message) Report a runtime error using the error reporter for the current thread.private void
Re-initializes transient fields when an object of this type is deserialized.void
registerWindowAndMaybeStartEventLoop
(WebWindow webWindow) Register WebWindow with the JavaScriptExecutor.private static void
removePrototypeProperties
(org.htmlunit.corejs.javascript.Scriptable scope, String className, String... properties) Removes prototype properties.static RuntimeException
reportRuntimeError
(String message) Report a runtime error using the error reporter for the current thread.void
setJavaScriptTimeout
(long timeout) Sets the javascript timeout.void
shutdown()
Shutdown the JavaScriptEngine.static RuntimeException
Rethrow the exception wrapping it as the script runtime exception.static boolean
Convert the value to a JavaScript boolean value.static int
static double
static double
static double
Convert the value to a JavaScript Number value.static String
Convert the value to a JavaScript String value.static org.htmlunit.corejs.javascript.EcmaError
Report a runtime error using the error reporter for the current thread.static String
uncompressJavaScript
(String scriptSource, String scriptName) Tries to uncompress the JavaScript code in the provided response.
-
Field Details
-
LOG
private static final org.apache.commons.logging.Log LOG -
emptyArgs
ScriptRuntime.emptyArgs. -
Undefined
org.htmlunit.corejs.javascript.Undefined.instance. -
webClient_
-
contextFactory_
-
jsConfig_
-
javaScriptRunning_
-
postponedActions_
-
holdPostponedActions_
private transient boolean holdPostponedActions_ -
shutdownPending_
private transient boolean shutdownPending_ -
javaScriptExecutor_
The JavaScriptExecutor corresponding to all windows of this Web client -
KEY_STARTING_SCOPE
Key used to place the scope in which the execution of some JavaScript code started as thread local attribute in current context.This is needed to resolve some relative locations relatively to the page in which the script is executed and not to the page which location is changed.
- See Also:
-
KEY_STARTING_PAGE
Key used to place theHtmlPage
for which the JavaScript code is executed as thread local attribute in current context.- See Also:
-
-
Constructor Details
-
JavaScriptEngine
Creates an instance for the specifiedWebClient
.- Parameters:
webClient
- the client that will own this engine
-
-
Method Details
-
getWebClient
Returns the web client that this engine is associated with.- Returns:
- the web client
-
getContextFactory
- Specified by:
getContextFactory
in interfaceAbstractJavaScriptEngine<org.htmlunit.corejs.javascript.Script>
- Returns:
- this JavaScript engine's
HtmlUnitContextFactory
-
initialize
Performs initialization for the given webWindow.- Specified by:
initialize
in interfaceAbstractJavaScriptEngine<org.htmlunit.corejs.javascript.Script>
- Parameters:
webWindow
- the web window to initialize forpage
- the page that will become the enclosing page
-
getJavaScriptExecutor
Returns the JavaScriptExecutor.- Returns:
- the JavaScriptExecutor or null if javascript is disabled or no executor was required so far.
-
init
private void init(WebWindow webWindow, Page page, org.htmlunit.corejs.javascript.Context context) throws Exception Initializes all the JS stuff for the window.- Parameters:
webWindow
- the web windowcontext
- the current context- Throws:
Exception
- if something goes wrong
-
additionalCtor
private static void additionalCtor(Window window, Map<String, org.htmlunit.corejs.javascript.Scriptable> prototypesPerJSName, Method ctorMethod, String prop, String clazzName) throws Exception- Throws:
Exception
-
configureRhino
public static void configureRhino(WebClient webClient, BrowserVersion browserVersion, HtmlUnitScriptable scriptable) INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.- Parameters:
webClient
- the WebClientbrowserVersion
- the BrowserVersionscriptable
- the window or the DedicatedWorkerGlobalScope
-
applyPolyfills
public static void applyPolyfills(WebClient webClient, BrowserVersion browserVersion, org.htmlunit.corejs.javascript.Context context, HtmlUnitScriptable scriptable) throws IOException INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.- Parameters:
webClient
- the WebClientbrowserVersion
- the BrowserVersioncontext
- the current contextscriptable
- the window or the DedicatedWorkerGlobalScope- Throws:
IOException
- in case of problems
-
defineConstructor
private static void defineConstructor(Window window, org.htmlunit.corejs.javascript.Scriptable prototype, org.htmlunit.corejs.javascript.ScriptableObject constructor) -
deleteProperties
private static void deleteProperties(org.htmlunit.corejs.javascript.Scriptable scope, String... propertiesToDelete) Deletes the properties with the provided names.- Parameters:
scope
- the scope from which properties have to be removedpropertiesToDelete
- the list of property names
-
removePrototypeProperties
private static void removePrototypeProperties(org.htmlunit.corejs.javascript.Scriptable scope, String className, String... properties) Removes prototype properties.- Parameters:
scope
- the scopeclassName
- the class for which properties should be removedproperties
- the properties to remove
-
configureClass
public static HtmlUnitScriptable configureClass(ClassConfiguration config, org.htmlunit.corejs.javascript.Scriptable window, BrowserVersion browserVersion) throws InstantiationException, IllegalAccessException Configures the specified class for access via JavaScript.- Parameters:
config
- the configuration settings for the class to be configuredwindow
- the scope within which to configure the classbrowserVersion
- the browser version- Returns:
- the created prototype
- Throws:
InstantiationException
- if the new class cannot be instantiatedIllegalAccessException
- if we don't have access to create the new instance
-
configureConstantsStaticPropertiesAndStaticFunctions
private static void configureConstantsStaticPropertiesAndStaticFunctions(ClassConfiguration config, org.htmlunit.corejs.javascript.ScriptableObject scriptable) Configures constants, static properties and static functions on the object.- Parameters:
config
- the configuration for the objectscriptable
- the object to configure
-
configureConstantsPropertiesAndFunctions
private static void configureConstantsPropertiesAndFunctions(ClassConfiguration config, org.htmlunit.corejs.javascript.ScriptableObject scriptable) Configures constants, properties and functions on the object.- Parameters:
config
- the configuration for the objectscriptable
- the object to configure
-
configureFunctions
private static void configureFunctions(ClassConfiguration config, org.htmlunit.corejs.javascript.ScriptableObject scriptable) -
configureConstants
private static void configureConstants(ClassConfiguration config, org.htmlunit.corejs.javascript.ScriptableObject scriptable) -
configureProperties
private static void configureProperties(ClassConfiguration config, org.htmlunit.corejs.javascript.ScriptableObject scriptable) -
configureStaticProperties
private static void configureStaticProperties(ClassConfiguration config, org.htmlunit.corejs.javascript.ScriptableObject scriptable) -
configureStaticFunctions
private static void configureStaticFunctions(ClassConfiguration config, org.htmlunit.corejs.javascript.ScriptableObject scriptable) -
configureSymbolConstants
private static void configureSymbolConstants(ClassConfiguration config, org.htmlunit.corejs.javascript.ScriptableObject scriptable) -
configureSymbols
private static void configureSymbols(ClassConfiguration config, org.htmlunit.corejs.javascript.ScriptableObject scriptable) -
registerWindowAndMaybeStartEventLoop
Register WebWindow with the JavaScriptExecutor.- Specified by:
registerWindowAndMaybeStartEventLoop
in interfaceAbstractJavaScriptEngine<org.htmlunit.corejs.javascript.Script>
- Parameters:
webWindow
- the WebWindow to be registered.
-
prepareShutdown
public void prepareShutdown()Disable starting of new js threads.- Specified by:
prepareShutdown
in interfaceAbstractJavaScriptEngine<org.htmlunit.corejs.javascript.Script>
-
shutdown
public void shutdown()Shutdown the JavaScriptEngine.- Specified by:
shutdown
in interfaceAbstractJavaScriptEngine<org.htmlunit.corejs.javascript.Script>
-
compile
public org.htmlunit.corejs.javascript.Script compile(HtmlPage owningPage, org.htmlunit.corejs.javascript.Scriptable scope, String sourceCode, String sourceName, int startLine) Compiles the specified JavaScript code in the context of a given scope.- Specified by:
compile
in interfaceAbstractJavaScriptEngine<org.htmlunit.corejs.javascript.Script>
- Parameters:
owningPage
- the page from which the code startedscope
- the scope in which to execute the javascript codesourceCode
- the JavaScript code to executesourceName
- the name that will be displayed on error conditionsstartLine
- the line at which the script source starts- Returns:
- the result of executing the specified code
-
compile
@Deprecated public org.htmlunit.corejs.javascript.Script compile(HtmlPage owningPage, String sourceCode, String sourceName, int startLine) Deprecated.Compiles the specified JavaScript code in the context of a given HTML page.- Specified by:
compile
in interfaceAbstractJavaScriptEngine<org.htmlunit.corejs.javascript.Script>
- Parameters:
owningPage
- the page that the code will execute withinsourceCode
- the JavaScript code to executesourceName
- the name that will be displayed on error conditionsstartLine
- the line at which the script source starts- Returns:
- the result of executing the specified code
-
callSecured
public final <T> T callSecured(org.htmlunit.corejs.javascript.ContextAction<T> action, HtmlPage page) Forwards this to theHtmlUnitContextFactory
but with checking shutdown handling.- Type Parameters:
T
- return type of the action- Parameters:
action
- the contextActionpage
- the page- Returns:
- the result of the call
-
execute
public Object execute(HtmlPage page, org.htmlunit.corejs.javascript.Scriptable scope, String sourceCode, String sourceName, int startLine) Executes the specified JavaScript code in the context of a given page.- Specified by:
execute
in interfaceAbstractJavaScriptEngine<org.htmlunit.corejs.javascript.Script>
- Parameters:
page
- the page that the code will execute withinscope
- the scope in which to executesourceCode
- the JavaScript code to executesourceName
- the name that will be displayed on error conditionsstartLine
- the line at which the script source starts- Returns:
- the result of executing the specified code
-
execute
@Deprecated public Object execute(HtmlPage page, String sourceCode, String sourceName, int startLine) Deprecated.Executes the specified JavaScript code in the context of a given page.- Specified by:
execute
in interfaceAbstractJavaScriptEngine<org.htmlunit.corejs.javascript.Script>
- Parameters:
page
- the page that the code will execute withinsourceCode
- the JavaScript code to executesourceName
- the name that will be displayed on error conditionsstartLine
- the line at which the script source starts- Returns:
- the result of executing the specified code
-
execute
public Object execute(HtmlPage page, org.htmlunit.corejs.javascript.Scriptable scope, org.htmlunit.corejs.javascript.Script script) Executes the specified JavaScript code in the context of a given page.- Specified by:
execute
in interfaceAbstractJavaScriptEngine<org.htmlunit.corejs.javascript.Script>
- Parameters:
page
- the page that the code will execute withinscope
- the scope in which to executescript
- the script to execute- Returns:
- the result of executing the specified code
-
execute
Deprecated.Executes the specified JavaScript code in the context of a given page.- Specified by:
execute
in interfaceAbstractJavaScriptEngine<org.htmlunit.corejs.javascript.Script>
- Parameters:
page
- the page that the code will execute withinscript
- the script to execute- Returns:
- the result of executing the specified code
-
callFunction
public Object callFunction(HtmlPage page, org.htmlunit.corejs.javascript.Function javaScriptFunction, org.htmlunit.corejs.javascript.Scriptable thisObject, Object[] args, DomNode node) Calls a JavaScript function and return the result.- Parameters:
page
- the pagejavaScriptFunction
- the function to callthisObject
- the this object for class method callsargs
- the list of arguments to pass to the functionnode
- the HTML element that will act as the context- Returns:
- the result of the function call
-
callFunction
public Object callFunction(HtmlPage page, org.htmlunit.corejs.javascript.Function function, org.htmlunit.corejs.javascript.Scriptable scope, org.htmlunit.corejs.javascript.Scriptable thisObject, Object[] args) Calls the given function taking care of synchronization issues.- Parameters:
page
- the interactive page that caused this script to executedfunction
- the JavaScript function to executescope
- the execution scopethisObject
- the 'this' objectargs
- the function's arguments- Returns:
- the function result
-
getScope
-
isScriptRunning
public boolean isScriptRunning()Indicates if JavaScript is running in current thread.This allows code to know if there own evaluation is has been triggered by some JS code.
- Specified by:
isScriptRunning
in interfaceAbstractJavaScriptEngine<org.htmlunit.corejs.javascript.Script>
- Returns:
true
if JavaScript is running
-
doProcessPostponedActions
void doProcessPostponedActions() -
addPostponedAction
Adds an action that should be executed first when the script currently being executed has finished.- Specified by:
addPostponedAction
in interfaceAbstractJavaScriptEngine<org.htmlunit.corejs.javascript.Script>
- Parameters:
action
- the action
-
handleJavaScriptException
Handles an exception that occurred during execution of JavaScript code.- Parameters:
scriptException
- the exceptiontriggerOnError
- if true, this triggers the onerror handler
-
handleJavaScriptTimeoutError
Handles an exception that occurred during execution of JavaScript code.- Parameters:
page
- the page in which the script causing this exception was executede
- the timeout error that was thrown from the script engine
-
holdPosponedActions
public void holdPosponedActions()INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
Indicates that no postponed action should be executed.- Specified by:
holdPosponedActions
in interfaceAbstractJavaScriptEngine<org.htmlunit.corejs.javascript.Script>
-
processPostponedActions
public void processPostponedActions()INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
Process postponed actions, if any.- Specified by:
processPostponedActions
in interfaceAbstractJavaScriptEngine<org.htmlunit.corejs.javascript.Script>
-
readObject
Re-initializes transient fields when an object of this type is deserialized.- Throws:
IOException
ClassNotFoundException
-
initTransientFields
private void initTransientFields() -
getJavaScriptClass
Gets the class of the JavaScript object for the node class.- Parameters:
c
- the node classDomNode
or some subclass.- Returns:
null
if none found
-
getJavaScriptConfiguration
Gets the associated configuration.- Specified by:
getJavaScriptConfiguration
in interfaceAbstractJavaScriptEngine<org.htmlunit.corejs.javascript.Script>
- Returns:
- the configuration
-
getJavaScriptTimeout
public long getJavaScriptTimeout()Returns the javascript timeout.- Specified by:
getJavaScriptTimeout
in interfaceAbstractJavaScriptEngine<org.htmlunit.corejs.javascript.Script>
- Returns:
- the javascript timeout
-
setJavaScriptTimeout
public void setJavaScriptTimeout(long timeout) Sets the javascript timeout.- Specified by:
setJavaScriptTimeout
in interfaceAbstractJavaScriptEngine<org.htmlunit.corejs.javascript.Script>
- Parameters:
timeout
- the timeout
-
toNumber
Convert the value to a JavaScript Number value.- Parameters:
value
- a JavaScript value- Returns:
- the corresponding double value converted using the ECMA rules
-
toString
Convert the value to a JavaScript String value.- Parameters:
value
- a JavaScript value- Returns:
- the corresponding String value converted using the ECMA rules
-
toBoolean
Convert the value to a JavaScript boolean value.- Parameters:
value
- a JavaScript value- Returns:
- the corresponding boolean value converted using the ECMA rules
-
throwAsScriptRuntimeEx
Rethrow the exception wrapping it as the script runtime exception.- Parameters:
e
- the exception to rethrow- Returns:
- RuntimeException as dummy the method always throws
-
reportRuntimeError
Report a runtime error using the error reporter for the current thread.- Parameters:
message
- the error message to report- Returns:
- RuntimeException as dummy the method always throws
-
typeError
Report a runtime error using the error reporter for the current thread.- Parameters:
message
- the error message to report- Returns:
- EcmaError
-
rangeError
Report a runtime error using the error reporter for the current thread.- Parameters:
message
- the error message to report- Returns:
- EcmaError
-
constructError
- Parameters:
error
- the errormessage
- the message- Returns:
- a new EcmaError
-
asJavaScriptException
public static org.htmlunit.corejs.javascript.RhinoException asJavaScriptException(Window window, DOMException exception) INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
Encapsulates the givenDOMException
into a Rhino-compatible exception.- Parameters:
window
- the window to be used as parent scopeexception
- the exception to encapsulate- Returns:
- the created exception
-
newArray
public static org.htmlunit.corejs.javascript.Scriptable newArray(org.htmlunit.corejs.javascript.Scriptable scope, int length) Create an array with a specified initial length.- Parameters:
scope
- the scope to create the object inlength
- the initial length (JavaScript arrays may have additional properties added dynamically).- Returns:
- the new array object
-
newArrayIteratorTypeKeys
public static org.htmlunit.corejs.javascript.Scriptable newArrayIteratorTypeKeys(org.htmlunit.corejs.javascript.Scriptable scope, org.htmlunit.corejs.javascript.Scriptable arrayLike) INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
Create a new ArrayIterator of type NativeArrayIterator.ARRAY_ITERATOR_TYPE.KEYS- Parameters:
scope
- the scope to create the object inarrayLike
- the backend- Returns:
- the new NativeArrayIterator
-
newArrayIteratorTypeValues
public static org.htmlunit.corejs.javascript.Scriptable newArrayIteratorTypeValues(org.htmlunit.corejs.javascript.Scriptable scope, org.htmlunit.corejs.javascript.Scriptable arrayLike) INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
Create a new ArrayIterator of type NativeArrayIterator.ARRAY_ITERATOR_TYPE.VALUES- Parameters:
scope
- the scope to create the object inarrayLike
- the backend- Returns:
- the new NativeArrayIterator
-
newArrayIteratorTypeEntries
public static org.htmlunit.corejs.javascript.Scriptable newArrayIteratorTypeEntries(org.htmlunit.corejs.javascript.Scriptable scope, org.htmlunit.corejs.javascript.Scriptable arrayLike) INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
Create a new ArrayIterator of type NativeArrayIterator.ARRAY_ITERATOR_TYPE.ENTRIES- Parameters:
scope
- the scope to create the object inarrayLike
- the backend- Returns:
- the new NativeArrayIterator
-
newArray
public static org.htmlunit.corejs.javascript.Scriptable newArray(org.htmlunit.corejs.javascript.Scriptable scope, Object[] elements) Create an array with a specified initial length.- Parameters:
scope
- the scope to create the object inelements
- the initial elements. Each object in this array must be an acceptable JavaScript type and type of array should be exactly Object[], not SomeObjectSubclass[].- Returns:
- the new array object
-
toInt32
- Parameters:
o
- the object to convert- Returns:
- int value
-
toInteger
- Parameters:
o
- the object to convert- Returns:
- double value
-
toInteger
- Parameters:
args
- an arrayindex
- the index in the array- Returns:
- double value
-
isUndefined
- Parameters:
obj
- the value to check- Returns:
- whether obj is undefined
-
isNaN
- Parameters:
obj
- the value to check- Returns:
- whether obj is NAN
-
uncompressJavaScript
Tries to uncompress the JavaScript code in the provided response.- Parameters:
scriptSource
- the soucescriptName
- the name- Returns:
- the uncompressed JavaScript code
-
evaluateProxyAutoConfig
public static String evaluateProxyAutoConfig(BrowserVersion browserVersion, String content, URL url) Evaluates theFindProxyForURL
method of the specified content.- Parameters:
browserVersion
- the browser version to usecontent
- the JavaScript contenturl
- the URL to be retrieved- Returns:
- semicolon-separated result
-