Skip to content

[Pre3] Blazor WASM fingerprinting and environment property #35057

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 16 commits into from
Apr 8, 2025
Merged

[Pre3] Blazor WASM fingerprinting and environment property #35057

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
16 commits
Select commit Hold shift + click to select a range
57bde60
[Pre3] Blazor WASM fingerprinting
guardrex Mar 26, 2025
2986615
Add coverage for `<WasmApplicationEnvironmentName>`
guardrex Mar 27, 2025
7ff2e12
Updates
guardrex Mar 27, 2025
54f16d3
Updates
guardrex Mar 27, 2025
88c0a22
Updates
guardrex Mar 27, 2025
b1656b3
Updates
guardrex Mar 27, 2025
9e82848
Updates
guardrex Mar 28, 2025
b7246ad
Updates
guardrex Mar 28, 2025
086c255
Updates
guardrex Mar 28, 2025
7d2fd7f
Updates
guardrex Mar 31, 2025
24ff1d1
Name change: WriteImportMapToHtml to OverrideHtmlAssetPlaceholders
guardrex Apr 2, 2025
e0e8f1f
Oooops! Almost missed the What's New article! 😈
guardrex Apr 2, 2025
f662d7f
Updates
guardrex Apr 2, 2025
7eab3e9
Updates to the What's New content
guardrex Apr 2, 2025
b5aee1c
OverrideHtmlAssetPlaceholders 👉 WriteImportMapToHtml
guardrex Apr 5, 2025
517a64a
Update aspnetcore/release-notes/aspnetcore-10/includes/blazor.md
guardrex Apr 6, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
38 changes: 38 additions & 0 deletions aspnetcore/blazor/fundamentals/static-files.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -193,6 +193,44 @@ For examples of how to address the policy violation with Subresource Integrity (

:::moniker-end

:::moniker range=">= aspnetcore-10.0"

### Fingerprint static assets in standalone Blazor WebAssembly apps

In standalone Blazor WebAssembly apps during build/publish, the framework overrides placeholders in `index.html` with values computed during build to fingerprint static assets. A fingerprint is placed into the `blazor.webassembly.js` script file name, and an import map is generated for other .NET assets.

The following configuration must be present in the `wwwwoot/index.html` file to adopt the fingerprinting feature:

```html
<head>
...
<script type="importmap"></script>
...
</head>

<body>
...
<script src="_framework/blazor.webassembly#[.{fingerprint}].js"></script>
...
</body>

</html>
```

In the project file (`.csproj`), the `<WriteImportMapToHtml>` property is set to `true`:

```xml
<Project Sdk="Microsoft.NET.Sdk.BlazorWebAssembly">
<PropertyGroup>
...
<WriteImportMapToHtml>true</WriteImportMapToHtml>
...
</PropertyGroup>
</Project>
```

:::moniker-end

:::moniker range="< aspnetcore-9.0"

Configure Static File Middleware to serve static assets to clients by calling <xref:Microsoft.AspNetCore.Builder.StaticFileExtensions.UseStaticFiles%2A> in the app's request processing pipeline. For more information, see <xref:fundamentals/static-files>.
Expand Down
35 changes: 35 additions & 0 deletions aspnetcore/release-notes/aspnetcore-10/includes/blazor.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -132,4 +132,39 @@ Also make this change in the *Routing* article at Line 1633.

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

### End-to-end fingerprinting of assets in standalone Blazor WebAssembly apps

In standalone Blazor WebAssembly apps during build/publish, the framework overrides placeholders in `index.html` with values computed during build to fingerprint static assets. A fingerprint is placed into the `blazor.webassembly.js` script file name, and an import map is generated for other .NET assets.

The following changes must be made in the `wwwwoot/index.html` file to adopt the fingerprinting feature. The standalone Blazor WebAssembly project template will be updated to include these changes in an upcoming preview release:

```diff
<head>
...
+ <script type="importmap"></script>
</head>

<body>
...
- <script src="_framework/blazor.webassembly.js"></script>
+ <script src="_framework/blazor.webassembly#[.{fingerprint}].js"></script>
</body>

</html>
```

In the project file (`.csproj`), add the `<WriteImportMapToHtml>` property set to `true`:

```diff
<Project Sdk="Microsoft.NET.Sdk.BlazorWebAssembly">

<PropertyGroup>
<TargetFramework>net10.0</TargetFramework>
<Nullable>enable</Nullable>
<ImplicitUsings>enable</ImplicitUsings>
+ <WriteImportMapToHtml>true</WriteImportMapToHtml>
</PropertyGroup>
</Project>
```

-->