bunit.core 1.31.1-preview
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, 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. |  |
| bUnit.core | Core library that enables rendering a Blazor component in a test context. | |
| bUnit.web | Adds support for testing Blazor components for the web. This includes bUnit.core. |  |
| bUnit.template | Template, which currently creates xUnit-based bUnit test projects only. |  |
| bUnit.generators | Source code generators to minimize code setup in various situations. |  |
| bUnit.web.query | bUnit implementation of testing-library.com's query APIs. |  |
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:
Progress Telerik |
Syncfusion |
Amazon Web Services |
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:
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.
Showing the top 20 packages that depend on bunit.core.
| Packages | Downloads |
|---|---|
|
bunit.web
bUnit.web is a testing library for web/HTML-based Blazor components.
You can easily define components under test in C# or Razor syntax and verify outcome using semantic HTML diffing/comparison logic. You can interact with and inspect the component under test, trigger event handlers, provide cascading values, inject services, mock JavaScript interopt, and perform snapshot testing.
|
16 |
|
bunit.web
bUnit.web is the web specific parts of bUnit, that enables you to easily test and verify the output of Blazor (web) component.
|
15 |
|
bunit.web
bUnit.web is the web specific parts of bUnit, that enables you to easily test and verify the output of Blazor (web) component.
|
16 |
|
bunit.web
bUnit.web is the web specific parts of bUnit, that enables you to easily test and verify the output of Blazor (web) component.
|
17 |
|
bunit.web
bUnit.web is the web specific parts of bUnit, that enables you to easily test and verify the output of Blazor (web) component.
|
18 |
|
bunit.web
bUnit.web is the web specific parts of bUnit, that enables you to easily test and verify the output of Blazor (web) component.
|
22 |
Changes in bUnit 1.31.1-preview
### Fixed
- `UploadFile` should only throw an exception when the file size exceeds the maximum allowed size. Reported by [@candritzky](https://github.com/candritzky). Fixed by [@linkdotnet](https://github.com/linkdotnet).
See the full changelog at https://github.com/bUnit-dev/bUnit/releases
.NET 5.0
- Microsoft.AspNetCore.Components (>= 5.0.17)
- Microsoft.Extensions.Logging.Abstractions (>= 5.0.0)
- Microsoft.Extensions.Logging (>= 5.0.0)
.NET Standard 2.1
- Microsoft.Extensions.Logging.Abstractions (>= 3.1.32)
- Microsoft.Extensions.Logging (>= 3.1.32)
- Microsoft.AspNetCore.Components (>= 3.1.32)
.NET 9.0
- Microsoft.Extensions.Logging.Abstractions (>= 9.0.0-preview.7.24405.7)
- Microsoft.Extensions.Logging (>= 9.0.0-preview.7.24405.7)
- Microsoft.AspNetCore.Components (>= 9.0.0-preview.7.24406.2)
.NET 8.0
- Microsoft.Extensions.Logging.Abstractions (>= 8.0.1)
- Microsoft.Extensions.Logging (>= 8.0.0)
- Microsoft.AspNetCore.Components (>= 8.0.8)
.NET 7.0
- Microsoft.Extensions.Logging (>= 7.0.0)
- Microsoft.AspNetCore.Components (>= 7.0.20)
- Microsoft.Extensions.Logging.Abstractions (>= 7.0.1)
.NET 6.0
- Microsoft.Extensions.Logging.Abstractions (>= 6.0.4)
- Microsoft.Extensions.Logging (>= 6.0.0)
- Microsoft.AspNetCore.Components (>= 6.0.33)
| Version | Downloads | Last updated |
|---|---|---|
| 1.39.5 | 2 | 04/09/2025 |
| 1.38.5 | 4 | 01/30/2025 |
| 1.37.7 | 8 | 01/02/2025 |
| 1.36.0 | 10 | 11/15/2024 |
| 1.35.3 | 9 | 11/15/2024 |
| 1.34.0 | 8 | 11/15/2024 |
| 1.33.3 | 7 | 11/15/2024 |
| 1.33.1-preview | 7 | 11/15/2024 |
| 1.32.7 | 7 | 11/15/2024 |
| 1.31.3 | 9 | 11/15/2024 |
| 1.31.1-preview | 9 | 12/09/2024 |
| 1.30.3 | 8 | 11/15/2024 |
| 1.29.5 | 9 | 11/15/2024 |
| 1.28.9 | 10 | 12/08/2024 |
| 1.28.4-preview | 13 | 11/15/2024 |
| 1.28.2-preview | 8 | 11/15/2024 |
| 1.27.17 | 9 | 11/15/2024 |
| 1.27.16-preview | 8 | 11/15/2024 |
| 1.27.12-preview | 8 | 11/15/2024 |
| 1.27.11-preview | 8 | 11/15/2024 |
| 1.27.5-preview | 8 | 11/15/2024 |
| 1.27.2-preview | 11 | 11/15/2024 |
| 1.27.1-preview | 8 | 11/15/2024 |
| 1.26.64 | 7 | 11/15/2024 |
| 1.26.61-preview.g17cfa782a0 | 15 | 05/26/2024 |
| 1.26.61-preview | 9 | 11/15/2024 |
| 1.26.29-preview.ga9c0cd8510 | 14 | 05/26/2024 |
| 1.26.29-preview.g9431b069b0 | 10 | 05/26/2024 |
| 1.26.29-preview.g91e9e2287f | 15 | 05/26/2024 |
| 1.26.29-preview.g6269f42046 | 8 | 05/26/2024 |
| 1.26.29-preview.g1595589333 | 14 | 05/26/2024 |
| 1.26.28-preview.g08ea910651 | 10 | 05/26/2024 |
| 1.26.27-preview.geb23ca9882 | 12 | 05/26/2024 |
| 1.26.27-preview.ge5c30f7b82 | 12 | 05/26/2024 |
| 1.26.26-preview.g3fdaceb6d0 | 14 | 05/26/2024 |
| 1.26.25-preview.gf8662d54ff | 11 | 05/26/2024 |
| 1.26.25-preview.ga796d3d959 | 15 | 05/26/2024 |
| 1.26.25-preview.g43750dfc46 | 13 | 05/26/2024 |
| 1.26.25-preview.g028ac0e5cc | 13 | 05/26/2024 |
| 1.26.24-preview.ge6af60b555 | 16 | 05/26/2024 |
| 1.26.23-preview | 7 | 11/15/2024 |
| 1.26.20-preview | 10 | 11/15/2024 |
| 1.26.19-preview | 12 | 11/15/2024 |
| 1.26.18-preview | 8 | 11/15/2024 |
| 1.26.17-preview | 4 | 01/02/2025 |
| 1.26.4-preview | 9 | 11/15/2024 |
| 1.26.1-preview | 7 | 11/15/2024 |
| 1.25.3 | 8 | 11/15/2024 |
| 1.25.2-preview | 8 | 11/15/2024 |
| 1.25.1-preview | 9 | 11/15/2024 |
| 1.25.0-preview | 8 | 11/15/2024 |
| 1.24.10 | 9 | 11/15/2024 |
| 1.24.9-preview | 7 | 11/15/2024 |
| 1.24.8-preview | 9 | 11/15/2024 |
| 1.24.3-preview | 8 | 11/15/2024 |
| 1.23.9 | 8 | 11/15/2024 |
| 1.23.8-preview | 7 | 11/15/2024 |
| 1.23.3-preview | 7 | 12/02/2024 |
| 1.23.1-preview | 7 | 11/15/2024 |
| 1.22.19 | 8 | 11/15/2024 |
| 1.22.18-preview | 8 | 12/12/2024 |
| 1.22.16-preview | 9 | 11/15/2024 |
| 1.22.15-preview | 10 | 11/15/2024 |
| 1.22.14-preview | 8 | 11/15/2024 |
| 1.22.13-preview | 8 | 11/15/2024 |
| 1.22.7-preview | 15 | 11/15/2024 |
| 1.21.14-preview | 10 | 11/15/2024 |
| 1.21.9 | 6 | 12/13/2024 |
| 1.21.8-preview | 10 | 11/15/2024 |
| 1.21.7-preview | 7 | 11/15/2024 |
| 1.21.5-preview | 8 | 12/10/2024 |
| 1.21.3-preview | 8 | 11/15/2024 |
| 1.20.8 | 9 | 11/15/2024 |
| 1.20.7-preview | 7 | 11/15/2024 |
| 1.19.14 | 7 | 11/15/2024 |
| 1.18.4 | 15 | 11/15/2024 |
| 1.17.2 | 9 | 11/15/2024 |
| 1.16.2 | 9 | 11/15/2024 |
| 1.15.5 | 11 | 11/16/2024 |
| 1.14.4 | 9 | 11/15/2024 |
| 1.13.5 | 8 | 11/15/2024 |
| 1.12.6 | 8 | 11/15/2024 |
| 1.12.4-preview | 7 | 12/12/2024 |
| 1.11.7 | 8 | 11/15/2024 |
| 1.10.14 | 9 | 11/15/2024 |
| 1.10.13-preview | 8 | 11/15/2024 |
| 1.9.8 | 9 | 11/15/2024 |
| 1.9.7-preview | 9 | 11/15/2024 |
| 1.9.1-preview | 9 | 11/15/2024 |
| 1.8.15 | 10 | 11/15/2024 |
| 1.7.7 | 9 | 11/15/2024 |
| 1.6.4 | 8 | 11/15/2024 |
| 1.5.12 | 8 | 11/15/2024 |
| 1.4.15 | 14 | 11/15/2024 |
| 1.3.42 | 10 | 11/15/2024 |
| 1.3.38-preview | 8 | 11/15/2024 |
| 1.3.35-preview | 8 | 11/15/2024 |
| 1.3.30-preview | 7 | 11/15/2024 |
| 1.2.49 | 6 | 12/10/2024 |
| 1.2.49-preview | 9 | 11/15/2024 |
| 1.2.36-preview | 9 | 11/15/2024 |
| 1.2.35-preview | 9 | 11/15/2024 |
| 1.2.28-preview | 9 | 11/15/2024 |
| 1.2.27-preview | 10 | 11/15/2024 |
| 1.2.26-preview.gd07edb4207 | 11 | 05/26/2024 |
| 1.1.5 | 10 | 11/15/2024 |
| 1.0.19 | 8 | 11/15/2024 |
| 1.0.16 | 9 | 11/15/2024 |
| 1.0.0-preview-02 | 6 | 12/03/2024 |
| 1.0.0-preview-01 | 8 | 11/15/2024 |
| 1.0.0-beta-11 | 8 | 11/15/2024 |
| 1.0.0-beta-10 | 8 | 11/15/2024 |