WebComponentsHelper 2025.12.17.1

WebComponentsHelper

A modular, reusable Page Object and UI Component library for web automation, built on top of Selenium WebDriver.
Targets .NET Standard 2.0 and .NET 8 for broad compatibility.

Features

• Page Object Model (POM) Support:
  Organize your automation using page objects for maintainability and scalability.
• Reusable UI Components:
  Includes ready-to-use components like TextBoxComponent, ButtonComponent, and extensible base classes for custom components.
• BaseComponent Abstraction:
  All components inherit from BaseComponent, which provides robust Selenium wrapper methods for element interaction and waiting.
• Strongly-Typed Page Objects:
  Example: LoginPage composes TextBoxComponent and ButtonComponent for clear, maintainable test code.
• Extensible:
  Easily add new components (e.g., CheckboxComponent, DropdownComponent) following the same pattern.

Project Structure

/WebComponentsHelper /Components BaseComponent.cs ButtonComponent.cs TextBoxComponent.cs ... /PageObjects LoginPage.cs ...

Class Diagram

class SeleniumBase {
+WebDriver driver +WaitUntilElementExists() +WaitUntilElementVisible() +Click() +InputText() +GetStringValue() ... }

class BaseComponent {
    <<abstract>>
    +By _locator
    +Element
    +VisibleElement
    +IsDisplayed()
    +GetText()
    ...
}

class TextBoxComponent {
    +EnterText()
    +GetValue()
}

class ButtonComponent {
    +Click()
    +IsEnabled()
}

class LoginPage {
    +TextBoxComponent UsernameTextBox
    +TextBoxComponent PasswordTextBox
    +ButtonComponent LoginButton
    +Login()
}

SeleniumBase <|-- BaseComponent
BaseComponent <|-- TextBoxComponent
BaseComponent <|-- ButtonComponent
LoginPage o-- TextBoxComponent
LoginPage o-- ButtonComponent

Usage Example

using OpenQA.Selenium; using WebComponentsHelper.PageObjects;

class Example { public void LoginTest(IWebDriver driver) { var loginPage = new LoginPage(driver); loginPage.Login("user1", "password1"); } }

Example: Login Page Object

namespace WebComponentsHelper.PageObjects { public class LoginPage {
public TextBoxComponent UsernameTextBox { get; } public TextBoxComponent PasswordTextBox { get; } public ButtonComponent LoginButton { get; }

    public LoginPage(IWebDriver driver)
    {
        UsernameTextBox = new TextBoxComponent(driver, By.Id("username"));
        PasswordTextBox = new TextBoxComponent(driver, By.Id("password"));
        LoginButton = new ButtonComponent(driver, By.Id("loginBtn"));
    }

    public void Login(string username, string password)
    {
        UsernameTextBox.EnterText(username);
        PasswordTextBox.EnterText(password);
        LoginButton.Click();
    }
}   

}

Requirements

• .NET Standard 2.0 or .NET 8.0 or later
• Selenium.WebDriver
• SeleniumHelpers (for SeleniumBase and wrappers)

Extending

To add a new component, inherit from BaseComponent and implement your custom logic:

namespace WebComponentsHelper.Components { /// <summary> /// CheckboxComponent represents a checkbox UI component, providing methods to interact with and query its state. /// </summary>

public class CheckboxComponent : BaseComponent
{
    public CheckboxComponent(IWebDriver driver, By locator)
        : base(driver, locator)
    {
    }

    /// <summary>
    /// Checks the checkbox if it is not already checked.
    /// </summary>
    public void Check()
    {
        var checkbox = Element;
        if (!checkbox.Selected)
        {
            Click(checkbox);
        }
    }

    /// <summary>
    /// Unchecks the checkbox if it is checked.
    /// </summary>
    public void Uncheck()
    {
        var checkbox = Element;
        if (checkbox.Selected)
        {
            Click(checkbox);
        }
    }

    /// <summary>
    /// Toggles the checkbox state.
    /// </summary>
    public void Toggle()
    {
        var checkbox = Element;
        Click(checkbox);
    }

    /// <summary>
    /// Returns true if the checkbox is checked.
    /// </summary>
    public bool IsChecked()
    {
        return Element.Selected;
    }
}

}