wndrr / seleniumutils

A C#.NET Standard 2.0 collection of utility methods for Selenium Webdriver

Selenium utils

A C#.NET Standard 2.0 collection of utility methods for Selenium Webdriver

Compatibility

This library targets .NET Standard 2.0 which makes it compatible with both .NET Core 2.0 and above aswell as .NET Framework 4.6.1 and above. See the compatibility page for a more exhaustive list of compatible frameworks.

NuGet package

The NuGet package can be found on NuGet.org or by searching Wndrr.Selenium.Utils in the NuGet explorer.

Usage

The VerticalScrollTo extension method

Replaces the ScrollTo method

Tries to put an element in the center of the screen vertically using a javascript call to window.scrollTo. Usage example

// Instanciate an IWebDriver
using (var driver = new ChromeDriver())
{
    // Find an element in the DOM (isn't "dummyElement" a very cute name for an ID ?)
    var dummyElement = _driver.FindElement(By.Id("dummyElement"));
    // Scroll the element to the center of the window (more or less) 
    driver.VerticalScrollTo(dummyElement);
}

The SwitchToTab extension method

Changes the focus of the IWebDriver to target the tab/window, finding it by its id. The return value indicates if the tab could be found. When it is false no tab change occured.

// Instanciate an IWebDriver
using (var driver = new ChromeDriver())
{
    // Focus to the 2nd tab
    bool isSwitchSuccess = driver.SwitchToTab(1);
}

The WaitUntilCurrentUrlChange extension method

Periodically checks if the browser URL has changed. If no changes occured before the specified timeout occurs, a TimeoutException will be thrown.

// Instanciate an IWebDriver
using (var driver = new ChromeDriver())
{
    // Will wait untill the URL changes using the default timeout (10s) and poll (.5s) time
    driver.WaitUntilCurrentUrlChange();
}

The WaitUntilUrlIs extension method

Periodically checks if the browser URL is identical to the passed string. If the URL does not match before the specified timeout occurs, a TimeoutException will be thrown.

// Instanciate an IWebDriver
using (var driver = new ChromeDriver())
{
    // Will wait untill the URL becomes https://request.url using the default timeout (10s) and poll (.5s) time
    driver.WaitUntilUrlIs("https://request.url");
}

The WaitUntilUrlContains extension method

Periodically checks if the browser URL contains the passed string. If the URL does not match before the specified timeout occurs, a TimeoutException will be thrown.

// Instanciate an IWebDriver
using (var driver = new ChromeDriver())
{
    // Will wait untill the URL becomes https://request.url using the default timeout (10s) and poll (.5s) time
    driver.WaitUntilUrlContains("/part/of/url?wololo=pouët");
}

Legacy code

The ScrollTo was made obsolete. Use VerticalScrollTo instead.