Carubbi.ExtendedWebBrowser 2.0.0

Carubbi.ExtendedWebBrowser

A multi-tab web browser control for web automation running on Microsoft Edge WebView2 (WinForms). This is the modernized v2 line: the legacy .NET Framework 4.7.2 implementation built on the IE WebBrowser control and MSHTML COM (DWebBrowserEvents2, PermissionSet, WndProc sinks) has been migrated to WebView2 (Microsoft.Web.WebView2). Navigation is now asynchronous and pop-up handling is driven through CoreWebView2.NewWindowRequested instead of COM event sinks.

Requirements

• .NET 10
• Windows 10/11 with the WebView2 Runtime installed

Projects / packages

Usage

Host a tabbed browser on a TabControl:

using Carubbi.ExtendedWebBrowser;

var manager = new WebView2WindowManager(tabControl);
var tab = manager.New("Home");
tab.Navigate("https://example.com");
manager.Open(new Uri("https://example.com/docs"));
manager.ChangeActiveBrowser(0);
manager.Close(manager.LastTabIndex);

Use a single tab directly:

using Carubbi.ExtendedWebBrowser;
using Carubbi.ExtendedWebBrowser.Interfaces;

var browser = new BrowserControl("main")
{
    FilterLevel = PopupBlockerFilterLevel.Medium
};
browser.StartNewWindow += (_, e) =>
{
    // e.Url, e.NavigationContext; set e.Cancel = true to block.
};
panel.Controls.Add(browser);
browser.Navigate("https://example.com");

React to toolbar state:

manager.CommandStateChanged += (_, e) =>
{
    backButton.Enabled = e.BrowserCommands.HasFlag(BrowserCommands.Back);
    forwardButton.Enabled = e.BrowserCommands.HasFlag(BrowserCommands.Forward);
};

Breaking change from v1: ExtendedWebBrowser (IE WebBrowser subclass), UnsafeNativeMethods, BrowserControlWindowManager and ExtendedWebBrowserWindowManager were removed. Use BrowserControl (IBrowserTab) and WebView2WindowManager (IWindowManager) instead. New(navigateHome: true, ...) now navigates to about:blank instead of the IE home page.

Building and testing locally

dotnet build Carubbi.ExtendedWebBrowser.slnx -c Release
dotnet run --project tests/Carubbi.ExtendedWebBrowser.Tests -c Release --no-build

Releasing

Push a v* tag (or run the publish workflow manually) to build, pack both library packages (Carubbi.ExtendedWebBrowser, Carubbi.ExtendedWebBrowser.Interfaces) and push them to nuget.org via trusted publishing:

git tag v2.0.0
git push origin master v2.0.0