Smart extensions for Selenium.WebDriver. This wrapper is intended to extend upon the built-in browser functions to add logging, retry functionality, better error logging and generally simplify the code required for interacting with the browser, while also making it more powerful.
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.
None
Using NuGet (recommended):
Run Install-Package smartwebdriver from the Package Manager Console in Visual Studio. See the NuGet documentation for further details.
We recommend using the PageObject model approach to developing your tests. See below for an example Page model, and Test, using the SmartWebDriver code for testing a LogIn page.
using System;
using SmartWebDriver;
using SmartWebDriver.Extensions;
namespace TestProject.Pages
{
public class LoginPage
{
public static string Url = "http://mywebsite.com/login";
private readonly PageElement UsernameTxt = new PageElement("Username text field") { ID = "username" };
private readonly PageElement PasswordTxt = new PageElement("Password text field") { ID = "password" };
private readonly PageElement LoginBtn = new PageElement("Login button") { ID = "log-in" };
private readonly WebBrowser _browser;
public LoginPage(WebBrowser browser)
{
_browser = browser;
}
public void LoginAs(string username, string password)
{
_browser.EnterText(UsernameTxt, username);
_browser.EnterText(PasswordTxt, password);
_browser.Click(LoginBtn);
}
// There are simpler ways to demonstrate a successful login, but this
// approach was chosen to show how to use the 'TestResponse' object
public TestResponse VerifyLoginHasSucceeded()
{
// a successful login is indicated by the url parameter 'success'
// wait for that, and include an error message to help the user know
// what we were trying to do and what went wrong
var currentUrl = _browser.GetUrl();
return new TestResponse(currentUrl.Contains("success"), "Was trying to verify the login was successful, expected to see a url parameter of 'success' but didn't. Current url is: " + currentUrl + "\nEnsure the login details are correct.");
}
}
}
The test below uses this Login Page model, and can complete the Login functionality, without needing to know what steps are involved in logging in, how the page elements were found and interacted with, or even which framework was being used. (Which means we can swap this out later if we wanted to)
using SmartWebDriver;
using TestProject.Pages;
namespace TestProject.Tests
{
public class LoginTests()
{
private TestData testData;
[SetUp]
public void TestSetup()
{
// whatever method you use to access login credentials
testData = TestAccounts.GetLoginAccountData();
}
[Test]
public void VerifyLoginWithValidData()
{
var browser = new WebBrowser();
browser.NavigateTo(LoginPage.Url);
var loginPage = new LoginPage(browser);
loginPage.LoginAs(testData.Username, testData.password);
// verify the login was successful
Wait.UpTo(20.Seconds()).For(() => loginPage.VerifyLoginHasSucceeded());
}
}
}
Further examples will be added over time.
Currently, only the ChromeDriver is supported, however other drivers can be added if sufficient requests. The ChromeDriver.exe file is included in the repo under /drivers so that it will automatically be included in all your test projects. The SmartWebDriver code expects to find the .exe file in the /drivers folder of the output directory, so make sure your ChromeDriver.exe file is set to copy to the output directory so the test can access it.
Please read CONTRIBUTING.md for guidelines for contributing to this repository.
See the list of contributors who participated in this project.
This project is intended for regression testing an application where you control all the inputs and usage. If you open up inputs for external usage, be careful you don't open yourself up for malicious attacks, such as SSRF.
See the LICENSE file for license rights and limitations (MIT).