jp.vmi.selenium.selenese

Class Runner

java.lang.Object

jp.vmi.selenium.selenese.Runner

All Implemented Interfaces:

HtmlResultHolder, JUnitResultHolder, Context, HighlightHandler, ScreenshotHandler, org.openqa.selenium.internal.WrapsDriver

public class Runner
extends Object
implements Context, ScreenshotHandler, HighlightHandler, JUnitResultHolder, HtmlResultHolder

Provide Java API to run Selenese script.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Runner.MaxTimeTimer Interrupt main thread after the seconds specified by --max-time option.

Constructor Summary

Constructors

Constructor and Description
Runner() Constructor.

Method Summary

Modifier and Type	Method and Description
Result	execute(Selenese selenese) Execute test-suite / test-case.
void	finish() Finish test.
String	getBrowserName() Get browser name.
CollectionMap	getCollectionMap() Get collection map.
CommandFactory	getCommandFactory() Get CommandFactory instance.
CommandListIterator	getCommandListIterator() Get current CommandListIterator.
CookieFilter	getCookieFilter() Get cookie filter.
String	getCurrentBaseURL() Get current base URL.
TestCase	getCurrentTestCase() Get current test-case.
WebDriverElementFinder	getElementFinder() Get elemnt finder.
Eval	getEval() Get evaluater.
HtmlResult	getHtmlResult() Get HTML result instance.
long	getInitialSpeed() Get initial speed at starting test-suite.
String	getInitialWindowHandle() Get initial window handle.
JSLibrary	getJSLibrary() Get JavaScript library handler.
JUnitResult	getJUnitResult() Get JUnit result instance.
PageInformation	getLatestPageInformation() Get latest page information.
ModifierKeyState	getModifierKeyState() Get modifier key state.
String	getOverridingBaseURL() Get base URL for overriding test-case base URL.
PrintStream	getPrintStream() Get PrintStream for logging.
RollupRules	getRollupRules() Get rollup rules.
long	getSpeed() Get speed for setSpeed command.
SubCommandMap	getSubCommandMap() Get SubCommandMap instance.
int	getTimeout() Get timeout for waiting.
VarsMap	getVarsMap() Get variables map.
org.openqa.selenium.WebDriver	getWrappedDriver()
void	highlight(Locator ploc, HighlightStyle highlightStyle) Highlight and backup specified locator.
boolean	isHighlight() Get locator highlighting.
boolean	isIgnoredScreenshotCommand() Get ignore screenshot command flag.
boolean	isInteractive() Get interactive.
boolean	isTrue(String expr) Get boolean value of expr.
void	popCommandListIterator() Pop CommandListIterator.
void	prepareWebDriver() Prepare WebDriver.
void	pushCommandListIterator(CommandListIterator commandListIterator) Push CommandListIterator.
void	resetSpeed() Reset speed as initial speed.
void	resetState() Reset internal state.
Result	run(String... filenames) Run Selenese script files.
Result	run(String filename, InputStream is) Run Selenese script from input stream.
void	setCommandLineArgs(String[] args) Set command line arguments.
void	setCookieFilter(CookieFilter cookieFilter) Set cookie filter.
void	setCurrentTestCase(TestCase currentTestCase) Set current test-case.
void	setDriver(org.openqa.selenium.WebDriver driver) Set WebDriver.
void	setHighlight(boolean isHighlight) Set locator highlighting.
void	setHtmlResultDir(String dir) Initialize HTMLResult.
void	setIgnoredScreenshotCommand(boolean isIgnoredScreenshotCommand) Set ignore screenshot command flag.
void	setInitialSpeed(long initialSpeed) Set initial speed at starting test-suite.
void	setInteractive(boolean isInteractive) Set interactive.
void	setJSLibrary(JSLibrary jsLibrary) Set JavaScript library handler.
void	setJUnitResultDir(String dir) Initialize JUnitResult.
void	setLatestPageInformation(PageInformation pageInformation) Set latest page information.
void	setOverridingBaseURL(String overridingBaseURL) Set URL for overriding test-case base URL.
void	setPrintStream(PrintStream ps) Set PrintStream for logging.
void	setScreenshotAllDir(String screenshotAllDir) Set directory for storing screenshots at all commands.
void	setScreenshotDir(String screenshotDir) Set directory for storing screenshots.
void	setScreenshotOnFailDir(String screenshotOnFailDir) Set directory for storing screenshot on fail.
void	setSpeed(long speed) Set speed for setSpeed command.
void	setTimeout(int timeout) Set timeout for waiting.
void	setVarsMap(VarsMap varsMap) Set variables map used for this session.
void	setWebDriverPreparator(WebDriverPreparator preparator) Set WebDriverPreparator.
String	takeScreenshot(String filename) Take screenshot to filename.
String	takeScreenshotAll(String prefix, int index) Take screenshot at all commands if --screenshot-all option specified.
String	takeScreenshotOnFail(String prefix, int index) Take screenshot on fail commands if --screenshot-on-fail option specified.
void	unhighlight() Unhighlight backed up styles.
void	waitSpeed() Wait according to speed setting.

Methods inherited from class java.lang.Object

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

Methods inherited from interface jp.vmi.selenium.selenese.Context

executeScript, findElement, findElements, isBrowser

Constructor Detail

Runner

public Runner()

Constructor.

Method Detail

setCommandLineArgs

public void setCommandLineArgs(String[] args)

Set command line arguments.

Parameters:

args - command line arguments.

getCurrentTestCase

public TestCase getCurrentTestCase()

Description copied from interface: Context

Get current test-case.

Specified by:

getCurrentTestCase in interface Context

Returns:

current test-case.

setCurrentTestCase

public void setCurrentTestCase(TestCase currentTestCase)

Description copied from interface: Context

Set current test-case.

Specified by:

setCurrentTestCase in interface Context

Parameters:

currentTestCase - current test-case.

setPrintStream

public void setPrintStream(PrintStream ps)

Set PrintStream for logging.

Parameters:

ps - PrintStream for logging.

getPrintStream

public PrintStream getPrintStream()

Description copied from interface: Context

Get PrintStream for logging.

Specified by:

getPrintStream in interface Context

Returns:

PrintStram object.

takeScreenshot

public String takeScreenshot(String filename)
                      throws org.openqa.selenium.WebDriverException,
                             UnsupportedOperationException

Description copied from interface: ScreenshotHandler

Take screenshot to filename. (override directory if --screenshot-dir option specified)

Specified by:

takeScreenshot in interface ScreenshotHandler

Parameters:

filename - filename.

Returns:

screenshot image path.

Throws:

UnsupportedOperationException - WebDriver does not supoort capturing screenshot.

org.openqa.selenium.WebDriverException

takeScreenshotAll

public String takeScreenshotAll(String prefix,
                                int index)

Description copied from interface: ScreenshotHandler

Take screenshot at all commands if --screenshot-all option specified.

Specified by:

takeScreenshotAll in interface ScreenshotHandler

Parameters:

prefix - prefix name.

index - command index.

Returns:

screenshot image path.

takeScreenshotOnFail

public String takeScreenshotOnFail(String prefix,
                                   int index)

Description copied from interface: ScreenshotHandler

Take screenshot on fail commands if --screenshot-on-fail option specified.

Specified by:

takeScreenshotOnFail in interface ScreenshotHandler

Parameters:

prefix - prefix name.

index - command index.

Returns:

screenshot image path.

getWrappedDriver

public org.openqa.selenium.WebDriver getWrappedDriver()

Specified by:

getWrappedDriver in interface org.openqa.selenium.internal.WrapsDriver

getInitialWindowHandle

public String getInitialWindowHandle()

Description copied from interface: Context

Get initial window handle.

Specified by:

getInitialWindowHandle in interface Context

Returns:

window handle.

setDriver

public void setDriver(org.openqa.selenium.WebDriver driver)

Set WebDriver.

Parameters:

driver - WebDriver.

prepareWebDriver

public void prepareWebDriver()

Description copied from interface: Context

Prepare WebDriver.

Specified by:

prepareWebDriver in interface Context

setWebDriverPreparator

public void setWebDriverPreparator(WebDriverPreparator preparator)

Set WebDriverPreparator.

Parameters:

preparator - WebDriverPreparator.

getBrowserName

public String getBrowserName()

Description copied from interface: Context

Get browser name.

Specified by:

getBrowserName in interface Context

Returns:

browser name.

setScreenshotDir

public void setScreenshotDir(String screenshotDir)
                      throws IllegalArgumentException

Set directory for storing screenshots.

Parameters:

screenshotDir - directory.

Throws:

IllegalArgumentException - throws if screenshotDir is not directory.

setScreenshotAllDir

public void setScreenshotAllDir(String screenshotAllDir)
                         throws IllegalArgumentException

Set directory for storing screenshots at all commands.

Parameters:

screenshotAllDir - directory.

Throws:

IllegalArgumentException - throws if screenshotAllDir is not directory.

setScreenshotOnFailDir

public void setScreenshotOnFailDir(String screenshotOnFailDir)

Set directory for storing screenshot on fail.

Parameters:

screenshotOnFailDir - directory.

getCurrentBaseURL

public String getCurrentBaseURL()

Description copied from interface: Context

Get current base URL.

Specified by:

getCurrentBaseURL in interface Context

Returns:

base URL.

setOverridingBaseURL

public void setOverridingBaseURL(String overridingBaseURL)

Set URL for overriding test-case base URL.

Parameters:

overridingBaseURL - base URL.

getOverridingBaseURL

public String getOverridingBaseURL()

Description copied from interface: Context

Get base URL for overriding test-case base URL.

Specified by:

getOverridingBaseURL in interface Context

Returns:

base URL.

setIgnoredScreenshotCommand

public void setIgnoredScreenshotCommand(boolean isIgnoredScreenshotCommand)

Set ignore screenshot command flag.

Parameters:

isIgnoredScreenshotCommand - set true if you want to ignore "captureEntirePageScreenshot"

isIgnoredScreenshotCommand

public boolean isIgnoredScreenshotCommand()

Description copied from interface: ScreenshotHandler

Get ignore screenshot command flag.

Specified by:

isIgnoredScreenshotCommand in interface ScreenshotHandler

Returns:

flag to ignore "captureEntirePageScreenshot"

isHighlight

public boolean isHighlight()

Description copied from interface: HighlightHandler

Get locator highlighting.

Specified by:

isHighlight in interface HighlightHandler

Returns:

true if use locator highlighting.

setHighlight

public void setHighlight(boolean isHighlight)

Set locator highlighting.

Parameters:

isHighlight - true if use locator highlighting.

isInteractive

public boolean isInteractive()

Description copied from interface: Context

Get interactive.

Specified by:

isInteractive in interface Context

Returns:

interactive.

setInteractive

public void setInteractive(boolean isInteractive)

Set interactive.

Parameters:

isInteractive - true if Runner executes test step-by-step upon user key stroke.

getTimeout

public int getTimeout()

Description copied from interface: Context

Get timeout for waiting. (ms)

Specified by:

getTimeout in interface Context

Returns:

timeout for waiting.

setTimeout

public void setTimeout(int timeout)

Description copied from interface: Context

Set timeout for waiting. (ms)

Specified by:

setTimeout in interface Context

Parameters:

timeout - for waiting.

getInitialSpeed

public long getInitialSpeed()

Get initial speed at starting test-suite. (ms)

Returns:

initial speed.

setInitialSpeed

public void setInitialSpeed(long initialSpeed)

Set initial speed at starting test-suite. (ms)

Parameters:

initialSpeed - initial speed.

resetSpeed

public void resetSpeed()

Description copied from interface: Context

Reset speed as initial speed.

Specified by:

resetSpeed in interface Context

getSpeed

public long getSpeed()

Description copied from interface: Context

Get speed for setSpeed command.

Specified by:

getSpeed in interface Context

Returns:

speed.

setSpeed

public void setSpeed(long speed)

Description copied from interface: Context

Set speed for setSpeed command.

Specified by:

setSpeed in interface Context

Parameters:

speed - speed.

waitSpeed

public void waitSpeed()

Description copied from interface: Context

Wait according to speed setting.

Specified by:

waitSpeed in interface Context

getSubCommandMap

public SubCommandMap getSubCommandMap()

Description copied from interface: Context

Get SubCommandMap instance.

Specified by:

getSubCommandMap in interface Context

Returns:

SubCommandMap instance.

getCommandFactory

public CommandFactory getCommandFactory()

Description copied from interface: Context

Get CommandFactory instance.

Specified by:

getCommandFactory in interface Context

Returns:

CommandFactory instance.

getCommandListIterator

public CommandListIterator getCommandListIterator()

Description copied from interface: Context

Get current CommandListIterator.

Specified by:

getCommandListIterator in interface Context

Returns:

current CommanListIterator.

pushCommandListIterator

public void pushCommandListIterator(CommandListIterator commandListIterator)

Description copied from interface: Context

Push CommandListIterator.

Specified by:

pushCommandListIterator in interface Context

Parameters:

commandListIterator - CommanListIterator.

popCommandListIterator

public void popCommandListIterator()

Description copied from interface: Context

Pop CommandListIterator.

Specified by:

popCommandListIterator in interface Context

getVarsMap

public VarsMap getVarsMap()

Description copied from interface: Context

Get variables map.

Specified by:

getVarsMap in interface Context

Returns:

VarsMap.

setVarsMap

public void setVarsMap(VarsMap varsMap)

Set variables map used for this session.

Parameters:

varsMap - the evaluated variables (state) for the current context.

getCollectionMap

public CollectionMap getCollectionMap()

Description copied from interface: Context

Get collection map.

Specified by:

getCollectionMap in interface Context

Returns:

CollectionMap.

getRollupRules

public RollupRules getRollupRules()

Description copied from interface: Context

Get rollup rules.

Specified by:

getRollupRules in interface Context

Returns:

RollupRules object.

getEval

public Eval getEval()

Description copied from interface: Context

Get evaluater.

Specified by:

getEval in interface Context

Returns:

eval object.

getElementFinder

public WebDriverElementFinder getElementFinder()

Description copied from interface: Context

Get elemnt finder.

Specified by:

getElementFinder in interface Context

Returns:

element finder.

getLatestPageInformation

public PageInformation getLatestPageInformation()

Description copied from interface: Context

Get latest page information.

Specified by:

getLatestPageInformation in interface Context

Returns:

page information.

setLatestPageInformation

public void setLatestPageInformation(PageInformation pageInformation)

Description copied from interface: Context

Set latest page information.

Specified by:

setLatestPageInformation in interface Context

Parameters:

pageInformation - page information.

getCookieFilter

public CookieFilter getCookieFilter()

Description copied from interface: Context

Get cookie filter.

Specified by:

getCookieFilter in interface Context

Returns:

cookie filter.

setCookieFilter

public void setCookieFilter(CookieFilter cookieFilter)

Description copied from interface: Context

Set cookie filter.

Specified by:

setCookieFilter in interface Context

Parameters:

cookieFilter - cookie filter.

getJSLibrary

public JSLibrary getJSLibrary()

Description copied from interface: Context

Get JavaScript library handler.

Specified by:

getJSLibrary in interface Context

Returns:

JavaScript library handler.

setJSLibrary

public void setJSLibrary(JSLibrary jsLibrary)

Description copied from interface: Context

Set JavaScript library handler.

Specified by:

setJSLibrary in interface Context

Parameters:

jsLibrary - JavaScript library handler.

getModifierKeyState

public ModifierKeyState getModifierKeyState()

Description copied from interface: Context

Get modifier key state.

Specified by:

getModifierKeyState in interface Context

Returns:

modifier key state.

resetState

public void resetState()

Description copied from interface: Context

Reset internal state.

Specified by:

resetState in interface Context

execute

public Result execute(Selenese selenese)

Execute test-suite / test-case.

Parameters:

selenese - test-suite or test-case.

Returns:

result.

isTrue

public boolean isTrue(String expr)

Description copied from interface: Context

Get boolean value of expr.

Specified by:

isTrue in interface Context

Parameters:

expr - expression.

Returns:

cast from result of expr to Javascript Boolean.

run

public Result run(String... filenames)

Run Selenese script files.

Parameters:

filenames - Selenese script filenames.

Returns:

result.

run

public Result run(String filename,
                  InputStream is)

Run Selenese script from input stream.

Parameters:

filename - selenese script file. (not open. used for label or generating output filename)

is - input stream of script file. (test-case or test-suite)

Returns:

result.

setJUnitResultDir

public void setJUnitResultDir(String dir)

Initialize JUnitResult.

Parameters:

dir - JUnit result directory.

getJUnitResult

public JUnitResult getJUnitResult()

Description copied from interface: JUnitResultHolder

Get JUnit result instance.

Specified by:

getJUnitResult in interface JUnitResultHolder

Returns:

JUnit result instance.

setHtmlResultDir

public void setHtmlResultDir(String dir)

Initialize HTMLResult.

Parameters:

dir - HTML result directory.

getHtmlResult

public HtmlResult getHtmlResult()

Description copied from interface: HtmlResultHolder

Get HTML result instance.

Specified by:

getHtmlResult in interface HtmlResultHolder

Returns:

HTML result instance.

finish

public void finish()

Finish test. generate index.html for HTML result.

highlight

public void highlight(Locator ploc,
                      HighlightStyle highlightStyle)

Description copied from interface: HighlightHandler

Highlight and backup specified locator.

Specified by:

highlight in interface HighlightHandler

Parameters:

ploc - parsed locator.

highlightStyle - highlight style.

unhighlight

public void unhighlight()

Description copied from interface: HighlightHandler

Unhighlight backed up styles.

Specified by:

unhighlight in interface HighlightHandler