bunit 2.0.55-preview

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 2.0.55-preview
                    
NuGet\Install-Package bunit -Version 2.0.55-preview
                    
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="2.0.55-preview" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="bunit" Version="2.0.55-preview" />
                    
Directory.Packages.props
<PackageReference Include="bunit" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add bunit --version 2.0.55-preview
                    
#r "nuget: bunit, 2.0.55-preview"
                    
#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.
#:package bunit@2.0.55-preview
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=bunit&version=2.0.55-preview&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=bunit&version=2.0.55-preview&prerelease
                    
Install as a Cake Tool

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="120"> <a href="https://www.syncfusion.com/blazor-components?utm_source=bunit&utm_medium=cpc&utm_campaign=bunit_blazor_bancy25"> <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/JetBrainsOfficial"> <img class="avatar" src="https://avatars.githubusercontent.com/u/60931315?v=4" width="72" height="72" alt="@JetBrainsOfficial" /> <br /> JetBrains </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.

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (23)

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.

bunit.web.query

bunit.web.query is an experimental package that provides an bUnit version of the https://testing-library.com/ APIs.

Blazorise.Tests.bUnit

Blazorise is a component library built on top of Blazor and CSS frameworks like Bootstrap, Bulma and Material.

GitHub repositories (38)

Showing the top 20 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
Aspire is the tool for code-first, extensible, observable dev and deploy.
microsoft/fluentui-blazor
Microsoft Fluent UI Blazor components library. For use with ASP.NET Core Blazor applications
dotnetcore/BootstrapBlazor
Bootstrap Blazor is an enterprise-level UI component library based on Bootstrap and Blazor.
Megabit/Blazorise
Blazorise is a component library built on top of Blazor with support for CSS frameworks like Bootstrap, Tailwind, Bulma, AntDesign, and Material.
Blazor-Diagrams/Blazor.Diagrams
A fully customizable and extensible all-purpose diagrams library for Blazor
masastack/MASA.Blazor
Blazor UI component library based on Material Design. Support Blazor Server, Blazor WebAssembly and MAUI Blazor.
abpframework/abp-samples
Sample solutions built with the ABP Framework
CodeMazeBlog/CodeMazeGuides
The main repository for all the Code Maze guides
runceel/ReactiveProperty
ReactiveProperty provides MVVM and asynchronous support features under Reactive Extensions. Target frameworks are .NET 6+, .NET Framework 4.7.2 and .NET Standard 2.0.
Azure-Samples/azure-search-openai-demo-csharp
A sample app for the Retrieval-Augmented Generation pattern running in Azure, using Azure Cognitive Search for retrieval and Azure OpenAI large language models to power ChatGPT-style and Q&A experiences.
meziantou/Meziantou.Framework
Aguafrommars/TheIdServer
OpenID/Connect, OAuth2, WS-Federation and SAML 2.0 server based on Duende IdentityServer and ITFoxtec Identity SAML 2.0 with its admin UI
Blazored/Toast
A JavaScript free toast library for Blazor and Razor Component applications
Blazored/FluentValidation
A library for using FluentValidation with Blazor
CodeBeamOrg/CodeBeam.MudBlazor.Extensions
Useful third party extension components for MudBlazor, from the contributors.
jsakamoto/BlazingStory
The clone of "Storybook" for Blazor, a frontend workshop for building UI components and pages in isolation.
LumexUI/lumexui
🚀 A versatile Blazor UI library built using Tailwind CSS.
linkdotnet/Blog
A blog (engine) completely written in C# and Blazor. It aims to be a simple use and easy to extend platform. Blogposts are written in Markdown and are rendered to HTML. This gives all the flexibility needed to express yourself but also have an easy way of creating posts in the first place.
Version Downloads Last Updated
2.0.66 15,529 11/11/2025
2.0.64-preview 1,035 10/31/2025
2.0.62-preview 1,070 10/19/2025
2.0.57-preview 106 10/17/2025
2.0.55-preview 474 10/7/2025
2.0.50-preview 6,058 9/12/2025
2.0.49-preview 647 8/30/2025
2.0.47-preview 225 8/30/2025
2.0.41-preview 10,619 6/27/2025
2.0.36-preview 68,138 2/21/2025
2.0.33-preview 35,906 7/21/2024
2.0.24-preview 44,567 3/13/2024
2.0.22-preview 2,106 3/9/2024
1.40.0 565,533 6/14/2025
1.39.5 370,157 4/4/2025
1.38.5 543,510 1/12/2025
1.37.7 121,896 12/13/2024
1.36.0 355,705 11/12/2024
1.35.3 9,140 11/12/2024
1.34.0 141,656 11/1/2024
1.33.3 202,922 10/11/2024
1.33.1-preview 280 10/7/2024
1.32.7 64,905 10/4/2024
1.31.3 312,829 8/16/2024
1.31.1-preview 343 8/14/2024
1.30.3 121,225 7/21/2024
1.29.5 93,507 7/5/2024
1.28.9 543,976 4/19/2024
1.28.4-preview 831 3/17/2024
1.28.2-preview 925 3/6/2024
1.27.17 319,982 3/2/2024
1.27.16-preview 829 3/2/2024
1.27.12-preview 1,589 2/23/2024
1.27.11-preview 1,283 2/19/2024
1.27.5-preview 11,706 1/9/2024
1.27.2-preview 1,667 12/28/2023
1.27.1-preview 1,561 12/28/2023
1.26.64 668,616 12/20/2023
1.26.61-preview.g17cfa782a0 357 12/17/2023
1.26.61-preview 1,478 12/17/2023
1.26.29-preview.ga9c0cd8510 394 12/12/2023
1.26.29-preview.g9431b069b0 301 12/12/2023
1.26.29-preview.g91e9e2287f 323 12/10/2023
1.26.29-preview.g6269f42046 271 12/12/2023
1.26.29-preview.g1595589333 272 12/13/2023
1.26.28-preview.g08ea910651 292 12/10/2023
1.26.27-preview.geb23ca9882 297 12/8/2023
1.26.27-preview.ge5c30f7b82 271 12/8/2023
1.26.26-preview.g3fdaceb6d0 976 11/25/2023
1.26.25-preview.gf8662d54ff 282 11/25/2023
1.26.25-preview.ga796d3d959 270 11/25/2023
1.26.25-preview.g43750dfc46 275 11/25/2023
1.26.25-preview.g028ac0e5cc 267 11/25/2023
1.26.24-preview.ge6af60b555 278 11/24/2023
1.26.23-preview 1,711 11/24/2023
1.26.20-preview 1,421 11/24/2023
1.26.19-preview 1,380 11/24/2023
1.26.18-preview 1,501 11/24/2023
1.26.17-preview 1,313 11/23/2023
1.26.4-preview 2,467 11/20/2023
1.26.1-preview 1,503 11/17/2023
1.25.3 258,364 11/14/2023
1.25.2-preview 2,452 11/13/2023
1.25.1-preview 27,699 10/21/2023
1.25.0-preview 1,777 10/21/2023
1.24.10 170,338 10/14/2023
1.24.9-preview 1,539 10/14/2023
1.24.8-preview 1,760 10/14/2023
1.24.3-preview 2,138 10/6/2023
1.23.9 147,206 9/6/2023
1.23.8-preview 1,707 9/5/2023
1.23.3-preview 2,498 8/23/2023
1.23.1-preview 2,775 7/31/2023
1.22.19 184,829 7/28/2023
1.22.18-preview 2,617 7/23/2023
1.22.16-preview 2,011 7/15/2023
1.22.15-preview 1,616 7/14/2023
1.22.14-preview 1,579 7/13/2023
1.22.13-preview 1,618 7/12/2023
1.22.7-preview 9,738 7/3/2023
1.21.14-preview 1,682 7/1/2023
1.21.9 97,043 7/2/2023 1.21.9 is deprecated because it has critical bugs.
1.21.8-preview 1,768 6/30/2023
1.21.7-preview 1,630 6/29/2023
1.21.5-preview 1,465 6/28/2023
1.21.3-preview 1,772 6/25/2023
1.20.8 146,613 5/21/2023 1.20.8 is deprecated because it has critical bugs.
1.20.7-preview 1,756 5/17/2023
1.19.14 163,701 4/26/2023 1.19.14 is deprecated because it has critical bugs.
1.18.4 633,823 2/26/2023
1.17.2 30,615 2/22/2023
1.16.2 120,707 2/7/2023
1.15.5 31,386 2/4/2023
1.14.4 137,266 1/11/2023
1.13.5 121,824 12/16/2022
1.12.6 293,733 11/8/2022
1.12.4-preview 2,239 10/26/2022
1.11.7 97,509 10/13/2022
1.10.14 116,100 9/16/2022
1.10.13-preview 1,784 9/16/2022
1.9.8 410,517 6/7/2022
1.9.7-preview 3,471 5/26/2022
1.9.1-preview 2,273 5/21/2022
1.8.15 64,672 5/19/2022
1.7.7 70,933 4/29/2022
1.6.4 361,178 2/22/2022
1.5.12 30,836 2/15/2022
1.4.15 209,605 12/18/2021
1.3.42 162,060 11/9/2021
1.3.38-preview 1,888 11/9/2021
1.3.35-preview 19,487 10/20/2021
1.3.30-preview 3,349 10/15/2021
1.2.49 185,693 8/9/2021
1.2.49-preview 2,242 8/7/2021
1.2.36-preview 6,644 6/25/2021
1.2.35-preview 1,757 6/24/2021
1.2.28-preview 3,626 5/26/2021
1.2.27-preview 1,921 5/22/2021
1.2.26-preview.gd07edb4207 470 5/21/2021
1.1.5 261,341 4/30/2021
1.0.19 35,447 4/11/2021
1.0.16 9,099 4/11/2021
1.0.0-preview-02 3,971 3/26/2021
1.0.0-preview-01 60,503 12/24/2020
1.0.0-beta-11 40,704 10/26/2020
1.0.0-beta-10 34,469 9/15/2020

Changes in bUnit 2.0.55-preview

This major release focuses on platform updates and API simplifications.

For a migration guide, see [Upgrading bUnit](https://bunit.dev/docs/migrations/index.html).

### Changed

- Target framework support updated: added support for .NET 10 (`net10.0`) and dropped all versions prior to .NET 8 (`net8.0`).
- Cleanup of the API with simplifications of many API calls and methods. This also includes renaming of some objects to better reflect their purpose.

### Added

- Improved renderer logic that catches more edge cases.
- Improved developer experience in relation to JSInterop.

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