com.opera.core.systems.scope.stp.services

Class MockEcmascriptDebugger

java.lang.Object

com.opera.core.systems.scope.stp.services.MockEcmascriptDebugger

All Implemented Interfaces:

Service, Debugger

public class MockEcmascriptDebugger
extends Object
implements Debugger

Constructor Summary

Constructors

Constructor and Description
MockEcmascriptDebugger()

Method Summary

Methods

Modifier and Type	Method and Description
void	addRuntime(Esdbg6Protos.RuntimeInfo info)
void	addRuntime(EsdbgProtos.RuntimeInfo info) Adds a runtime to the list of runtimes maintained in the service (STP/1 only)
String	callFunctionOnObject(String using, int objectId) The script to be executed on/using an object
Object	callFunctionOnObject(String using, int objectId, boolean responseExpected)
void	changeRuntime(int index) Changes the frame by index
void	changeRuntime(String framePath) Changes the frame by frame name address nested frames by dot (first.second)
void	cleanUpRuntimes() Cleanup runtimes with the active window id
void	cleanUpRuntimes(int windowId) Cleanup possible dead/suspended runtimes on runtime-started or window-closed
List<Integer>	examineObjects(Integer id) Request additional information about an object, such as its prototype or its properties.
Object	examineScriptResult(Integer id) Recursively iterates through the property hierarchies of underneath the given object and unwraps the node elements into suitable types.
String	executeJavascript(String using) Execute a script and wait for response
String	executeJavascript(String using, boolean responseExpected) Execute a script, this method allows fine tuning of responses, we are not interested in return value in some injections
String	executeJavascript(String using, Integer windowId) Executes an arbitrary block of JavaScript on a given window, and returns the result of the evaluation.
Object	executeScript(String using, boolean responseExpected) Executes a script and returns the response (based on responseExpected)
Integer	executeScriptOnObject(String using, int objectId)
Integer	getObject(String using) Gets the object id using a script
int	getRuntimeId() Get the current runtime ID.
String	getServiceName() Gets the name of the service as represented in Opera.
String	getServiceVersion() Gets the current version of the service.
void	init() Initialize the service.
boolean	isScriptInjectable() Queries the current runtime to see if it's script injectable.
List<String>	listFramePaths() Lists the frame paths of available runtimes
void	readyStateChanged(EcmascriptProtos.ReadyStateChange change) Triggered on the ecmascript service when the state of a runtime changes
void	releaseObject(int objectId) Releases a specific object
void	releaseObjects() Makes objects available to gc, this doesn't free the objects immediately
void	removeRuntime(int runtimeId) Removes a runtime from the list, doesnt get called often due to runtime-stopped being sent late (runtimes get suspended)
void	resetFramePath() Resets the frame path context to the top level frame and reinitializes the debugger runtime.
void	resetRuntimesList() Resets the list of runtimes and fetches a fresh list from Opera, this can be used to recover in cases where runtimes go out of sync
Object	scriptExecutor(String script, Object... params) Executes the given javascript via eval call
void	setDriver(OperaDriver driver) Set the driver this service belongs to.
void	setFormElementValue(int objectId, String value) Set value of a form element.
void	setRuntime(EsdbgProtos.RuntimeInfo runtime) Sets the runtime to be used in injection required for event handler (STP/1 only)
boolean	updateRuntime() Finds a valid runtime and updates the runtime reference (active runtime)

Methods inherited from class java.lang.Object

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

Constructor Detail

MockEcmascriptDebugger

public MockEcmascriptDebugger()

Method Detail

init

public void init()

Description copied from interface: Service

Initialize the service.

Specified by:

init in interface Service

getServiceName

public String getServiceName()

Description copied from interface: Service

Gets the name of the service as represented in Opera.

Specified by:

getServiceName in interface Service

Returns:

the name of the service, as represented in Opera

getServiceVersion

public String getServiceVersion()

Description copied from interface: Service

Gets the current version of the service. Versions are defined as "X.Y", where X is the major version, and Y the minor version.

Specified by:

getServiceVersion in interface Service

Returns:

the current version of the service

scriptExecutor

public Object scriptExecutor(String script,
                    Object... params)

Description copied from interface: Debugger

Executes the given javascript via eval call

Specified by:

scriptExecutor in interface Debugger

Parameters:

script - the script to be executed on host

params - array of params, can be string, long or web element(s)

removeRuntime

public void removeRuntime(int runtimeId)

Description copied from interface: Debugger

Removes a runtime from the list, doesnt get called often due to runtime-stopped being sent late (runtimes get suspended)

Specified by:

removeRuntime in interface Debugger

addRuntime

public void addRuntime(EsdbgProtos.RuntimeInfo info)

Description copied from interface: Debugger

Adds a runtime to the list of runtimes maintained in the service (STP/1 only)

Specified by:

addRuntime in interface Debugger

listFramePaths

public List<String> listFramePaths()

Description copied from interface: Debugger

Lists the frame paths of available runtimes

Specified by:

listFramePaths in interface Debugger

Returns:

a List of String framepaths

getRuntimeId

public int getRuntimeId()

Description copied from interface: Debugger

Get the current runtime ID.

Specified by:

getRuntimeId in interface Debugger

Returns:

runtime ID

setRuntime

public void setRuntime(EsdbgProtos.RuntimeInfo runtime)

Description copied from interface: Debugger

Sets the runtime to be used in injection required for event handler (STP/1 only)

Specified by:

setRuntime in interface Debugger

getObject

public Integer getObject(String using)

Description copied from interface: Debugger

Gets the object id using a script

Specified by:

getObject in interface Debugger

Parameters:

using - the script to find the object

Returns:

object id with the result

executeScriptOnObject

public Integer executeScriptOnObject(String using,
                            int objectId)

Specified by:

executeScriptOnObject in interface Debugger

executeScript

public Object executeScript(String using,
                   boolean responseExpected)

Description copied from interface: Debugger

Executes a script and returns the response (based on responseExpected)

Specified by:

executeScript in interface Debugger

Parameters:

using - the script to be injected

responseExpected - the flag to enable/disable parsing response

Returns:

the raw result object if response is expected, null otherwise

executeJavascript

public String executeJavascript(String using,
                       boolean responseExpected)

Description copied from interface: Debugger

Execute a script, this method allows fine tuning of responses, we are not interested in return value in some injections

Specified by:

executeJavascript in interface Debugger

Parameters:

using - script to execute

responseExpected - if true parse the response

Returns:

string representation of the response

executeJavascript

public String executeJavascript(String using)

Description copied from interface: Debugger

Execute a script and wait for response

Specified by:

executeJavascript in interface Debugger

Parameters:

using - script to execute

examineObjects

public List<Integer> examineObjects(Integer id)

Description copied from interface: Debugger

Request additional information about an object, such as its prototype or its properties.

Specified by:

examineObjects in interface Debugger

Parameters:

id - object ID previously returned from an eval call to the debugger

Returns:

list of ID's of object's which are considered web elements

cleanUpRuntimes

public void cleanUpRuntimes()

Description copied from interface: Debugger

Cleanup runtimes with the active window id

Specified by:

cleanUpRuntimes in interface Debugger

cleanUpRuntimes

public void cleanUpRuntimes(int windowId)

Description copied from interface: Debugger

Cleanup possible dead/suspended runtimes on runtime-started or window-closed

Specified by:

cleanUpRuntimes in interface Debugger

changeRuntime

public void changeRuntime(String framePath)

Description copied from interface: Debugger

Changes the frame by frame name address nested frames by dot (first.second)

Specified by:

changeRuntime in interface Debugger

callFunctionOnObject

public Object callFunctionOnObject(String using,
                          int objectId,
                          boolean responseExpected)

Specified by:

callFunctionOnObject in interface Debugger

callFunctionOnObject

public String callFunctionOnObject(String using,
                          int objectId)

Description copied from interface: Debugger

The script to be executed on/using an object

Specified by:

callFunctionOnObject in interface Debugger

Parameters:

using - script with reference to the object "locator"

objectId - the object to be used for injection

Returns:

the string value returned by the executed Javascript

addRuntime

public void addRuntime(Esdbg6Protos.RuntimeInfo info)

releaseObjects

public void releaseObjects()

Description copied from interface: Debugger

Makes objects available to gc, this doesn't free the objects immediately

Specified by:

releaseObjects in interface Debugger

updateRuntime

public boolean updateRuntime()

Description copied from interface: Debugger

Finds a valid runtime and updates the runtime reference (active runtime)

Specified by:

updateRuntime in interface Debugger

Returns:

true if a runtime is found and updated

resetRuntimesList

public void resetRuntimesList()

Description copied from interface: Debugger

Resets the list of runtimes and fetches a fresh list from Opera, this can be used to recover in cases where runtimes go out of sync

Specified by:

resetRuntimesList in interface Debugger

readyStateChanged

public void readyStateChanged(EcmascriptProtos.ReadyStateChange change)

Description copied from interface: Debugger

Triggered on the ecmascript service when the state of a runtime changes

Specified by:

readyStateChanged in interface Debugger

Parameters:

change - EcmascriptProtos.ReadyStateChange object with runtime info

releaseObject

public void releaseObject(int objectId)

Description copied from interface: Debugger

Releases a specific object

Specified by:

releaseObject in interface Debugger

Parameters:

objectId - Id of the object to be released

resetFramePath

public void resetFramePath()

Description copied from interface: Debugger

Resets the frame path context to the top level frame and reinitializes the debugger runtime.

Specified by:

resetFramePath in interface Debugger

changeRuntime

public void changeRuntime(int index)

Description copied from interface: Debugger

Changes the frame by index

Specified by:

changeRuntime in interface Debugger

executeJavascript

public String executeJavascript(String using,
                       Integer windowId)

Description copied from interface: Debugger

Executes an arbitrary block of JavaScript on a given window, and returns the result of the evaluation.

Specified by:

executeJavascript in interface Debugger

Parameters:

using - the code to evaluate

windowId - the runtime ID, previously retrieved from the WindowManager

Returns:

the result of the evaluation

examineScriptResult

public Object examineScriptResult(Integer id)

Description copied from interface: Debugger

Recursively iterates through the property hierarchies of underneath the given object and unwraps the node elements into suitable types. DOM elements will be coerced into OperaWebElement's, arrays into Java List's, hashes into Map's, numbers into Integer's, and the remaining properties into String's.

Specified by:

examineScriptResult in interface Debugger

Parameters:

id - the object to examine the hierarchy of

Returns:

the unwrapped object tree

setFormElementValue

public void setFormElementValue(int objectId,
                       String value)

Description copied from interface: Debugger

Set value of a form element.

Specified by:

setFormElementValue in interface Debugger

Parameters:

objectId - the ID of the object to set value

value - the value to set

setDriver

public void setDriver(OperaDriver driver)

Description copied from interface: Debugger

Set the driver this service belongs to. Needed so that we can create OperaWebElements in this service.

Specified by:

setDriver in interface Debugger

isScriptInjectable

public boolean isScriptInjectable()

Description copied from interface: Debugger

Queries the current runtime to see if it's script injectable.

Specified by:

isScriptInjectable in interface Debugger

Returns:

true if runtime is script injectable, false otherwise