Vorabversion des SDK 1.0.3848 – Vorabversion, für Runtime 146 (16. Februar 2026)

Versionshinweise für Microsoft Edge WebView2 Vorabversions-SDK, Veröffentlichungsdatum: 16. Februar 2026.

NuGet-Paket für WebView2 SDK 1.0.3848-prerelease

Für vollständige API-Kompatibilität erfordert diese Vorabversion des WebView2-SDK die WebView2-Runtime, die mit Microsoft Edge Version 146.0.3848.0 oder höher ausgeliefert wird. siehe Runtime 146.0.3856.49 (16. März 2026).

Detaillierter Inhalt:

Wichtige Änderung: Aktivieren von WebView2-spezifischen JavaScript-APIs für Service Worker

Die neue AreWebViewScriptApisEnabledForServiceWorkers Einstellung bietet eine explizite und zuverlässige Möglichkeit, die Verfügbarkeit von WebView2-spezifischen JavaScript-APIs (chrome.webview) in Service Worker-Skripts zu steuern.

Diese Einstellung ist für WebView2-Anwendungen standardmäßig deaktiviert. Apps, die diese Einstellung nicht explizit aktivieren, haben keinen Zugriff auf WebView2-spezifische JavaScript-APIs in Service Worker-Skripts. Daher funktioniert die Service Worker-basierte chrome.webview.postMessage Kommunikation mit der WebView2-Hostanwendung nur, wenn die Einstellung aktiviert ist.

In Zukunft wird sich WebView2 auf die AreWebViewScriptApisEnabledForServiceWorkers Einstellung als autorisierenden Mechanismus zum Aktivieren von WebView2-spezifischen JavaScript-APIs in Service Worker-Skripts stützen. Dies gewährleistet vorhersehbares, sicheres und deterministisches Verhalten.

Sie können das Verhalten Ihrer WebView2-App proaktiv überprüfen, indem Sie die JavaScript-API-Verfügbarmachung für Service Worker in Ihrer WebView2-App aktivieren. Konfigurieren Sie dazu Ihre App so, dass die folgende Einstellung aktiviert wird:

AreWebViewScriptApisEnabledForServiceWorkers = true

Wenn Sie Ihre WebView2-App mit aktivierter Einstellung testen, können Sie alle Workflows identifizieren, die von WebView2-spezifischen Service Worker-APIs abhängen, z. B chrome.webview.postMessage . die Kommunikation zwischen Service Workern und der Hostanwendung.

Derzeit sind die chromechrome.webview und-Objekte für Service Worker-Skripts verfügbar, wenn das Ereignis verwendet ServiceWorkerRegistered wird. Ab der nächsten Version wird die AreWebViewScriptApisEnabledForServiceWorkers Einstellung jedoch der einzige Mechanismus sein, der bestimmt, ob diese Objekte Service Worker-Skripts ausgesetzt werden. Testen Sie diese Einstellung vor der nächsten Version, und melden Sie auftretende Probleme. Weitere Informationen finden Sie unter [Breaking Change] Aktivieren von WebView2-spezifischen JavaScript-APIs für Service Worker.

Siehe auch Steuern Sie unten, ob WebView-Skript-APIs für Service Worker aktiviert sind.

Wichtige Änderung: Lokaler Netzwerkzugriff (LNA) in WebView2

Das Chromium-Browsermodul hat den lokalen Netzwerkzugriff (Local Network Access, LNA) eingeführt. LNA ist eine Sicherheitsfunktion, die verhindert, dass Webseiten Anforderungen an private oder lokale Netzwerkressourcen stellen, es sei denn, die Webseite hat eine explizite Berechtigung für den Zugriff auf die privaten oder lokalen Netzwerkressourcen. Beispiele für solche Ressourcen sind localhost, 192.168.*, oder 10.*.

LNA ist derzeit standardmäßig für WebView2-Apps deaktiviert, aber Sie können die LNA-Unterstützung über das msWebViewAllowLocalNetworkAccessChecks Flag aktivieren. Für WebView2-Apps ist derzeit keine Aktion erforderlich. Informationen zum Flag finden Sie unter Verfügbare WebView2-Browserflags in WebView2-Browserflags.

Nachdem sich die Upstream- und Chromium-Codebasis stabilisiert hat, planen wir, der Enumeration zusätzliche Enumerationswerte hinzuzufügenCoreWebView2PermissionKind, um LNA über die SetPermissionState Methode zu unterstützen. Diese neuen Enumerationswerte werden vom UWP-Ereignis WebView.PermissionRequested verwendet, um Ihrer WebView2-App explizite Kontrolle über das Feature "Lokaler Netzwerkzugriff" (LNA) zu geben.

Sie können das Feature "Lokaler Netzwerkzugriff" (Local Network Access, LNA) in Ihrer WebView2-App proaktiv testen. Um Ihre App mit dem LNA-Feature zu testen, starten Sie Ihre WebView2-App mit dem folgenden Flag:

--enable-features=LocalNetworkAccessChecks,msWebViewAllowLocalNetworkAccessChecks

Indem Sie Ihre App testen, wenn sie mit diesem Flag gestartet wird, können Sie alle Workflows identifizieren, die möglicherweise von der LNA-Funktion betroffen sind.

Nachdem sich das LNA-Feature stabilisiert hat, werden wir eine aktualisierte Zeitleiste für die Aktivierung des LNA-Features veröffentlichen. Weitere Informationen finden Sie unter [Breaking Change] Lokaler Netzwerkzugriff (LNA) in WebView2 – Rolloutplan.

Experimentelle APIs (Phase 1: experimentell in der Vorabversion)

Die folgenden APIs befinden sich in Phase 1: Experimentell in der Vorabversion und wurden in diesem Vorabversions-SDK hinzugefügt.

Steuern, ob WebView-Skript-APIs für Service Worker aktiviert sind

Verwenden Sie die AreWebViewScriptApisEnabledForServiceWorkers Eigenschaft on CoreWebView2Profile , um zu steuern, ob WebView-Skript-APIs für Service Worker aktiviert sind.

Siehe auch Breaking change: Enable WebView2-specific JavaScript APIs for Service Workers, oben.

Siehe auch