TrueAutomation.IO selenium-webdriver extension

This module allows to use TrueAutomation.IO with selenium-webdriver.

Installation

{
  "devDependencies": {
    "trueautomation-selenium-webdriver": "~0.3",
    "trueautomation-helper": "~0.3"
  }
}

Usage

TrueAutomation.IO extension provides an own Builder and ServiceBuilder for selenium-webdriver

Builder initialization

Use Builder provided by TrueAutomation.IO instead of original one:

const { Key, until } = require('selenium-webdriver');
const { Builder, By } = require('trueautomation-selenium-webdriver');
const { ta } = require('trueautomation-helper');

(async function example() {
  const driver = new Builder().forBrowser('chrome').build();

  try {
    await driver.get('http://www.google.com/ncr');
    await driver.findElement(By.name(ta('test:test:test', 'q'))).sendKeys('webdriver', Key.RETURN);
    await driver.wait(until.titleIs('webdriver - Google Search'), 1000);
  } finally {
    await driver.quit();
  }
})();

You can use it for remote webdriver as well

  const driver = new Builder().usingServer('http://remote.host:4455').forBrowser('chrome').build();

You can use driver manually by setting corresponding parameter in capabilities

  const caps = {
    'browserName': 'firefox',
    'driver': 'geckodriver',
    'driverVersion': '0.24.1',
  }
  const driver = new Builder().withCapabilities(caps).build();

Service initialization

Use provided ServiceBuilder to create a new service.

  const service = new ServiceBuilder().loggingTo('./trueautomation.log').driverTo('chromedriver', '<driverVersion>').build();
  const options = Capabilities.chrome();
  const driver = chrome.Driver.createSession(options, service);

Use CapabilitiesBuilder to connect to a remote webdriver.

  const service = new ServiceBuilder().loggingTo('./trueautomation.log').build();
  const options = new CapabilitiesBuilder(Capabilities.chrome()).withRemoteAddress('http://remote.host:4455/wd/hub').build();
  const driver = chrome.Driver.createSession(options, service);

Using

Class By has been extended by the method ta which takes the name of TA smart locator stored in the repository. To use a TA smart locator, connect the class By with the "trueautomation-selenium-webdriver" module. See the example below:

const { By } = require('trueautomation-selenium-webdriver');

await driver.findElement(By.ta('test:test:test'));