bunit 1.26.29-preview.g6269f42046

Prefix Reserved
This is a prerelease version of bunit.
There is a newer version of this package available.
See the version list below for details.
dotnet add package bunit --version 1.26.29-preview.g6269f42046                
NuGet\Install-Package bunit -Version 1.26.29-preview.g6269f42046                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="bunit" Version="1.26.29-preview.g6269f42046" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add bunit --version 1.26.29-preview.g6269f42046                
#r "nuget: bunit, 1.26.29-preview.g6269f42046"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install bunit as a Cake Addin
#addin nuget:?package=bunit&version=1.26.29-preview.g6269f42046&prerelease

// Install bunit as a Cake Tool
#tool nuget:?package=bunit&version=1.26.29-preview.g6269f42046&prerelease                

GitHub tag Nuget Issues Open

bUnit - a testing library for Blazor components

<a href="https://www.telerik.com/blazor-ui?utm_source=egilhansen&utm_medium=cpm&utm_campaign=blazor-trial-readme-sponsored-message#gh-light-mode-only"> <img align="right" width="300" src="https://raw.githubusercontent.com/bUnit-dev/bUnit/main/docs/site/sponsors/progress-ad-2022-light-mode.svg#gh-light-mode-only" /> </a> <a href="https://www.telerik.com/blazor-ui?utm_source=egilhansen&utm_medium=cpm&utm_campaign=blazor-trial-readme-sponsored-message#gh-dark-mode-only"> <img align="right" width="300" src="https://raw.githubusercontent.com/bUnit-dev/bUnit/main/docs/site/sponsors/progress-ad-2022-dark-mode.svg#gh-dark-mode-only" /> </a>

bUnit is a testing library for Blazor Components. Its goal is to make it easy to write comprehensive, stable unit tests. With bUnit, you can:

  • Setup and define components under tests using C# or Razor syntax
  • Verify outcomes using semantic HTML comparer
  • Interact with and inspect components as well as trigger event handlers
  • Pass parameters, cascading values and inject services into components under test
  • Mock IJSRuntime, Blazor authentication and authorization, and others

bUnit builds on top of existing unit testing frameworks such as xUnit, NUnit, and MSTest, which run the Blazor component tests in just the same way as any normal unit test. bUnit runs a test in milliseconds, compared to browser-based UI tests which usually take seconds to run.

Go to bUnit.dev to learn more.

NuGet Downloads

bUnit is available on NuGet in various incarnations. Most should just pick the bUnit package:

Name Description NuGet Download Link
bUnit Includes the bUnit.core and bUnit.web packages. Nuget
bUnit.core Core library that enables rendering a Blazor component in a test context. Nuget
bUnit.web Adds support for testing Blazor components for the web. This includes bUnit.core. Nuget
bUnit.template Template, which currently creates xUnit-based bUnit test projects only Nuget

To get started, head to the getting started documentation to learn more.

Sponsors

A huge thank you to the sponsors of my work with bUnit. The higher tier sponsors are:

<table border="0"> <tr> <td align="center" width="120"> <a href="https://github.com/Progress-Telerik"> <img src="https://avatars.githubusercontent.com/u/57092419?s=460" alt="@Progress-Telerik" class="avatar" width="72" height="72" /> <br /> Progress Telerik </a> </td> <td align="center" width="120"> <a href="https://github.com/syncfusion"> <img class="avatar" src="https://avatars.githubusercontent.com/u/1699795?s=460" width="72" height="72" alt="@syncfusion" /> <br /> Syncfusion </a> </td> <td align="center" width="120"> <a href="https://github.com/aws"> <img class="avatar" src="https://avatars.githubusercontent.com/u/2232217?s=200&v=4" width="72" height="72" alt="@aws" /> <br /> Amazon Web Services </a> </td> </tr> </table>

Contributors

Shout outs and a big thank you to all the contributors to the library, including those that raise issues, provide input to issues, and those who send pull requests. Thank you!

These good people have contributed code or documentation to bUnit:

<a href="https://github.com/bUnit-dev/bUnit/graphs/contributors"> <img src="https://contrib.rocks/image?repo=bUnit-dev/bUnit" /> </a>

Code of conduct

This project has adopted the code of conduct defined by the Contributor Covenant to clarify expected behavior in our community. For more information see the .NET Foundation Code of Conduct.

.NET Foundation

This project is supported by the .NET Foundation.

There are no supported framework assets in this package.

Learn more about Target Frameworks and .NET Standard.

  • .NETStandard 2.1

  • net5.0

  • net6.0

  • net7.0

  • net8.0

NuGet packages (21)

Showing the top 5 NuGet packages that depend on bunit:

Package Downloads
Blazored.Toast.TestExtensions

A testing library to provide helper extensions for Blazored.Toast

FluentAssertions.BUnit

Extension methods that provide fluent assertions on top of BUnit.

StoicDreams.TestFramework.Blazor

Extended functionality of Stoic Dreams Test Framework, adding funtionality to handle testing against rendered .razor components for unit and integration testing.

Breakdance.Blazor

Breakdance is a testing framework for managing the dangerous dance of shipping public APIs. This package helps generate public API reports for any .NET assembly, and compare them against a prior unit test run. That way, if something in the API surface changed, the unit test will fail.

Vertiq.Modules.DiagnosticModule

A highly modular framework for writing Blazor applications with a hassle-free, vertical-sliced architecture - Easy. Flexible. Focused.

GitHub repositories (35)

Showing the top 5 popular GitHub repositories that depend on bunit:

Repository Stars
MudBlazor/MudBlazor
Blazor Component Library based on Material Design principles with an emphasis on ease of use and extensibility
ServiceStack/ServiceStack
Thoughtfully architected, obscenely fast, thoroughly enjoyable web services for all
dotnet/aspire
Tools, templates, and packages to accelerate building observable, production-ready apps
microsoft/fluentui-blazor
Microsoft Fluent UI Blazor components library. For use with ASP.NET Core Blazor applications
Megabit/Blazorise
Blazorise is a component library built on top of Blazor with support for CSS frameworks like Bootstrap, Tailwind, Bulma, AntDesign, and Material.
Version Downloads Last updated
2.0.33-preview 5,985 7/21/2024
2.0.24-preview 20,521 3/13/2024
2.0.22-preview 548 3/9/2024
1.38.5 6,462 1/12/2025
1.37.7 26,117 12/13/2024
1.36.0 85,268 11/12/2024
1.35.3 270 11/12/2024
1.34.0 37,149 11/1/2024
1.33.3 89,657 10/11/2024
1.33.1-preview 80 10/7/2024
1.32.7 30,998 10/4/2024
1.31.3 181,419 8/16/2024
1.31.1-preview 127 8/14/2024
1.30.3 83,663 7/21/2024
1.29.5 58,555 7/5/2024
1.28.9 346,184 4/19/2024
1.28.4-preview 632 3/17/2024
1.28.2-preview 716 3/6/2024
1.27.17 230,284 3/2/2024
1.27.16-preview 634 3/2/2024
1.27.12-preview 1,400 2/23/2024
1.27.11-preview 1,031 2/19/2024
1.27.5-preview 8,931 1/9/2024
1.27.2-preview 1,468 12/28/2023
1.27.1-preview 1,346 12/28/2023
1.26.64 567,577 12/20/2023
1.26.61-preview.g17cfa782a0 182 12/17/2023
1.26.61-preview 1,271 12/17/2023
1.26.29-preview.ga9c0cd8510 218 12/12/2023
1.26.29-preview.g9431b069b0 116 12/12/2023
1.26.29-preview.g91e9e2287f 144 12/10/2023
1.26.29-preview.g6269f42046 106 12/12/2023
1.26.29-preview.g1595589333 100 12/13/2023
1.26.28-preview.g08ea910651 107 12/10/2023
1.26.27-preview.geb23ca9882 122 12/8/2023
1.26.27-preview.ge5c30f7b82 102 12/8/2023
1.26.26-preview.g3fdaceb6d0 724 11/25/2023
1.26.25-preview.gf8662d54ff 108 11/25/2023
1.26.25-preview.ga796d3d959 100 11/25/2023
1.26.25-preview.g43750dfc46 101 11/25/2023
1.26.25-preview.g028ac0e5cc 99 11/25/2023
1.26.24-preview.ge6af60b555 97 11/24/2023
1.26.23-preview 1,501 11/24/2023
1.26.20-preview 1,208 11/24/2023
1.26.19-preview 1,191 11/24/2023
1.26.18-preview 1,294 11/24/2023
1.26.17-preview 1,119 11/23/2023
1.26.4-preview 2,286 11/20/2023
1.26.1-preview 1,281 11/17/2023
1.25.3 216,305 11/14/2023
1.25.2-preview 1,849 11/13/2023
1.25.1-preview 19,280 10/21/2023
1.25.0-preview 1,580 10/21/2023
1.24.10 143,127 10/14/2023
1.24.9-preview 1,335 10/14/2023
1.24.8-preview 1,562 10/14/2023
1.24.3-preview 1,931 10/6/2023
1.23.9 139,324 9/6/2023
1.23.8-preview 1,499 9/5/2023
1.23.3-preview 2,281 8/23/2023
1.23.1-preview 2,543 7/31/2023
1.22.19 170,452 7/28/2023
1.22.18-preview 2,393 7/23/2023
1.22.16-preview 1,781 7/15/2023
1.22.15-preview 1,390 7/14/2023
1.22.14-preview 1,342 7/13/2023
1.22.13-preview 1,396 7/12/2023
1.22.7-preview 9,508 7/3/2023
1.21.14-preview 1,452 7/1/2023
1.21.9 92,169 7/2/2023 1.21.9 is deprecated because it has critical bugs.
1.21.8-preview 1,541 6/30/2023
1.21.7-preview 1,389 6/29/2023
1.21.5-preview 1,247 6/28/2023
1.21.3-preview 1,525 6/25/2023
1.20.8 141,138 5/21/2023 1.20.8 is deprecated because it has critical bugs.
1.20.7-preview 1,512 5/17/2023
1.19.14 143,225 4/26/2023 1.19.14 is deprecated because it has critical bugs.
1.18.4 565,029 2/26/2023
1.17.2 25,681 2/22/2023
1.16.2 113,523 2/7/2023
1.15.5 30,224 2/4/2023
1.14.4 128,832 1/11/2023
1.13.5 107,075 12/16/2022
1.12.6 273,348 11/8/2022
1.12.4-preview 1,991 10/26/2022
1.11.7 94,471 10/13/2022
1.10.14 105,008 9/16/2022
1.10.13-preview 1,529 9/16/2022
1.9.8 391,810 6/7/2022
1.9.7-preview 3,201 5/26/2022
1.9.1-preview 2,023 5/21/2022
1.8.15 62,436 5/19/2022
1.7.7 67,712 4/29/2022
1.6.4 343,124 2/22/2022
1.5.12 29,977 2/15/2022
1.4.15 200,628 12/18/2021
1.3.42 157,572 11/9/2021
1.3.38-preview 1,616 11/9/2021
1.3.35-preview 19,075 10/20/2021
1.3.30-preview 3,051 10/15/2021
1.2.49 176,963 8/9/2021
1.2.49-preview 1,984 8/7/2021
1.2.36-preview 6,287 6/25/2021
1.2.35-preview 1,497 6/24/2021
1.2.28-preview 3,253 5/26/2021
1.2.27-preview 1,645 5/22/2021
1.2.26-preview.gd07edb4207 230 5/21/2021
1.1.5 248,770 4/30/2021
1.0.19 32,123 4/11/2021
1.0.16 7,229 4/11/2021
1.0.0-preview-02 3,645 3/26/2021
1.0.0-preview-01 55,159 12/24/2020
1.0.0-beta-11 39,526 10/26/2020
1.0.0-beta-10 30,678 9/15/2020

Changes in bUnit 1.26.29-preview.g6269f42046

### Changed

- Upgraded AngleSharp to 1.0.7.

### Fixed

- When the `TestContext` was disposed, the Blazor Renderer itself didn't dispose components under test. By [@linkdotnet](https://github.com/linkdotnet).
- When navigating, the `HistoryEntryState` on `NavigationManager` will be populated. By [@linkdotnet](https://github.com/linkdotnet).

### Added

- New overloads for `IRenderedFragmentBase.InvokeAsync` that allow retrieving the work item's return value. By [@jcparkyn](https://github.com/jcparkyn).

See the full changelog at https://github.com/bUnit-dev/bUnit/releases