public class JavaScriptEngine extends Object
Modifier and Type | Field and Description |
---|---|
static String |
KEY_STARTING_PAGE
Key used to place the
HtmlPage for which the JavaScript code is executed
as thread local attribute in current context. |
static String |
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. |
Constructor and Description |
---|
JavaScriptEngine(WebClient webClient)
Creates an instance for the specified
WebClient . |
Modifier and Type | Method and Description |
---|---|
void |
addPostponedAction(PostponedAction action)
Adds an action that should be executed first when the script currently being executed has finished.
|
Object |
callFunction(HtmlPage htmlPage,
net.sourceforge.htmlunit.corejs.javascript.Function javaScriptFunction,
net.sourceforge.htmlunit.corejs.javascript.Scriptable thisObject,
Object[] args,
DomNode htmlElement)
Calls a JavaScript function and return the result.
|
Object |
callFunction(HtmlPage htmlPage,
net.sourceforge.htmlunit.corejs.javascript.Function function,
net.sourceforge.htmlunit.corejs.javascript.Scriptable scope,
net.sourceforge.htmlunit.corejs.javascript.Scriptable thisObject,
Object[] args)
Calls the given function taking care of synchronization issues.
|
net.sourceforge.htmlunit.corejs.javascript.Script |
compile(HtmlPage htmlPage,
String sourceCode,
String sourceName,
int startLine)
Compiles the specified JavaScript code in the context of a given HTML page.
|
static SimpleScriptable |
configureClass(ClassConfiguration config,
net.sourceforge.htmlunit.corejs.javascript.Scriptable window,
BrowserVersion browserVersion)
Configures the specified class for access via JavaScript.
|
void |
definePropertiesInStandardsMode(HtmlPage page)
Define properties in Standards Mode.
|
Object |
execute(HtmlPage htmlPage,
net.sourceforge.htmlunit.corejs.javascript.Script script)
Executes the specified JavaScript code in the context of a given HTML page.
|
Object |
execute(HtmlPage htmlPage,
String sourceCode,
String sourceName,
int startLine)
Executes the specified JavaScript code in the context of a given HTML page.
|
HtmlUnitContextFactory |
getContextFactory()
Returns this JavaScript engine's Rhino
ContextFactory . |
Class<? extends SimpleScriptable> |
getJavaScriptClass(Class<?> c)
Gets the class of the JavaScript object for the node class.
|
JavaScriptConfiguration |
getJavaScriptConfiguration()
Gets the associated configuration.
|
JavaScriptExecutor |
getJavaScriptExecutor()
Returns the JavaScriptExecutor.
|
WebClient |
getWebClient()
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.
|
void |
holdPosponedActions()
INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
Indicates that no postponed action should be executed. |
void |
initialize(WebWindow webWindow)
Performs initialization for the given webWindow.
|
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. |
void |
processPostponedActions()
INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
Process postponed actions, if any. |
int |
pumpEventLoop(long timeoutMillis)
Executes the jobs in the eventLoop till timeoutMillis expires or the eventLoop becomes empty.
|
void |
registerWindowAndMaybeStartEventLoop(WebWindow webWindow)
Register WebWindow with the JavaScriptExecutor.
|
void |
shutdown()
Shutdown the JavaScriptEngine.
|
public static final String KEY_STARTING_SCOPE
public static final String KEY_STARTING_PAGE
HtmlPage
for which the JavaScript code is executed
as thread local attribute in current context.public final WebClient getWebClient()
public HtmlUnitContextFactory getContextFactory()
ContextFactory
.ContextFactory
public void initialize(WebWindow webWindow)
webWindow
- the web window to initialize forpublic JavaScriptExecutor getJavaScriptExecutor()
public void definePropertiesInStandardsMode(HtmlPage page)
page
- the pagepublic static SimpleScriptable configureClass(ClassConfiguration config, net.sourceforge.htmlunit.corejs.javascript.Scriptable window, BrowserVersion browserVersion) throws InstantiationException, IllegalAccessException
config
- the configuration settings for the class to be configuredwindow
- the scope within which to configure the classbrowserVersion
- the browser versionInstantiationException
- if the new class cannot be instantiatedIllegalAccessException
- if we don't have access to create the new instancepublic void registerWindowAndMaybeStartEventLoop(WebWindow webWindow)
webWindow
- the WebWindow to be registered.public int pumpEventLoop(long timeoutMillis)
GAEUtils.isGaeMode()
.timeoutMillis
- the timeout in millisecondspublic void shutdown()
public net.sourceforge.htmlunit.corejs.javascript.Script compile(HtmlPage htmlPage, String sourceCode, String sourceName, int startLine)
htmlPage
- 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 startspublic Object execute(HtmlPage htmlPage, String sourceCode, String sourceName, int startLine)
htmlPage
- 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 startspublic Object execute(HtmlPage htmlPage, net.sourceforge.htmlunit.corejs.javascript.Script script)
htmlPage
- the page that the code will execute withinscript
- the script to executepublic Object callFunction(HtmlPage htmlPage, net.sourceforge.htmlunit.corejs.javascript.Function javaScriptFunction, net.sourceforge.htmlunit.corejs.javascript.Scriptable thisObject, Object[] args, DomNode htmlElement)
htmlPage
- the pagejavaScriptFunction
- the function to callthisObject
- the this object for class method callsargs
- the list of arguments to pass to the functionhtmlElement
- the HTML element that will act as the contextpublic Object callFunction(HtmlPage htmlPage, net.sourceforge.htmlunit.corejs.javascript.Function function, net.sourceforge.htmlunit.corejs.javascript.Scriptable scope, net.sourceforge.htmlunit.corejs.javascript.Scriptable thisObject, Object[] args)
htmlPage
- the HTML page that caused this script to executedfunction
- the JavaScript function to executescope
- the execution scopethisObject
- the 'this' objectargs
- the function's argumentspublic boolean isScriptRunning()
true
if JavaScript is runningpublic void addPostponedAction(PostponedAction action)
action
- the actionprotected void handleJavaScriptException(ScriptException scriptException, boolean triggerOnError)
scriptException
- the exceptiontriggerOnError
- if true, this triggers the onerror handlerpublic void holdPosponedActions()
public void processPostponedActions()
public Class<? extends SimpleScriptable> getJavaScriptClass(Class<?> c)
c
- the node class DomNode
or some subclass.null
if none foundpublic JavaScriptConfiguration getJavaScriptConfiguration()
Copyright © 2002–2016 Gargoyle Software Inc.. All rights reserved.