Edit

SDK 1.0.3712-prerelease, for Runtime 144 (Dec. 8, 2025)

Release notes for Microsoft Edge WebView2 Prerelease SDK, release date: Dec. 8, 2025.

NuGet package for WebView2 SDK 1.0.3712-prerelease

For full API compatibility, this Prerelease version of the WebView2 SDK requires the WebView2 Runtime that ships with Microsoft Edge version 144.0.3712.0 or later; see Runtime 144.0.3719.77 (Jan. 27, 2026).

Detailed contents:

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.

Customize port range behavior

The Allowed Port Range APIs enable restricting or customizing the network port ranges that WebView2 can use for various transport protocols and scopes. This provides enhanced security control.

  • Use SetAllowedPortRange on the CoreWebView2EnvironmentOptions (or ICoreWebView2ExperimentalEnvironmentOptions) instance to configure port restrictions during environment creation.

    • Use the scope parameter to specify whether the configuration applies to all components (Default) or only to WebRTC peer-to-peer connections (WebRtc). Currently only WebRtc is supported.

    • Use the protocol parameter to specify the transport protocol (currently supports Udp).

    • Specify minPort and maxPort values between 1025-65535 (inclusive), or use (0,0) to reset/remove restrictions.

  • Use GetEffectiveAllowedPortRange on the CoreWebView2EnvironmentOptions (or ICoreWebView2ExperimentalEnvironmentOptions) instance to retrieve the active port range configuration for a specific scope and protocol.

    • Returns the explicitly set range for the given scope, or inherits from the Default scope if not set.

    • Returns (0,0) if no restrictions are configured for the specified scope.

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.

Customize the drag and drop behavior (DragStarting API)

The DragStarting API overrides the default drag and drop behavior when running in visual hosting mode. The DragStarting event notifies your app when the user starts a drag operation in the WebView2, and provides the state that's necessary to override the default WebView2 drag operation with your own logic.

  • Use DragStarting on the ICoreWebView2CompositionController5 to add an event handler that's invoked when the drag operation is starting.
  • Use ICoreWebView2DragStartingEventArgs to start your own drag operation.
    • Use the GetDeferral method to execute any async drag logic and call back into the WebView at a later time.
    • Use the Handled property to let the WebView2 know whether to use its own drag logic.

Previous phase: Customize the drag and drop behavior (DragStarting API) in Prerelease SDK 1.0.3079-prerelease, for Runtime 134 (Jan. 24, 2025).

See also

  • Last updated on