Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Release notes for Microsoft Edge WebView2 Prerelease SDK, release date: May 11, 2026.
NuGet package for WebView2 SDK 1.0.4015-prerelease
For full API compatibility, this Prerelease version of the WebView2 SDK requires the WebView2 Runtime that ships with Microsoft Edge version 149.0.4015.0 or later; see Runtime 149.0.4022.49 (Jun. 11, 2026).
Breaking change: EnhancedSecurityModeLevel replaced by EnhancedSecurityModeState
The CoreWebView2Profile.EnhancedSecurityModeLevel property and the CoreWebView2EnhancedSecurityModeLevel enum are deprecated and will be removed in a future release. Replace all usage of these APIs in your WebView2 application, as follows.
The old property, CoreWebView2Profile.EnhancedSecurityModeLevel, controlled whether Enhanced Security Mode (ESM) is enabled or disabled for all WebView2 instances associated with a profile. This property has been renamed to EnhancedSecurityModeState, to more clearly communicate the state of Enhanced Security Mode.
Before this change: The CoreWebView2Profile.EnhancedSecurityModeLevel property used the CoreWebView2EnhancedSecurityModeLevel enum with values Off and Strict.
After this change: The CoreWebView2Profile.EnhancedSecurityModeState property uses the CoreWebView2EnhancedSecurityModeState enum with values Disabled and Enabled:
CoreWebView2EnhancedSecurityModeState.Disabled— Enhanced Security Mode is disabled.- Replaces
CoreWebView2EnhancedSecurityModeLevel.Off.
- Replaces
CoreWebView2EnhancedSecurityModeState.Enabled— Enhanced Security Mode is enabled.- Disables JavaScript Just-in-Time (JIT) compilation.
- Enables additional operating system protections.
- Replaces
CoreWebView2EnhancedSecurityModeLevel.Strict.
See also:
- Enhanced security mode state, below.
- [Breaking Change]
EnhancedSecurityModeLevelreplaced byEnhancedSecurityModeState(Issue #132)
Experimental APIs (Phase 1: Experimental in Prerelease)
The following APIs are in Phase 1: Experimental in Prerelease, and have been added in this Prerelease SDK.
Enhanced security mode state
The EnhancedSecurityModeState property on CoreWebView2Profile controls whether Enhanced Security Mode (ESM) is enabled or disabled for all WebView2 instances that are associated with a profile.
When enabled, Enhanced Security Mode disables JavaScript Just-in-Time (JIT) compilation and enables additional operating system protections, reducing the attack surface, at the cost of some JavaScript performance.
The default value is Disabled. Changes apply immediately to new navigations; existing pages require a reload.
This setting does not persist, and resets when the profile is destroyed and recreated.
CoreWebView2EnhancedSecurityModeState Enum
DisabledEnabled
CoreWebView2ProfileClass
Promotions to Phase 2 (Stable in Prerelease)
The following APIs have been promoted from Phase 1: Experimental in Prerelease, to Phase 2: Stable in Prerelease, and are included in this Prerelease SDK.
Enable background processing and offline support (WebView2 Worker APIs)
The WebView2 Worker APIs allow host applications to interact with Web Workers to offload tasks from the main thread, improve responsiveness, and support background operations. These Web Workers include Dedicated Workers, Shared Workers, and Service Workers.
These APIs provide:
- Lifecycle Events: Monitor creation and destruction of workers.
- Messaging Interfaces: Communicate with workers using
PostMessageandWebMessageReceived; specifically:CoreWebView2ServiceWorker.PostWebMessageAsJsonCoreWebView2ServiceWorker.PostWebMessageAsStringCoreWebView2DedicatedWorker.PostWebMessageAsJsonCoreWebView2DedicatedWorker.PostWebMessageAsStringCoreWebView2ServiceWorker.WebMessageReceivedCoreWebView2DedicatedWorker.WebMessageReceivedchrome.webview.postMessage- Not:
chrome.webview.postMessageWithAdditionalObjects
- Worker Management: Query and retrieve worker registrations and instances.
Previous phase: Enable background processing and offline support (WebView2 Worker APIs) in Prerelease SDK 1.0.3415-prerelease, for Runtime 140 (Jul. 14, 2025).
CoreWebView2Class:
- CoreWebView2DedicatedWorker Class
- CoreWebView2DedicatedWorker.DedicatedWorkerCreated Event
- CoreWebView2DedicatedWorker.Destroying Event
- CoreWebView2DedicatedWorker.PostWebMessageAsJson Method
- CoreWebView2DedicatedWorker.PostWebMessageAsString Method
- CoreWebView2DedicatedWorker.ScriptUri Property
- CoreWebView2DedicatedWorker.WebMessageReceived Event
CoreWebView2FrameClass:
CoreWebView2ProfileClass:
- CoreWebView2ServiceWorkerRegistration Class
- CoreWebView2ServiceWorkerRegistration.ActiveServiceWorker Property
- CoreWebView2ServiceWorkerRegistration.Origin Property
- CoreWebView2ServiceWorkerRegistration.ScopeUri Property
- CoreWebView2ServiceWorkerRegistration.ServiceWorkerActivated Event
- CoreWebView2ServiceWorkerRegistration.TopLevelOrigin Property
- CoreWebView2ServiceWorkerRegistration.Unregistering Event