bunit.template 2.8.4-preview

Prefix Reserved
This is a prerelease version of bunit.template.
dotnet new install bunit.template@2.8.4-preview
                    
This package contains a .NET Template Package you can call from the shell/command line.

GitHub tag Nuget Issues Open

bUnit - a testing library for Blazor components

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, MSTest and TUnit, 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 Adds support for testing Blazor components. Nuget
bUnit.template Template, which currently creates xUnit-based bUnit test projects only. Nuget
bUnit.generators Source code generators to minimize code setup in various situations. Nuget
bUnit.web.query bUnit implementation of testing-library.com's query APIs. Nuget

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

bUnit and .NET version compatibility matrix

bUnit version .NET version
1.x ≥ .netcore3.1 && ≤ .net 9
2.x ≥ .net8

For a migration guide, see Upgrading bUnit.

Sponsors

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

<table border="0"> <tr> <td align="center" width="250"> <a href="https://www.testmuai.com/?utm_medium=sponsor&utm_source=bunit" target="_blank"> <img src="docs/site/sponsors/testmu.png" style="vertical-align: middle;" width="250" height="45" /> <br /> TestMu AI </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.

This package has no dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
2.8.4-preview 86 6/7/2026
2.8.1-preview 93 6/3/2026
2.7.2 2,861 3/31/2026
2.7.1-preview 171 3/31/2026
2.6.2 1,154 2/27/2026
2.5.3 2,246 1/8/2026
2.4.2 727 12/21/2025
2.3.4 619 12/18/2025
2.3.3-preview 444 12/16/2025
2.2.2 972 12/8/2025
2.1.1 1,303 11/21/2025
2.0.66 1,122 11/11/2025
2.0.64-preview 384 10/31/2025
2.0.62-preview 421 10/19/2025
2.0.57-preview 364 10/17/2025
2.0.55-preview 432 10/7/2025
2.0.50-preview 385 9/12/2025
2.0.49-preview 517 8/30/2025
2.0.47-preview 497 8/30/2025
2.0.41-preview 483 6/27/2025
Loading failed

Changes in bUnit 2.8.4-preview


### Added

- New overloads to WaitForHelpers to have async assertions and predicates. Reported by [@radmorecameron](https://github.com/radmorecameron) in #1833. Fixed by [@linkdotnet](https://github.com/linkdotnet).
- `AddAsset` to `BunitContext` to seed the `ResourceAssetCollection` exposed via `ComponentBase.Assets`. Reported by [LasseHerget](https://github.com/LasseHerget) in #1846. Implemented by [@linkdotnet](https://github.com/linkdotnet).

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