WebDriver.Extensions 1.0.3

Selenium Web Driver Extension

I created this repository to help with Selenium testing.

I found there were some problems with using the built in tools.

• Exceptions
• Wait until

Exceptions

The current tooling seems to throw exceptions a lot when the element can't be found. This is due to the page not loading fully, or not being visible.

So, these extensions use the catch Exception to catch all exceptions raised by the find methods.

If you need the exceptions to be raised, then this extension is not for you.

Wait until

There is a way to try and find an element using a class called WebDriverWait. However, I found that this still threw exceptions. So, I have written this extension to wrap a do while loop around the try catch block.

Signatures

public static IWebElement SafeFindElement(this IWebDriver driver, By by, int timeOutInSeconds = 0, Func<IWebElement, IWebElement> elementCheckFunc = null)

public static IReadOnlyCollection<IWebElement> SafeFindElements(this IWebDriver driver, By by, int timeOutInSeconds = 0)

IWebDriver

The object that we are using for testing.

By

The By parameter we are using for the search.

int

The time out in seconds that the process will run for while it is attempting to find the element(s). If the time runs out, and the element(s) still hasn't been found, then it will return null, and not throw an exception.

Func<IWebElement, IWebElement>

This function is what you would like to run against the element found. As long as it returns an IWebElement.

You would use it to limit the element further. You might not want the element that has been found, as it is not enabled, or displayed.

Usages

Here are some examples of how to use the element. They are, mostly, taken from the unit test project.

Safe Find Element

var result = _driver.SafeFindElement(By.Id("banana"));

var result = _driver.SafeFindElement(By.Id("banana"), 5);

var result = _driver.SafeFindElement(By.Id("banana"), 0, (element) => element.Displayed ? element : null);

var result = _driver.SafeFindElement(By.Id("banana"), 5, (element) => element.Displayed ? element : null);

var result = _driver.SafeFindElement(By.Id("banana"), 5, (element) => (element.Displayed && element.Enabled) ? element : null);

Safe Find Elements

var result = _driver.SafeFindElements(By.Id("banana"));

var result = _driver.SafeFindElements(By.Id("banana"), 5);

Obsolete Methods

To keep the methods names the same as the Selenium.WebDriver methods, an issue was raised on GitHub. This has been fixed.

The following methods are now obsolete and will be removed in a later version of the library.

• SafeGetElement
• SafeGetElements