https://github.com/aquality-automation/aquality-selenium-dotnet
Aquality Selenium is a library built over Selenium WebDriver tool that allows to automate work with web browsers. Selenium WebDriver requires some skill and experience. So, Aquality Selenium suggests simplified and most importantly safer and more stable way to work with Selenium WebDriver.
https://github.com/aquality-automation/aquality-selenium-dotnet
automation browser browserstack dotnet dotnetstandard qa qatools selenium selenoid zalenium
Last synced: 26 days ago
JSON representation
Aquality Selenium is a library built over Selenium WebDriver tool that allows to automate work with web browsers. Selenium WebDriver requires some skill and experience. So, Aquality Selenium suggests simplified and most importantly safer and more stable way to work with Selenium WebDriver.
- Host: GitHub
- URL: https://github.com/aquality-automation/aquality-selenium-dotnet
- Owner: aquality-automation
- License: apache-2.0
- Created: 2019-07-29T08:04:43.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2025-10-14T09:57:57.000Z (4 months ago)
- Last Synced: 2025-12-02T06:57:44.896Z (2 months ago)
- Topics: automation, browser, browserstack, dotnet, dotnetstandard, qa, qatools, selenium, selenoid, zalenium
- Language: C#
- Homepage:
- Size: 705 KB
- Stars: 56
- Watchers: 9
- Forks: 15
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://dev.azure.com/aquality-automation/aquality-automation/_build/latest?definitionId=1&branchName=master)
[](https://sonarcloud.io/dashboard?id=aquality-automation_aquality-selenium-dotnet)
[](https://www.nuget.org/packages/Aquality.Selenium)
# Aquality Selenium for .NET
### Overview
This package is a library designed to simplify your work with Selenium WebDriver.
You've got to use this set of methods, related to most common actions performed with web elements.
Most of performed methods are logged using NLog, so you can easily see a history of performed actions in your log.
We use interfaces where is possible, so you can implement your own version of target interface with no need to rewrite other classes.
### Quick start
To start the project using Aquality.Selenium framework, you can [download our template BDD project by this link.](https://github.com/aquality-automation/aquality-selenium-dotnet-template)
Alternatively, you can follow the steps below:
1. Add the nuget dependency Aquality.Selenium to your project.
2. Create instance of Browser in your test method:
```csharp
var browser = AqualityServices.Browser;
```
3. Use Browser's methods directly for general actions, such as navigation, window resize, scrolling and alerts handling:
```csharp
browser.Maximize();
browser.GoTo("https://wikipedia.org");
browser.WaitForPageToLoad();
```
4. Use ElementFactory class's methods to get an instance of each element:
```csharp
var emailTextBox = AqualityServices.Get().GetTextBox(By.Id("email_create"), "Email");
```
Or you can inherit a class from Form class and use existing ElementFactory:
```csharp
private ITextBox EmailTextBox => ElementFactory.GetTextBox(By.Id("email_create"), "Email");
```
5. Call element's methods to perform action with element:
```csharp
emailTextBox.Type("email@domain.com");
```
6. Handle basic authentication:
```csharp
Assert.DoesNotThrowAsync(() => browser.RegisterBasicAuthenticationAndStartMonitoring("domain.com", "username", "password"),
"Should be possible to set basic authentication async");
```
or intercept network requests/responses:
```csharp
browser.Network.AddRequestHandler(
new NetworkRequestHandler
{
RequestMatcher = req => true,
ResponseSupplier = req => new HttpResponseData { Body = "my body content", StatusCode = 200 }
});
Assert.DoesNotThrowAsync(() => browser.Network.StartMonitoring());
```
see more examples at [NetworkHandlingTests](Aquality.Selenium/tests/Aquality.Selenium.Tests/Integration/NetworkHandlingTests.cs).
7. Emulate GeoLocation, Device, Touch, Media, UserAgent overrides, Disable script execution and more using DevTools extensions:
```csharp
const double latitude = 35.8235;
const double longitude = -78.8256;
const double accuracy = 0.97;
Assert.DoesNotThrowAsync(() => DevTools.SetGeoLocationOverride(latitude, longitude, accuracy), "Should be possible to override geoLocation")
```
8. Quit browser at the end:
```csharp
browser.Quit();
```
### Documentation
To get more details please look at wiki:
- [In English](https://github.com/aquality-automation/aquality-selenium-dotnet/wiki/Overview-(English))
- [In Russian](https://github.com/aquality-automation/aquality-selenium-dotnet/wiki/Overview-(Russian))
### License
Library's source code is made available under the [Apache 2.0 license](LICENSE).