Package com.facilita.fc.selenium

Class SeleniumVirtualUserScript

java.lang.Object

com.facilita.fc.runtime.VirtualUserScript

com.facilita.fc.selenium.SeleniumVirtualUserScript

All Implemented Interfaces:

DataDictionary, SeleniumVirtualUserInterface

public abstract class SeleniumVirtualUserScript
extends VirtualUserScript
implements SeleniumVirtualUserInterface

A Selenium VirtualUserScript.

Provides access to the WebDriver instance for a SeleniumVirtualUser.

Field Summary

Fields inherited from class com.facilita.fc.runtime.VirtualUserScript

ct, isMainScript

Constructor Summary

Constructors

Constructor	Description
SeleniumVirtualUserScript()

Method Summary

Modifier and Type	Method	Description
JavascriptExecutor	getJavascriptExecutor()	Get a JavascriptExecutor for this SeleniumVirtualUser
WebDriver	getUnderlyingWebDriver()	Get the underlying WebDriver instance for this SeleniumVirtualUser.
SeleniumVirtualUser	getVU()	Gets the current VU instance, as the most specialised subclass of VirtualUser.
WebDriver	getWebDriver()	Get the WebDriver instance for this SeleniumVirtualUser.
void	initialiseChromeDriver(java.lang.String pathToChromeDriver)	Create a new ChromeDriver instance for this SeleniumVirtualUser.
void	initialiseFirefoxDriver()	Create a new FirefoxDriver instance for this SeleniumVirtualUser.
void	initialiseHtmlUnitDriver()	Create a new HtmlUnitDriver instance for this SeleniumVirtualUser.
void	initialiseHtmlUnitDriver(com.gargoylesoftware.htmlunit.BrowserVersion browserVersion)	Create a new HtmlUnitDriver instance for this SeleniumVirtualUser, impersonating the BrowserVersion specified.
void	initialiseInternetExplorerDriver(java.lang.String pathToIEDriverServer)	Create a new InternetExplorerDriver instance for this SeleniumVirtualUser.
void	initialisePhantomJSDriver(java.lang.String pathToPhantomJSExe)	Create a new PhantomJSDriver instance for this SeleniumVirtualUser.
void	initialiseWebDriver(WebDriverType driverType)	Create a new WebDriver instance for this SeleniumVirtualUser.
void	initialiseWebDriver(WebDriver driver)	Create a new WebDriver instance for this SeleniumVirtualUser.

Methods inherited from class com.facilita.fc.runtime.VirtualUserScript

acceptCancellation, add, checkIfCancellationRequested, clearProgressPoint, createBackgroundScript, createBackgroundScript, endRequest, endRequest, endTiming, endTiming, endTransaction, endTransaction, endTransaction, error, error, error, error, error, exitVU, exitVU, exitVU, fail, failTiming, failTransaction, failTransaction, finalSequence, finishIterating, finishIteratingRequested, flushEventLog, formatDateTime, formatDateTime, formatDateTime, formatDateTime, formatDateTime, formatDateTime, formatDateTime, formatDateTime, formatDateTime, formatDateTime, formatDateTime, formatDateTime, formatDateTime, formatDateTime, formatDateTime, formatDateTime, get, get, getBackgroundScriptID, getBackgroundScriptIDs, getBackgroundScriptStatus, getBoolean, getBoolean, getCurrentIteration, getCurrentTimeInXml, getCurrentTransaction, getDataDictionary, getDataDictionary, getDataPath, getDataTable, getDouble, getDouble, getElapsedTime, getFilesDataPath, getFloat, getFloat, getGroupSize, getGroupSize, getGroupSizes, getIndex, getInitialDelay, getInjectorFamilyName, getInjectorName, getInt, getInt, getInteger, getInteger, getIsStopped, getIteration, getIterationDelay, getIterationForTime, getLastError, getLastTransaction, getList, getList, getLong, getLong, getMap, getMaxFailures, getMillisecondsSinceEpoch, getMillisecondsSinceEpoch, getName, getNumberOfErrors, getNumberOfFailures, getNumberOfIterations, getNumberOfWarmupIterations, getNumberOfWarnings, getPauseFactor, getProgressPoint, getRunPath, getSandboxPath, getScriptName, getSecondsSinceEpoch, getSecondsSinceEpoch, getService, getString, getString, getTimingElapsedTime, getTransactionData, getTransactionElapsedTime, getTransactionElapsedTime, getTransactionLoggingOn, getUniqueID, getUniqueID, getVirtualUser, getVUName, hasKey, isFinalScript, isFirstScript, isInitialScript, isIteratedScript, isLastIteration, isPacing, isReadOnly, keys, lastIterationDelay, logCurrentDataValues, nextIteration, nextScript, nextSequence, onBackgroundScriptCancellation, pause, pause, pre, raiseAlert, recordMetric, recordMetrics, recordTransaction, recordTransaction, recordTransaction, recordTransaction, requestToStopBackgroundScript, resume, resumeBackgroundScript, resumeTransaction, resumeTransaction, script, selectRandomEntryFromList, set, setBackgroundScriptID, setBoolean, setCancellationToken, setDouble, setFloat, setInt, setInteger, setList, setLong, setName, setNumberOfWarmupIterations, setPauseFactor, setProgressPoint, setProgressPoint, setProgressPoint, setString, setSynchronizationPoint, setTransactionLoggingOn, startBackgroundScript, startRequest, startTiming, startTransaction, startTransaction, stopBackgroundScriptImmediately, stopImmediately, suspend, suspendBackgroundScript, suspendTransaction, suspendTransaction, timeToPause, toString, tryToSuspend, unsetSynchronizationPoint, verify, verifyEQ, verifyEQ, verifyEQ, verifyEQ, verifyLE, verifyLE, verifyLE, verifyLE, verifyLT, verifyLT, verifyLT, verifyLT, waitFor, waitForBackgroundScriptToFinish, waitForBoolean, waitForDouble, waitForFloat, waitForInt, waitForList, waitForLong, waitForString, waitForSynchronizationPoint, warn, warn, warn, warn, whereAmI, writeMessage, writeMessage, writeMessage, writeMessage, writeSystemLog, writeSystemLog

Methods inherited from class java.lang.Object

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

Constructor Detail

SeleniumVirtualUserScript

public SeleniumVirtualUserScript()

Method Detail

getVU

public SeleniumVirtualUser getVU()

Description copied from class: VirtualUserScript

Gets the current VU instance, as the most specialised subclass of VirtualUser.

If you have added methods to a custom Virtual User subclass, you can call them on the object returned from this method.

e.g.

 MyCustomUser thisVU = getVU();
 thisVU.MyCustomOperation();
 

Overrides:

getVU in class VirtualUserScript

Returns:

the current VU instance

getWebDriver

public WebDriver getWebDriver()

Description copied from interface: SeleniumVirtualUserInterface

Get the WebDriver instance for this SeleniumVirtualUser.

Specified by:

getWebDriver in interface SeleniumVirtualUserInterface

Returns:

The WebDriver instance for this SeleniumVirtualUser.

initialiseHtmlUnitDriver

public void initialiseHtmlUnitDriver()
                              throws java.lang.Exception

Description copied from interface: SeleniumVirtualUserInterface

Create a new HtmlUnitDriver instance for this SeleniumVirtualUser.

The HtmlUnitDriver will be set to use the default BrowserVersion. If you need to impersonate a different BrowserVersion then you can call SeleniumVirtualUserInterface.initialiseHtmlUnitDriver(BrowserVersion) instead.

Typically, this method is called from the VirtualUser.pre() method.

Specified by:

initialiseHtmlUnitDriver in interface SeleniumVirtualUserInterface

Throws:

java.lang.Exception - An error occurred

initialiseHtmlUnitDriver

public void initialiseHtmlUnitDriver(com.gargoylesoftware.htmlunit.BrowserVersion browserVersion)
                              throws java.lang.Exception

Description copied from interface: SeleniumVirtualUserInterface

Create a new HtmlUnitDriver instance for this SeleniumVirtualUser, impersonating the BrowserVersion specified.

Typically, this method is called from the VirtualUser.pre() method.

Specified by:

initialiseHtmlUnitDriver in interface SeleniumVirtualUserInterface

Parameters:

browserVersion - The BrowserVersion to impersonate.

Throws:

java.lang.Exception - An error occurred

initialiseFirefoxDriver

public void initialiseFirefoxDriver()
                             throws java.lang.Exception

Description copied from interface: SeleniumVirtualUserInterface

Create a new FirefoxDriver instance for this SeleniumVirtualUser.

Typically, this method is called from the VirtualUser.pre() method.

Specified by:

initialiseFirefoxDriver in interface SeleniumVirtualUserInterface

Throws:

java.lang.Exception - An error occurred

initialiseInternetExplorerDriver

public void initialiseInternetExplorerDriver(java.lang.String pathToIEDriverServer)
                                      throws java.lang.Exception

Description copied from interface: SeleniumVirtualUserInterface

Create a new InternetExplorerDriver instance for this SeleniumVirtualUser.

In order to use the InternetExplorerDriver, you need to install the IE driver server (IEDriverServer.exe) on each injector in your test. You must then pass the full path of the driver server to this method, e.g:

 initialiseInternetExplorerDriver("C:/tools/SeleniumDrivers/IEDriverServer.exe");
 

For more information on setting up the IE driver server, please refer to the documentation on the selenium website.

Typically, this method is called from the VirtualUser.pre() method.

Specified by:

initialiseInternetExplorerDriver in interface SeleniumVirtualUserInterface

Parameters:

pathToIEDriverServer - The full path to the IE driver server on the injector.

Throws:

java.lang.Exception - An error occurred

initialiseChromeDriver

public void initialiseChromeDriver(java.lang.String pathToChromeDriver)
                            throws java.lang.Exception

Description copied from interface: SeleniumVirtualUserInterface

Create a new ChromeDriver instance for this SeleniumVirtualUser.

In order to use the ChromeDriver, you need to install the chrome driver server (chromedriver.exe) on each injector in your test. You must then pass the full path of the driver server to this method, e.g:

 initialiseChromeDriver("C:/tools/SeleniumDrivers/chromedriver.exe");
 

For more information on setting up the chrome driver server, please refer to the documentation on the selenium website.

Typically, this method is called from the VirtualUser.pre() method.

Specified by:

initialiseChromeDriver in interface SeleniumVirtualUserInterface

Parameters:

pathToChromeDriver - The full path to the chrome driver server on the injector.

Throws:

java.lang.Exception - An error occurred

initialisePhantomJSDriver

public void initialisePhantomJSDriver(java.lang.String pathToPhantomJSExe)
                               throws java.lang.Exception

Description copied from interface: SeleniumVirtualUserInterface

Create a new PhantomJSDriver instance for this SeleniumVirtualUser.

In order to use the PhantomJSDriver, you need to install the PhantomJS on each injector in your test. You must then pass the full path of phantomjs.exe to this method, e.g:

 initialisePhantomJSDriver("C:/tools/phantomjs-1.9.7-windows/phantomjs.exe");
 

For more information on PhantomJS, please refer to the PhantomJS website.

Typically, this method is called from the VirtualUser.pre() method.

Specified by:

initialisePhantomJSDriver in interface SeleniumVirtualUserInterface

Parameters:

pathToPhantomJSExe - The full path of phantomjs.exe

Throws:

java.lang.Exception - An error occurred

getJavascriptExecutor

public JavascriptExecutor getJavascriptExecutor()

Description copied from interface: SeleniumVirtualUserInterface

Get a JavascriptExecutor for this SeleniumVirtualUser

Specified by:

getJavascriptExecutor in interface SeleniumVirtualUserInterface

Returns:

A JavascriptExecutor for this SeleniumVirtualUser

initialiseWebDriver

public void initialiseWebDriver(WebDriverType driverType)
                         throws java.lang.Exception

Description copied from interface: SeleniumVirtualUserInterface

Create a new WebDriver instance for this SeleniumVirtualUser.

This method provides a way to alter the type of WebDriver for this Virtual User. Valid driver types are as follows:

• HtmlUnit
• FireFox
• Chrome
• InternetExplorer
• PhantomJS

e.g.

 // Create a new FirefoxDriver for this Virtual User 
 initialiseWebDriver(WebDriverType.FireFox);
 

Specified by:

initialiseWebDriver in interface SeleniumVirtualUserInterface

Parameters:

driverType - The web driver type to create

Throws:

java.lang.Exception - An error occurred

initialiseWebDriver

public void initialiseWebDriver(WebDriver driver)
                         throws java.lang.Exception

Description copied from interface: SeleniumVirtualUserInterface

Create a new WebDriver instance for this SeleniumVirtualUser.

This method provides a way to alter the type of WebDriver for this Virtual User.

Specified by:

initialiseWebDriver in interface SeleniumVirtualUserInterface

Parameters:

driver - The type of WebDriver to be used by this Virtual User

Throws:

java.lang.Exception - An error occurred

getUnderlyingWebDriver

public WebDriver getUnderlyingWebDriver()

Description copied from interface: SeleniumVirtualUserInterface

Get the underlying WebDriver instance for this SeleniumVirtualUser.

This is useful if you need to call a method that is specific to the WebDriver type that you are using. For example, if you are using the HtmlUnitDriver, you could use this method to call the setJavascriptEnabled method:

 HtmlUnitDriver htmlUnitDriver = (HtmlUnitDriver)getUnderlyingWebDriver();
 htmlUnitDriver.setJavascriptEnabled(false);
 

Specified by:

getUnderlyingWebDriver in interface SeleniumVirtualUserInterface

Returns:

The underlying WebDriver instance for this SeleniumVirtualUser.