Selenium.Ui.Test.Helper 2.0.3

Selenium Helper

Basic helper methods for selenium. Includes methds for initializing a driver and extension methods with automatic wait times for interacting with web elements.

Element actions

Get element

Waits for a single element to be displayed and returns it.

var elementLocator = By.Id("elementId");
elementLocator.GetElement(driver);

Get elements

Waits for elements to be displayed and returns them. Optionally, can wait for a specific number of elements to be displayed before retuning.

var elementsLocator = By.CssSelector(".list-item");
var elements = elementLocator.GetElements(driver);

// If expected number of elements is known, we can optionally wait for n number of elements to be displayed.
var elementsLocator = By.CssSelector(".list-item");
var elements = elementLocator.GetElements(driver, waitForElementCount: 10);

// Returns an element with specific text. For example to extract an item from a list where text = "Hello World"
var elementsLocator = By.CssSelector(".list-item");
var element = elementLocator.GetElementWithText(driver, "Hello World");

Click element

Waits for element to be displayed and performs click.

var elementLocator = By.Id("elementId");
elementLocator.Click(driver);

Enter text

Waits for text field/area to be displayed and enters text.

var elementLocator = By.Id("elementId");
elementLocator.SendKeys(driver, "value");

Clear text

Waits for text field/area to be displayed and clears text.

var elementLocator = By.Id("elementId");
elementLocator.Clear(driver);

Get text

Waits for element to be displayed and returns the text value of the element.

var elementLocator = By.Id("elementId");
var text = elementLocator.GetText(driver);

Clear text

Waits for text field/area to be displayed and returns the current value entered.

var elementLocator = By.Id("elementId");
var value = elementLocator.GetValue(driver);

Override default timeout

The default wait time for finding elements is set to 30 seconds. This value can be adjusted individually on each action method.

Set new global timeout

Add a new file to the root of your project called "testsettings.json" and a new timeout as follows.

elementLocator.SendKeys(driver, value, 20000); // Sets timeout on this step only to 20 seconds