BlazorTestingLibrary 1.0.0

BlazorTestingLibrary

A (better?) React-like testing approach for Blazor apps. This is still a work in progress but it's useable 😃

Quickstart Example

using BlazorTestingLibrary;
using Bunit;
using FluentAssertions;
using Xunit;

...

[Fact]
public void SubmittingAValidForm()
{
    using var context = new TestContext();
    var component = context.RenderComponent<ExampleForm>();

    var forenameInput = component.FindByLabelText("Forename:");
    forenameInput.Change("John");

    var surnameInput = component.FindByLabelText("Surname:");
    surnameInput.Change("Smith");

    var emailInput = component.FindByLabelText("Email Address:");
    emailInput.Change("john.smith@developer.com");

    var submitButton = component.FindByText("Submit");
    submitButton.Click();

    component.FindByText("Your form is Submitted").Should().NotBeNull();
}

Search Methods

FindByText

Searches for a given text string in the DOM and returns the first element that contains it. Throws if there is more than one element found or nothing is found.

FindAllByText

Searches for a given text string in the DOM and returns all instances of elements that contain it. Throws if nothing is found.

FindById

Searches for an element with a given id. Throws if there is more than one element found or nothing is found.

FindByLabelText

Searches for an input with a particular label attached to it via for attribute. Throws if there is more than one element found or nothing is found.

Verify Methods

ShouldHaveClass

Asserts that a given element has a class.

ShouldHaveId

Asserts that a given element has an id.

Waiting for a condition (WaitFor)

Sometimes you may need to wait for something to happen, which you can do with WaitFor(Action action, int timeout = 5000). This will perform an action until it doesn't throw or the timeout is met. A ActionTimedOutException will be thrown if the timeout is reached.

Libraries Used

• FluentAssertions
• BUnit
• RichardSzalay.MockHttp

Footnotes

This library currently only targets net6.0.