com.gargoylesoftware.htmlunit.javascript

Class HtmlUnitContextFactory

java.lang.Object

org.mozilla.javascript.ContextFactory

com.gargoylesoftware.htmlunit.javascript.HtmlUnitContextFactory

public class HtmlUnitContextFactory
extends org.mozilla.javascript.ContextFactory

ContextFactory that supports termination of scripts if they exceed a timeout. Based on example from ContextFactory.

Version:

$Revision: 2132 $

Author:

Andre Soereng

Nested Class Summary

Nested classes/interfaces inherited from class org.mozilla.javascript.ContextFactory

org.mozilla.javascript.ContextFactory.Listener

Constructor Summary

Constructors

Constructor and Description
HtmlUnitContextFactory(org.apache.commons.logging.Log log) Create a new instance of HtmlUnitContextFactory

Method Summary

Methods

Modifier and Type	Method and Description
protected Object	doTopCall(org.mozilla.javascript.Callable callable, org.mozilla.javascript.Context cx, org.mozilla.javascript.Scriptable scope, org.mozilla.javascript.Scriptable thisObj, Object[] args)
static boolean	getDebuggerEnabled() Returns true if the debugger is enabled, false otherwise.
static long	getTimeout() Returns the number of milliseconds a script is allowed to execute before being terminated.
protected boolean	hasFeature(org.mozilla.javascript.Context cx, int featureIndex)
protected org.mozilla.javascript.Context	makeContext()
protected void	observeInstructionCount(org.mozilla.javascript.Context cx, int instructionCount) Run-time calls this when instruction counting is enabled and the counter reaches limit set by setInstructionObserverThreshold().
static void	setDebuggerEnabled(boolean enabled) Enables or disables the debugger, which logs stack entries and exceptions.
static void	setTimeout(long timeout) Set the number of milliseconds a script is allowed to execute before being terminated.

Methods inherited from class org.mozilla.javascript.ContextFactory

addListener, call, checkNotSealed, createClassLoader, enter, enter, exit, getApplicationClassLoader, getE4xImplementationFactory, getGlobal, hasExplicitGlobal, initApplicationClassLoader, initGlobal, isSealed, onContextCreated, onContextReleased, removeListener, seal

Methods inherited from class java.lang.Object

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

Constructor Detail

HtmlUnitContextFactory

public HtmlUnitContextFactory(org.apache.commons.logging.Log log)

Create a new instance of HtmlUnitContextFactory

Parameters:

log - the log that the error reporter should use

Method Detail

setTimeout

public static void setTimeout(long timeout)

Set the number of milliseconds a script is allowed to execute before being terminated. A value of 0 or less means no timeout.

Parameters:

timeout - the timeout value

getTimeout

public static long getTimeout()

Returns the number of milliseconds a script is allowed to execute before being terminated. A value of 0 or less means no timeout.

Returns:

the timeout value. Default value is 0.

setDebuggerEnabled

public static void setDebuggerEnabled(boolean enabled)

Enables or disables the debugger, which logs stack entries and exceptions. Enabling the debugger may be useful if HtmlUnit is having trouble with JavaScript, especially if you are using some of the more advanced libraries like Dojo, Prototype or jQuery.

Parameters:

enabled - whether or not the debugger should be enabled

See Also:

DebuggerImpl, DebugFrameImpl

getDebuggerEnabled

public static boolean getDebuggerEnabled()

Returns true if the debugger is enabled, false otherwise.

Returns:

true if the debugger is enabled, false otherwise

See Also:

DebuggerImpl, DebugFrameImpl

makeContext

protected org.mozilla.javascript.Context makeContext()

Overrides:

makeContext in class org.mozilla.javascript.ContextFactory

observeInstructionCount

protected void observeInstructionCount(org.mozilla.javascript.Context cx,
                           int instructionCount)

Run-time calls this when instruction counting is enabled and the counter reaches limit set by setInstructionObserverThreshold(). A script can be terminated by throwing an Error instance here.

Overrides:

observeInstructionCount in class org.mozilla.javascript.ContextFactory

Parameters:

cx - the context calling us

instructionCount - amount of script instruction executed since last call to observeInstructionCount

doTopCall

protected Object doTopCall(org.mozilla.javascript.Callable callable,
               org.mozilla.javascript.Context cx,
               org.mozilla.javascript.Scriptable scope,
               org.mozilla.javascript.Scriptable thisObj,
               Object[] args)

Overrides:

doTopCall in class org.mozilla.javascript.ContextFactory

hasFeature

protected boolean hasFeature(org.mozilla.javascript.Context cx,
                 int featureIndex)

Overrides:

hasFeature in class org.mozilla.javascript.ContextFactory