Package co.verisoft.fw.selenium.drivers

Class DecoratedDriver

java.lang.Object
co.verisoft.fw.selenium.drivers.DecoratedDriver
All Implemented Interfaces:
org.openqa.selenium.HasCapabilities, org.openqa.selenium.JavascriptExecutor, org.openqa.selenium.SearchContext, org.openqa.selenium.TakesScreenshot, org.openqa.selenium.WebDriver, org.openqa.selenium.WrapsDriver
Direct Known Subclasses:
DecoratedMobileDriver
public class DecoratedDriver extends Object implements org.openqa.selenium.WebDriver, org.openqa.selenium.JavascriptExecutor, org.openqa.selenium.HasCapabilities, org.openqa.selenium.TakesScreenshot, org.openqa.selenium.WrapsDriver
VeriSoft driver. A top level object which handles all types of WebDriver interfaces -
1. Local and Remote
2. All Apppium and Selenium based drivers (Web and mobile are currently supported)

VeriSoft driver is a concrete class which implements a variety of interfaces (which makes it easier not having to perform castings on many operations).
I supports local creation of local WebDriver objects using WebDriverManager package (see more about WebDriverManager at WebDriverManager Github Repository )
It also supports creation of remote WebDriver objects using the built-in Selenium mechanism. VeriSoftDriver follows the RemoteWebDriver.java architecture, and actually stores an instance of RemoteWebDriver in it.

VerisoftDriver implements the WebDriver behavior, and in addition, it also adds some functionality. The main additional functionalities which are currently supported:
1. Async operations. See async operation in the "See Also" section
2. Extended logging
3. All available events included within the Selenium framework are registered. See events in the "See Also" section
4. WebDriver is wrapped with EventFiringDecorator. See in the "See Also" section


The driver is instanciated by specifying the relevant DesiredCapabilities, and if the driver is a remote driver, specifying remote url. All of VeriSoft's ctors expectes at least a DesiredCapabilities object.
All other inner WebDriver class are also implemented as delegate classes.

TODO Add support to client-server drives e.g WinAppDriver and Winium TODO Add additional drivers support such as dockers (see Selenium-Jupiter for a list of supported drivers) TODO Find ways to add unit tests to this class (it is heavily dependened on OS, external SW etc.). Maybe dockers?
Example 1 - Creating a local VerisoftDriver with firefox as driver:

     
     DesiredCapabilities capabilities = new DesiredCapabilities();
     capabilities.setCapability("browserName", "firefox");

     WebDriver driver = new VerisoftDriver(capabilities);

     driver.get("http://www.google.com");
     String title = driver.getTitle();
     if (title == "Google")
         System.out.println("We are in Google homepage");

     driver.close();

Example 2 - Creating a remote VerisoftDriver with safari as driver:
     
     DesiredCapabilities capabilities = new DesiredCapabilities();
     capabilities.setCapability("browserName", "safari");

     WebDriver driver = new VerisoftDriver("http://remote-url-address:port", capabilities);

     driver.get("http://www.google.com");
     String title = driver.getTitle();
     if (title == "Google")
         System.out.println("We are in Google homepage");

     driver.close();

Since:
1.9.6
Author:
Nir Gallner @ www.VeriSoft.co
See Also:

  • Field Details

    • decoratedDriver

      protected org.openqa.selenium.WebDriver decoratedDriver

  • Constructor Details

    • DecoratedDriver

      public DecoratedDriver(@Nullable @Nullable org.openqa.selenium.Capabilities capabilities)
      C-tor for local drivers only
      Parameters:
      capabilities - cpabilities object

    • DecoratedDriver

      public DecoratedDriver(URL remoteAddress, org.openqa.selenium.Capabilities capabilities)
      C-tor for local and remote drivers
      Parameters:
      remoteAddress - address of the remote Selenium server
      capabilities - capabilities object

  • Method Details

    • decorateDriver

      public void decorateDriver(@NotNull @NotNull List<org.openqa.selenium.support.events.WebDriverListener> listeners)

    • decorateDriver

      public void decorateDriver(Class clazz)

    • get

      public void get(String url)
      Specified by:
      get in interface org.openqa.selenium.WebDriver

    • getCurrentUrl

      public String getCurrentUrl()
      Specified by:
      getCurrentUrl in interface org.openqa.selenium.WebDriver

    • getTitle

      public String getTitle()
      Specified by:
      getTitle in interface org.openqa.selenium.WebDriver

    • findElements

      public List<org.openqa.selenium.WebElement> findElements(org.openqa.selenium.By by)
      Specified by:
      findElements in interface org.openqa.selenium.SearchContext
      Specified by:
      findElements in interface org.openqa.selenium.WebDriver

    • findElement

      public org.openqa.selenium.WebElement findElement(org.openqa.selenium.By by)
      Specified by:
      findElement in interface org.openqa.selenium.SearchContext
      Specified by:
      findElement in interface org.openqa.selenium.WebDriver

    • getPageSource

      public String getPageSource()
      Specified by:
      getPageSource in interface org.openqa.selenium.WebDriver

    • close

      public void close()
      Specified by:
      close in interface org.openqa.selenium.WebDriver

    • quit

      public void quit()
      Specified by:
      quit in interface org.openqa.selenium.WebDriver

    • getWindowHandles

      public Set<String> getWindowHandles()
      Specified by:
      getWindowHandles in interface org.openqa.selenium.WebDriver

    • getWindowHandle

      public String getWindowHandle()
      Specified by:
      getWindowHandle in interface org.openqa.selenium.WebDriver

    • switchTo

      public org.openqa.selenium.WebDriver.TargetLocator switchTo()
      Specified by:
      switchTo in interface org.openqa.selenium.WebDriver

    • manage

      public org.openqa.selenium.WebDriver.Options manage()
      Specified by:
      manage in interface org.openqa.selenium.WebDriver

    • getCapabilities

      public org.openqa.selenium.Capabilities getCapabilities()
      Specified by:
      getCapabilities in interface org.openqa.selenium.HasCapabilities

    • executeScript

      public Object executeScript(String script, Object... args)
      Specified by:
      executeScript in interface org.openqa.selenium.JavascriptExecutor

    • executeAsyncScript

      public Object executeAsyncScript(String script, Object... args)
      Specified by:
      executeAsyncScript in interface org.openqa.selenium.JavascriptExecutor

    • getScreenshotAs

      public <X> X getScreenshotAs(org.openqa.selenium.OutputType<X> target) throws org.openqa.selenium.WebDriverException
      Specified by:
      getScreenshotAs in interface org.openqa.selenium.TakesScreenshot
      Throws:
      org.openqa.selenium.WebDriverException

    • getWrappedDriver

      public org.openqa.selenium.WebDriver getWrappedDriver()
      Specified by:
      getWrappedDriver in interface org.openqa.selenium.WrapsDriver