👁 Image
E13.Common.Nunit.UI 2025.117.22

E13.Common.Nunit.UI

👁 NuGet Version
👁 License: MIT

Overview

E13.Common.Nunit.UI is a specialized package within the E13.Common collection designed for UI testing with NUnit and PuppeteerSharp. It extends E13.Common.Nunit with UI-specific testing utilities, including browser automation, screenshot comparison, and authentication helpers for web applications.

Features

• UI Test Fixtures: Base classes for UI testing with PuppeteerSharp integration
• Screenshot Comparison: Automated visual regression testing with screenshot comparison
• Authentication Support: Helpers for testing authenticated UI flows
• Browser Automation: Utilities for interacting with web pages in tests
• Test Organization: Attributes and extensions for organizing UI tests

Installation

dotnet add package E13.Common.Nunit.UI

Usage

Creating a UI Test Fixture

using E13.Common.Nunit.UI;
using Microsoft.Extensions.Hosting;
using NUnit.Framework;
using PuppeteerSharp;
using System.Threading.Tasks;

// Create a test fixture for your UI
public class MyUITests : BaseUIFixture
{
 // Define viewport dimensions
 public MyUITests() 
 : base(1280, 720, () => CreateHostBuilder())
 {
 }
 
 private static IHostBuilder CreateHostBuilder() =>
 Host.CreateDefaultBuilder()
 .ConfigureWebHostDefaults(webBuilder =>
 {
 webBuilder.UseStartup<TestStartup>();
 });
 
 [Test]
 public async Task HomePage_LoadsCorrectly()
 {
 // Navigate to a page
 await Page.GoToAsync("https://localhost:5001");
 
 // Take and compare a screenshot
 await Page.ConfirmScreenshot("HomePage");
 
 // Assert page content
 var title = await Page.GetTitleAsync();
 Assert.AreEqual("Home Page", title);
 }
}

Testing Authenticated UI Flows

using E13.Common.Nunit.UI;
using Microsoft.Extensions.Hosting;
using NUnit.Framework;
using System.Threading.Tasks;

public class AuthenticatedUITests : BaseAuthUIFixture
{
 protected override string AuthUrl => "https://localhost:5001/login";
 
 public AuthenticatedUITests() 
 : base(1280, 720, () => CreateHostBuilder())
 {
 }
 
 private static IHostBuilder CreateHostBuilder() => 
 Host.CreateDefaultBuilder()
 .ConfigureWebHostDefaults(webBuilder =>
 {
 webBuilder.UseStartup<TestStartup>();
 });
 
 [Test]
 [RequiresAuth]
 public async Task SecurePage_WhenAuthenticated_ShowsContent()
 {
 // The [RequiresAuth] attribute will trigger automatic login
 // Navigate to a secure page
 await Page.GoToAsync("https://localhost:5001/secure");
 
 // Take and compare a screenshot
 await Page.ConfirmScreenshot("SecurePage");
 
 // Assert secure content is visible
 var content = await Page.QuerySelectorAsync(".secure-content");
 Assert.IsNotNull(content);
 }
}

Dependencies

• .NET 9.0
• PuppeteerSharp
• PuppeteerSharp.Contrib.Extensions
• PuppeteerSharp.Contrib.Should
• Microsoft.Extensions.Hosting
• E13.Common.Nunit

Related Packages

E13.Common.Nunit.UI is part of the E13.Common collection, which includes:

• E13.Common.Core - Core utilities and base classes
• E13.Common.Nunit - Base NUnit testing utilities
• E13.Common.Nunit.Api - NUnit utilities for API testing
• E13.Common.Blazor - Blazor UI components
• E13.Common.AspNet - ASP.NET shared components

Contributing

Contributions to E13.Common.Nunit.UI are welcome. If you have suggestions or improvements, please submit an issue or create a pull request in the GitHub repository.

License

This project is licensed under the MIT License. For more details, see the LICENSE file in the repository.