Info
| Version: | 2.0.1 |
| Author(s): | Peter Rex Joseph |
| Last Update: | Monday, August 12, 2024 |
| .NET Fiddle: | Create the first Fiddle |
| Project Url: | https://github.com/peterrexj/Selenium.Essentials |
| NuGet Url: | https://www.nuget.org/packages/Selenium.Essentials |
Install
Install-Package Selenium.Essentials
dotnet add package Selenium.Essentials
paket add Selenium.Essentials
Selenium.Essentials Download (Unzip the "nupkg" after downloading)
Dependencies
- Aspose.Cells(>= 19.10.0)
- FluentAssertions(>= 5.9.0)
- HtmlAgilityPack(>= 1.11.16)
- Microsoft.CSharp(>= 4.6.0)
- Microsoft.Win32.Registry(>= 4.6.0)
- Newtonsoft.Json(>= 12.0.2)
- Selenium.Support(>= 3.141.0)
- Selenium.WebDriver(>= 3.141.0)
- System.ValueTuple(>= 4.5.0)
Tags
Focus more on script logic with better consistent script execution, less maintenance, no hardwaits, with improved script execution performance and integrated Api testing framework.
Overview
Selenium provides only option to create only a single generic control which is called the IWebElement. Imagine if you have option to declare controls which resemble the html elements and provide its functionality, for example, Checkbox, Textbox, Button.
Selenium Essentials provide new custom controls giving meaning to your page objects and making it more readable. Every control is defined from a BaseControl which has a set of definitions applicable to all controls as well as its custom actions. For example, Checkbox control will have all properties of the BaseControl and also defines Check() which ticks the checkbox in the UI, UnCheck() which unticks the checkbox, IsChecked returns a bool value based on the control is Checked or Unchecked reading from the UI.
The Custom control also expose the underlying IWebElement as a property used by Selenium, in case you need to do any operations on top of this.
There are plenty of Wait operation defined on the base control which flows through all the custom controls.
There are different overrides to the wait operation where you can control the time to wait, whether to throw exception if fails, message for assertions when the waits are used for assert operations. Some custom control overrides the default wait to give a better meaning.
Read more about controls here
WebDriver and WebElement comes with some useful extensions which helps during the automation. For example, executing javascript, scroll operations, taking screenshot, getting driver capabilities.
There is a simple Api framework, which can help in writing Integration tests using a fluent approach.
Package contains lots of extensions and helpers over different types which will help increase productivity. Example,
- Loading excel and converting to C#
- Converting Json to Dictionary
- Serialization and Deserialization
- Regular Expression, DateTime, String, Enumerable, Async
Benefits
- Readable page objects which clearly defines what each control resemble in the browser
- Custom controls with wrapped operations
-- Checkbox - Check, UnCheck, IsChecked, more
-- Textbox - Custom clear and set operations (extented clear which will make sure the content is cleared by doing Ctrl+a and BackSpace) and Set operation to overcome some responsive issues
-- UnorderedList - Total, Items
-- Select - operations on SelectElement
-- Table - TotalColumns, TotalRows, ColumnNames, GeCellContent, GetRowPosition, GetColumnPosition, more
-- Collection - working with Driver.FindElements(...)
-- FileUpload - UploadFile
-- Button
-- WebControl - for all generic html control
- WebElement and WebDriver extension methods for most of the
- Api framework to write integration tests
-- Supports fluent
-- Support most of the operations
-- Simple and easy to manage the tests
- Extensions which provide many methods for automation engineering works
-- String, RegEx, Enumerable, DatTime, Async, more
- Helpers to load excel, serialization, Json to Dictonary, more
- Attributes for test to load json and xml data.