Blazor is a framework for building modern, interactive web-based UIs with C# and Razor. For more information on using Blazor to build apps, check out the official docs.
This folder contains the component model shared between the WebAssembly and Server hosting models for Blazor.
The following contains a description of each sub-directory in the Components
directory.
Analyzers
: Contains a collection of Rosyln analyzers for Blazor componentsAuthorization
: Contains source files associated with auth-related components and services in BlazorComponents
: Contains the implementation for the Blazor component modelForms
: Contains source files for Form components in BlazorIgnitor
: A library for testing Blazor Server appsSamples
: Contains a collection of sample apps in BlazorServer
: Contains the implementation for Blazor Server-specific componentsShared
: Contains a collection of shared constants and helper methods/classesWeb
: Contains source files for handling DOM events, forms, and other componentsWeb.JS
: Contains the source files for Blazor's client-side JavaScriptWebAssembly
: Contains the implementation for WebAssembly-specific componentsAuthentication.Msal
: Contains the implementation for MSAL (Microsoft Authentication Library) auth in WASM applicationsDevServer
: Contains the implementation for the Blazor dev serverJSInterop
: Contains the implementation for methods that allow invoking JS from .NET codeSdk
: Contains the MSBuild definitions for the Blazor WASM SDKServer
: Contains the implementation for WASM-specific extension methods and the launch logic for the debugging proxyWebAssembly
: Contains WebAssembly-specific implementations of the renderer, HostBuilder, etc.WebAssembly.Authentication
: Contains the WASM-specific implementations
WebView
: Contains the source files to support Blazor Hybrid withindotnet/maui
. Changes in this project can be tested withdotnet/maui
following this guide.
To build this specific project from source, follow the instructions on building the project.
Note: You also need to run the preceding build
command in the command line before building in VS to ensure that the Web.JS dependency is built.
This project contains a collection of unit tests implemented with XUnit and E2E tests implemented using Selenium. In order to run the E2E tests, you will need to have Selenium installed on your machine.
The E2E tests are located in the top-level tests
folder in this directory. The E2E tests consists of a top-level TestServer
which instantiates different app servers for specific scenarios:
- Standalone Blazor WASM
- Hosted Blazor WASM
- Blazor Server
- Blazor Server with pre-rendering
Each app server mounts the same BasicTestApp
application under each scenario.
To run the tests for this project, run the tests on the command line in this directory.
By default, WebAssembly E2E tests that run as part of the CI or when run in Release builds run with trimming enabled. It's possible that tests that successfully run locally might fail as part of the CI run due to errors introduced due to trimming. To test this scenario locally, either run the E2E tests in release build or with the TestTrimmedApps
property set. For e.g.
dotnet test -c Release
or
dotnet build /p:TestTrimmedApps=true
dotnet test --no-build
For more information, see the ASP.NET Core README.