https://github.com/wndrr/seleniumutils
A C#.NET Standard 2.0 collection of utility methods for Selenium Webdriver
https://github.com/wndrr/seleniumutils
csharp-library net-standard-2 selenium seleniumwebdriver
Last synced: 8 months ago
JSON representation
A C#.NET Standard 2.0 collection of utility methods for Selenium Webdriver
- Host: GitHub
- URL: https://github.com/wndrr/seleniumutils
- Owner: Wndrr
- License: unlicense
- Created: 2018-08-21T11:41:22.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2023-12-15T08:49:03.000Z (almost 2 years ago)
- Last Synced: 2025-02-04T07:37:14.681Z (8 months ago)
- Topics: csharp-library, net-standard-2, selenium, seleniumwebdriver
- Language: C#
- Homepage: https://www.nuget.org/packages/Wndrr.Selenium.Utils
- Size: 16.6 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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](http://immo.landwerth.net/netstandard-versions/#) for a more exhaustive list of compatible frameworks.
## NuGet package
The NuGet package can be found on [NuGet.org](https://www.nuget.org/packages/Wndrr.Selenium.Utils/) 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
```csharp
// 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.
```csharp
// 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.
```csharp
// 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.
```csharp
// 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.
```csharp
// 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.