OneStreamAutoLibrary.WebUIHelpers 2026.1.16.1

WebUIHelpers

A cross-platform library for web UI automation using Selenium WebDriver, targeting .NET Standard 2.0 and .NET 8. This library provides reusable page objects, components, and helpers for building maintainable browser automation tests for web applications.

Integration

WebUIHelpers depends on and uses:

• SeleniumHelpers - Selenium WebDriver infrastructure, browser management, and automation base classes
• CommonHelpers - Shared utilities, logging interfaces (ITestLogger), reporting, and common infrastructure

This library is designed to be consumed by web test projects requiring page object models and reusable web UI components.

Features

• Page Object Model (POM):
  Structured, maintainable page objects for web UI automation

• Reusable Components:
  Pre-built components for common web elements:

  • ButtonComponent - Button interactions
  • TextBoxComponent - Text input operations
  • BaseComponent - Base class for custom components

• Common Page Objects:
  Ready-to-use page objects for common scenarios:

  • LoginPage - Login page automation with support for application selection
  • Additional common windows and dialogs

• ITestLogger Integration:
  Built-in logging support for page-level actions and diagnostics

• Selenium WebDriver Support:
  Full integration with Selenium WebDriver for browser automation

Prerequisites

• .NET Standard 2.0, .NET 8, or compatible runtime
• SeleniumHelpers - Selenium WebDriver infrastructure
• CommonHelpers - Shared utilities and logging
• Selenium.WebDriver

Installation

Add the library to your project:

dotnet add package WebUIHelpers

Usage Example

Basic Login Page Usage

using OpenQA.Selenium; using SeleniumHelpers; using WebUIHelpers.PageObjects.CommonWindows; using CommonHelpers.Logging;

public class WebLoginTest { public void LoginTest() {

// Create browser using SeleniumHelpers 
using IWebDriver driver = Browser.CreateBrowser("Chrome", "TestSession");
// Create logger (from CommonHelpers)
ITestLogger logger = new YourLoggerImplementation();

//Use LoginPage from WebUIHelpers
LoginPage loginPage = new LoginPage(driver, logger);
loginPage.Login("https://example.com", "username", "password");

// Select application from dropdown
loginPage.SelectApplication("MyApplication");

logger.Info("Login successful");

} }

Using Components Directly

using OpenQA.Selenium; using WebUIHelpers.Components;

public void ComponentExample(IWebDriver driver) { // Use ButtonComponent var submitButton = new ButtonComponent(driver, By.Id("submit-btn")); submitButton.Click();

// Use TextBoxComponent var usernameBox = new TextBoxComponent(driver, By.Id("username")); usernameBox.EnterText("testuser"); }

Creating Custom Page Objects

using OpenQA.Selenium; using SeleniumHelpers; using CommonHelpers.Logging; using WebUIHelpers.Components;

namespace YourProject.PageObjects { public class DashboardPage : SeleniumBase {

private static readonly By _searchBoxLocator = By.Id("search"); private static readonly By _searchButtonLocator = By.CssSelector("[data-automation-id='search-btn']"); private readonly ITestLogger _logger;

public TextBoxComponent SearchBox { get; } public ButtonComponent SearchButton { get; }

public DashboardPage(IWebDriver driver, ITestLogger logger) : base(driver) { _logger = logger; SearchBox = new TextBoxComponent(driver, _searchBoxLocator); SearchButton = new ButtonComponent(driver, _searchButtonLocator); }

public void Search(string searchTerm) { WaitUntilElementVisible(_searchBoxLocator); SearchBox.EnterText(searchTerm); SearchButton.Click(); _logger?.Info($"Searched for: {searchTerm}"); } } }

Components

ButtonComponent

Handles button click interactions with built-in waits.

Methods:

• Click() - Clicks the button
• IsDisplayed() - Checks if button is visible
• GetText() - Gets button text

TextBoxComponent

Handles text input operations.

Methods:

• EnterText(string text) - Enters text into the field
• Clear() - Clears the text field
• GetText() - Gets current text value
• IsDisplayed() - Checks if textbox is visible

Project Structure

WebUIHelpers/ ├── Components/ │ ├── BaseComponent.cs # Base class for all components │ ├── ButtonComponent.cs # Button interactions │ └── TextBoxComponent.cs # Text input operations ├── PageObjects/ │ └── CommonWindows/ │ └── LoginPage.cs # Login page object with application selection └── README.md

Dependencies

This library depends on:

• SeleniumHelpers - Provides:

  • Browser - Browser creation and management
  • SeleniumBase - Base class with common automation methods
  • ScreenCaptureLibrary - Screenshot functionality
  • WebDriver extensions and utilities

• CommonHelpers - Provides:

  • ITestLogger - Logging interface for page objects
  • Shared utilities and infrastructure
  • Reporting helpers