[Deprecation] Microsoft.Web.WebView2.DevToolsProtocolExtension NuGet package

[ojasvi1450]

[Deprecation] Microsoft.Web.WebView2.DevToolsProtocolExtension NuGet package

Microsoft.Web.WebView2.DevToolsProtocolExtension NuGet package – deprecation of the strongly-typed CDP wrapper for WebView2

Summary

The Microsoft.Web.WebView2.DevToolsProtocolExtension NuGet package is being deprecated. No further versions of this package will be published. The existing published versions (1.0.824, 1.0.2271, and 1.0.2901) remain available on NuGet Gallery and are not being removed.

All Chrome DevTools Protocol (CDP) calls can be made directly via the built-in WebView2 CDP APIs on CoreWebView2, without using the extension package.

Details

Scope: WebView2

Purpose: The Microsoft.Web.WebView2.DevToolsProtocolExtension package provided a strongly-typed .NET wrapper over the Chrome DevTools Protocol (CDP) for use in WebView2 apps. With the built-in CoreWebView2 CDP APIs (CallDevToolsProtocolMethodAsync, CallDevToolsProtocolMethodForSessionAsync, and GetDevToolsProtocolEventReceiver) now covering the same scenarios, the wrapper package is no longer being maintained.

Behavior

Previously, WebView2 dotnet apps could optionally take a dependency on Microsoft.Web.WebView2.DevToolsProtocolExtension to call CDP methods through a strongly-typed wrapper. Going forward, apps should call CDP directly using the built-in CoreWebView2 APIs.

Aspect	Previously	Going forward
CDP access in WebView2 dotnet apps	Optional strongly-typed wrapper via Microsoft.Web.WebView2.DevToolsProtocolExtension.	Call CDP directly using CoreWebView2.CallDevToolsProtocolMethodAsync / CallDevToolsProtocolMethodForSessionAsync.
Existing package versions (1.0.824, 1.0.2271, 1.0.2901)	Available on NuGet Gallery.	Remain available on NuGet Gallery — they are not being removed.
New versions of the extension package	Periodically published.	No new versions will be published.

Impact

Apps that currently depend on Microsoft.Web.WebView2.DevToolsProtocolExtension will need to migrate to the built-in WebView2 CDP APIs. The package is deprecated but not removed.

• NuGet: Microsoft.Web.WebView2.DevToolsProtocolExtension (deprecated) → built-in CoreWebView2 CDP APIs (recommended)
• .NET / WinRT: Strongly-typed wrapper methods from the extension package → CoreWebView2.CallDevToolsProtocolMethodAsync(String, String) / CoreWebView2.CallDevToolsProtocolMethodForSessionAsync(String, String, String)
• Events: Wrapper event subscriptions → CoreWebView2.GetDevToolsProtocolEventReceiver(String)

Existing apps pinned to a published version (1.0.824, 1.0.2271, 1.0.2901) will continue to build and run, but will not receive updates, bug fixes, or support for newer CDP domains and commands. As CDP evolves in Chromium, the deprecated package will increasingly fall behind.

Rollout

The Microsoft.Web.WebView2.DevToolsProtocolExtension package is marked deprecated on NuGet Gallery. Existing versions (1.0.824, 1.0.2271, 1.0.2901) remain available and are not being removed. No future versions are planned.

Testing

Migrate your code from the extension wrapper to the built-in CoreWebView2 CDP APIs and validate that:

1. Strongly-typed wrapper calls from DevToolsProtocolExtension are replaced with equivalent CoreWebView2.CallDevToolsProtocolMethodAsync / CallDevToolsProtocolMethodForSessionAsync invocations.
2. CDP method names, parameters, and JSON response handling match the [Chrome DevTools Protocol viewer](Chrome DevTools Protocol).
3. Event subscriptions are migrated to CoreWebView2.GetDevToolsProtocolEventReceiver.
4. End-to-end scenarios that previously relied on the wrapper continue to function after migration.

Known Changes

• Microsoft.Web.WebView2.DevToolsProtocolExtension NuGet package is deprecated.
• No new versions of the package will be published.
• Existing versions (1.0.824, 1.0.2271, 1.0.2901) remain on NuGet Gallery.
• No change to the built-in CoreWebView2 CDP APIs.

App Action

Replace all usage of Microsoft.Web.WebView2.DevToolsProtocolExtension with the built-in WebView2 CDP APIs on CoreWebView2. See:

• Use the Chrome DevTools Protocol (CDP) in WebView2 apps
• CoreWebView2.CallDevToolsProtocolMethodAsync(String, String) Method
• CoreWebView2.CallDevToolsProtocolMethodForSessionAsync Method

Timeline

• Deprecation: Packages are officially deprecated.
• Removal: None planned — existing package versions remain available on NuGet Gallery.
• Testing Deadline: Apps are encouraged to complete their migration at their convenience; no hard deadline.
• Contact: For questions or concerns, please use the WebView2Feedback repo.