bunit.web 1.31.1-preview

Prefix Reserved
This is a prerelease version of bunit.web.
There is a newer version of this package available.
See the version list below for details.
dotnet add package bunit.web --version 1.31.1-preview                
NuGet\Install-Package bunit.web -Version 1.31.1-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.web" Version="1.31.1-preview" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add bunit.web --version 1.31.1-preview                
#r "nuget: bunit.web, 1.31.1-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.
// Install bunit.web as a Cake Addin
#addin nuget:?package=bunit.web&version=1.31.1-preview&prerelease

// Install bunit.web as a Cake Tool
#tool nuget:?package=bunit.web&version=1.31.1-preview&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
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.

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.

Product Compatible and additional computed target framework versions.
.NET net5.0 is compatible.  net5.0-windows was computed.  net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 is compatible.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  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. 
.NET Core netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.1 is compatible. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (9)

Showing the top 5 NuGet packages that depend on bunit.web:

Package Downloads
Verify.Bunit

Extends Verify (https://github.com/VerifyTests/Verify) to allow Blazor component verification via BUnit.

bunit.web.testcomponents

bUnit.web.testcomponents enables writing tests using the <Fixture> and <SnapshotTest> components in .razor files. This package only works with xUnit. NOTE: This package represents experimental features of bUnit that has been superseded by better ones. It is provided to avoid breaking existing test suites but is unlikely to see improvements or updates in the future.

webenology.blazor.components

Blazor Components used at webenology

AntDesign.TestKit

Package Description

CDP4.WEB.Common.Test

A Common Library that includes DevExpress Blazor and Tasks test helpers

GitHub repositories (12)

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

Repository Stars
ant-design-blazor/ant-design-blazor
🌈A rich set of enterprise-class UI components based on Ant Design and Blazor.
radzenhq/radzen-blazor
Radzen Blazor is a set of 90+ free native Blazor UI components packed with DataGrid, Scheduler, Charts and robust theming including Material design and FluentUI.
Blazored/LocalStorage
A library to provide access to local storage in Blazor applications
bitfoundation/bitplatform
Build all of your apps using what you already know and love ❤️
Blazored/Modal
A powerful and customizable modal implementation for Blazor applications.
Version Downloads Last updated
1.36.0 16,988 11/12/2024
1.35.3 243 11/12/2024
1.34.0 21,672 11/1/2024
1.33.3 56,294 10/11/2024
1.33.1-preview 105 10/7/2024
1.32.7 24,246 10/4/2024
1.31.3 164,799 8/16/2024
1.31.1-preview 140 8/14/2024
1.30.3 84,179 7/21/2024
1.29.5 60,223 7/5/2024
1.28.9 353,710 4/19/2024
1.28.4-preview 2,524 3/17/2024
1.28.2-preview 709 3/6/2024
1.27.17 236,149 3/2/2024
1.27.16-preview 592 3/2/2024
1.27.12-preview 1,375 2/23/2024
1.27.11-preview 990 2/19/2024
1.27.5-preview 8,842 1/9/2024
1.27.2-preview 1,380 12/28/2023
1.27.1-preview 1,298 12/28/2023
1.26.64 595,135 12/20/2023
1.26.61-preview.g17cfa782a0 186 12/17/2023
1.26.61-preview 1,228 12/17/2023
1.26.29-preview.ga9c0cd8510 254 12/12/2023
1.26.29-preview.g9431b069b0 124 12/12/2023
1.26.29-preview.g91e9e2287f 169 12/10/2023
1.26.29-preview.g6269f42046 108 12/12/2023
1.26.29-preview.g1595589333 114 12/13/2023
1.26.28-preview.g08ea910651 122 12/10/2023
1.26.27-preview.geb23ca9882 136 12/8/2023
1.26.27-preview.ge5c30f7b82 109 12/8/2023
1.26.26-preview.g3fdaceb6d0 720 11/25/2023
1.26.25-preview.gf8662d54ff 103 11/25/2023
1.26.25-preview.ga796d3d959 102 11/25/2023
1.26.25-preview.g43750dfc46 104 11/25/2023
1.26.25-preview.g028ac0e5cc 100 11/25/2023
1.26.24-preview.ge6af60b555 98 11/24/2023
1.26.23-preview 1,411 11/24/2023
1.26.20-preview 1,161 11/24/2023
1.26.19-preview 1,130 11/24/2023
1.26.18-preview 1,218 11/24/2023
1.26.17-preview 1,099 11/23/2023
1.26.4-preview 2,254 11/20/2023
1.26.1-preview 1,222 11/17/2023
1.25.3 262,715 11/14/2023
1.25.2-preview 1,694 11/13/2023
1.25.1-preview 18,046 10/21/2023
1.25.0-preview 1,467 10/21/2023
1.24.10 151,836 10/14/2023
1.24.9-preview 3,052 10/14/2023
1.24.8-preview 1,446 10/14/2023
1.24.3-preview 1,813 10/6/2023
1.23.9 160,967 9/6/2023
1.23.8-preview 1,765 9/5/2023
1.23.3-preview 2,636 8/23/2023
1.23.1-preview 4,031 7/31/2023
1.22.19 188,056 7/28/2023
1.22.18-preview 2,775 7/23/2023
1.22.16-preview 2,190 7/15/2023
1.22.15-preview 1,795 7/14/2023
1.22.14-preview 1,742 7/13/2023
1.22.13-preview 1,800 7/12/2023
1.22.7-preview 8,756 7/3/2023
1.21.14-preview 1,891 7/1/2023
1.21.9 103,493 7/2/2023 1.21.9 is deprecated because it has critical bugs.
1.21.8-preview 1,931 6/30/2023
1.21.7-preview 1,765 6/29/2023
1.21.5-preview 1,649 6/28/2023
1.21.3-preview 1,916 6/25/2023
1.20.8 187,878 5/21/2023 1.20.8 is deprecated because it has critical bugs.
1.20.7-preview 1,920 5/17/2023
1.19.14 147,893 4/26/2023 1.19.14 is deprecated because it has critical bugs.
1.18.4 577,040 2/26/2023
1.17.2 24,894 2/22/2023
1.16.2 119,296 2/7/2023
1.15.5 37,967 2/4/2023
1.14.4 145,116 1/11/2023
1.13.5 138,416 12/16/2022
1.12.6 310,892 11/8/2022
1.12.4-preview 2,803 10/26/2022
1.11.7 113,632 10/13/2022
1.10.14 109,749 9/16/2022
1.10.13-preview 1,881 9/16/2022
1.9.8 463,280 6/7/2022
1.9.7-preview 3,599 5/26/2022
1.9.1-preview 2,314 5/21/2022
1.8.15 73,402 5/19/2022
1.7.7 84,127 4/29/2022
1.6.4 403,549 2/22/2022
1.5.12 32,310 2/15/2022
1.4.15 236,968 12/18/2021
1.3.42 199,361 11/9/2021
1.3.38-preview 1,961 11/9/2021
1.3.35-preview 22,925 10/20/2021
1.3.30-preview 3,562 10/15/2021
1.2.49 218,489 8/9/2021
1.2.49-preview 2,262 8/7/2021
1.2.36-preview 7,633 6/25/2021
1.2.35-preview 1,803 6/24/2021
1.2.28-preview 10,762 5/26/2021
1.2.27-preview 1,990 5/22/2021
1.2.26-preview.gd07edb4207 242 5/21/2021
1.1.5 297,491 4/30/2021
1.0.19 54,874 4/11/2021
1.0.16 8,037 4/11/2021
1.0.15 791 4/11/2021
1.0.0-preview-02 6,450 3/26/2021
1.0.0-preview-01 118,955 12/24/2020
1.0.0-beta-11 72,718 10/26/2020
1.0.0-beta-10 90,479 9/15/2020

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