QualityAutomation.Selenium.Xunit 1.0.2

Quality Automation Selenium Helpers

Framework de automatización UI construido sobre Selenium WebDriver para .NET 6. Incluye drivers multi-browser, extensiones reutilizables, validaciones avanzadas, manejo de sesión, esperas explícitas y utilidades QA listas para usar con xUnit, NUnit y MSTest.

Caracteristicas

Compatible con

Chrome
Firefox
Microsoft Edge
xUnit
NUnit
MSTest

Incluye

DriverFactory multi-browser
Helpers reutilizables
Waits explícitos
Validaciones robustas
Regex validations
Extensiones sobre IWebDriver e IWebElement
Manejo de archivos descargados
Generación de datos aleatorios
Manejo de modales
Session Manager
Validaciones visuales

Tecnologías Utilizadas

¿Qué incluye?

Esta librería no es solo un conjunto de extensiones — es un framework de automatización completo organizado en capas:

Dependencias

Requisitos del Sistema

Para consumir esta librería en tus proyectos de automatización, asegúrate de que el archivo .csproj de tu proyecto de pruebas cumpla con las siguientes especificaciones:

1. Framework y Configuración Básica

• Framework: .NET 6.0 o superior (<TargetFramework>net6.0</TargetFramework>)
• Habilitar modo test: <IsTestProject>true</IsTestProject>
• Deshabilitar empaquetado: <IsPackable>false</IsPackable>

2. Estructura del .csproj Recomendada

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <TargetFramework>net6.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
    
    
    <IsPackable>false</IsPackable>
    <IsTestProject>true</IsTestProject>
  </PropertyGroup>

  <ItemGroup>
    
    <PackageReference Include="QualityAutomation.Selenium.Xunit" Version="1.0.X" />
    
    
    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.3.2" />
    <PackageReference Include="xunit" Version="2.4.2" />
    <PackageReference Include="xunit.runner.visualstudio" Version="2.4.5" />
  </ItemGroup>

</Project>

Instalación

Los GlobalUsings del framework ya incluyen los namespaces de Selenium, WaitHelpers y los modelos internos. Solo necesitás agregar en tu proyecto:

Arquitectura del proyecto

src/TestFrame
├── GlobalUsings.cs
├── Base/
│   └── BasePage.cs              ← Clase base para Page Objects
├── Constants/
│   └── FrameworkDefaults.cs     ← Timeouts y configuración global
├── Drivers/
│   └── DriverFactory.cs         ← Creación de ChromeDriver
├── Extensions/
│   ├── TableExtensions.cs       ← Extensiones sobre tablas HTML
│   ├── WebDriverExtensions.cs   ← Extensiones sobre IWebDriver
│   └── WebElementExtensions.cs  ← Extensiones sobre IWebElement
├── Helpers/
│   ├── FileHelper.cs            ← Descarga y manejo de archivos
│   ├── LinkHelper.cs            ← Extracción y filtro de enlaces
│   ├── ModalHelper.cs           ← Confirmación de diálogos y modales
│   ├── NavigationHelper.cs      ← Navegación del browser
│   ├── RandomHelper.cs          ← Generación de datos de prueba
│   ├── ValidationHelper.cs      ← Validación de campos por reglas
│   └── WaitHelper.cs            ← Esperas explícitas
├── Models/
│   ├── SearchResult.cs
│   └── ValidationResult.cs
├── Session/
│   └── SessionManager.cs        ← Login, logout y cierre de sesión
└── Validations/
    ├── ContentValidation.cs     ← Validación de contenido en el DOM
    ├── InputValidation.cs       ← Validación de valores en inputs
    ├── RegexValidation.cs       ← Validación por expresiones regulares
    └── VisualValidation.cs      ← Detección de errores visibles en pantalla

Guía de uso rápida

1. Crear el driver, abrir y cerrar sesión

Ejemplo en un constructor de test (xUnit)

• IWebDriver chrome = DriverFactory.CreateChrome();
• IWebDriver firefox = DriverFactory.CreateFirefox();
• IWebDriver edge = DriverFactory.CreateEdge();

using OpenQA.Selenium;

public class TestConLogin 
{
    private IWebDriver driver;
    private SessionManager log;

    public void EjecutarPruebaCompleta()
    {
        driver = DriverFactory.CreateChrome(false); 
        log = new SessionManager(driver);

        log.NavigateTo("example.com");
        log.Login(By.Id("user"), By.Id("pass"), "mi_usuario", "mi_clave", By.Id("submit"));
        
        log.LogoutByUrl("example.com");
        log.Logout(By.Id("btn-logout"));

        driver.Quit();
    }
}

2. Esperas explícitas (WaitHelper)

var el = WaitHelper.WaitVisible(driver, By.Id("resultado"));

var btn = WaitHelper.WaitClickable(driver, By.XPath("//button[@type='submit']"), 15);

bool appeared = WaitHelper.WaitExists(driver, By.ClassName("toast-success"));

string text = WaitHelper.WaitText(driver, By.Id("lblMensaje"));

3. Extensiones del driver (WebDriverExtensions)

bool exists = driver.Exists(By.Id("panel"));

bool hasContent = driver.HasRobustContent("//table", 5);

bool fieldHasData = driver.FieldHasData("txtName");

string value = driver.GetInputValue(By.Id("txtAmount"));

string text = driver.TryGetText(By.ClassName("title"));

4. Extensiones del elemento (WebElementExtensions)

input.ClearAndType("Datos");

search.ClearTypeAndEnter("Datos");

combo.ClickArrowDownAndEnter(2);

button.SafeClick();

string text = label.GetCleanText();

5. Extensiones de la tabla (TableExtensions)

string cellValue = driver.GetFirstRowCellText(By.XPath("//table/tbody/tr[1]/td[2]"));

bool matches = driver.FirstRowCellMatches(By.XPath("//table/tbody/tr[1]/td[1]"), "Juan Pérez");

bool hasRows = driver.HasAnyRow(By.XPath("//table/tbody/tr"));

bool isEmpty = driver.HasEmptyMessage(By.ClassName("empty-message"));

6. Archivos descargados (FileHelper)

bool downloaded = FileHelper.WaitForFileDownload(
    @"C:\Downloads",
    "*.xlsx");

bool exists = FileHelper.FileExistsByPattern(
    @"C:\Downloads",
    "*.pdf");

FileHelper.DeleteFilesByPattern(
    @"C:\Downloads",
    "*.xlsx");

7. Manejo de Links (LinkHelper)

var links = LinkHelper.GetAllLinks(driver);

bool exists = LinkHelper.ExistsLinkWithText(driver,
    "Inicio");

bool hasUrl = LinkHelper.HasLinkToUrl(driver,
    "google.com");

bool opensNewTab = LinkHelper.LinkOpensNewTab(
    driver,
    By.Id("external-link"));

8. Validación por Regex (RegexValidation)

RegexValidation.IsNumeric("123");

RegexValidation.IsDecimalNumber("12.50");

RegexValidation.IsEmail("qa@test.com");

RegexValidation.IsPhoneNumber("74291038");

RegexValidation.IsRomanNumber("XIV");

RegexValidation.IsCarPlate("1234 ABC");

RegexValidation.IsImageExtension("photo.jpg");

9. Datos aleatorios para pruebas (RandomHelper)

string name = RandomHelper.RandomString(10);

string email = RandomHelper.RandomEmail();

decimal amount = RandomHelper.RandomDecimal(10, 999);

string lorem = RandomHelper.RandomLoremIpsum(10, 20);

bool active = RandomHelper.RandomBool();

10. Manejo de validaciones (ContentValidation)

var result = ContentValidation.ValidateRobustContent(
    driver,
    "//table",
    3);

if (!result.IsValid)
{
    Console.WriteLine(result.Message);
}

11. Manejo de validaciones (VisualValidation)

var errors = new List<string>();

VisualValidation.CollectVisibleErrors(
    driver,
    errors,
    "Login",
    By.ClassName("error"),
    By.ClassName("alert-danger"));

Referencia completa de métodos

WebElementExtensions

WebDriverExtensions

TableExtensions

WaitHelper

RandomHelper

FrameworkDefaults

Notas importantes

SafeClick vs Click nativo
SafeClick() verifica Displayed && Enabled antes de actuar. Previene ElementNotInteractableException en botones que se habilitan/deshabilitan dinámicamente.

ClearAndType vs SendKeys directo
En aplicaciones con valores por defecto, SendKeys sin Clear() previo concatena texto. ClearAndType garantiza que el campo empiece vacío.

Autocomplete y dropdowns dinámicos
ClearTypeArrowDownAndEnter replica el flujo real del usuario: filtra escribiendo, navega con flechas y confirma. Es más estable que localizar el ítem del dropdown directamente en el DOM.

FileHelper en archicos locales
FileHelper se encarga de verificar la existencia de un archivo al igual que eliminar y verificar la descarga WaitForFileDownload() que igual es compatible con Chrome, Firefox y Edge Chromium.

ValidationResult como tipo de retorno
Todos los métodos de validación retornan ValidationResult. Usá result.IsValid para bifurcar y result.Message para logging o assertions descriptivos en el reporte del test.

DriverFactory y CI/CD
El modo headless: true incluye --window-size=1920,1080 automáticamente y desactiva GPU para entornos sin pantalla como pipelines de Azure DevOps.

Autor : Personal QA :v