版本发布政策 on DotNetBrowser 文档

DotNetBrowser 4.2.0

Tue, 07 Jul 2026 00:00:00 +0000

macOS 上的 Touch ID

DotNetBrowser 现在支持通过 WebAuthn API 使用 macOS 内置的 Touch ID 平台认证器。 Mac 用户可以直接通过浏览器使用 Touch ID 登录支持 passkey 的网站。

为启用此功能，Chromium bundle ID 已从 org.chromium.Chromium 更改为 com.teamdev.Platinum。由于 macOS 通过 bundle ID 识别应用程序，现在它会将此版本视为与之前构建不同的应用程序。开发者和用户在更新后首次启动时可能会看到 macOS 权限提示 — 摄像头、麦克风、屏幕录制、通知和辅助功能访问权限可能会被重新请求。这是预期的一次性行为；授予权限后即可恢复正常运行。

您可以在迁移指南中了解更多信息。

Chromium 150.0.7871.47

我们将 Chromium 升级到了较新的版本，该版本引入了 433 项安全修复，其中包括：

更多详情请参阅 Chromium 的发布公告。

DotNetBrowser 4.1.1

Wed, 17 Jun 2026 00:00:00 +0000

UrlRequestJob API 改进

为拦截请求新增了异步且支持流式写入的响应写入能力。

在本次发布中，我们为 UrlRequestJob 扩展了异步写入方法，并新增了流扩展方法，以简化大体积响应的处理。

新增 API：

UrlRequestJob.WriteAsync(byte[] data)
UrlRequestJob.WriteAsync(byte[] data, int offset, int count)
UrlRequestJobExtensions.Write(UrlRequestJob job, Stream stream, int bufferSize = 81920)
UrlRequestJobExtensions.WriteAsync(UrlRequestJob job, Stream stream, CancellationToken cancellationToken = default, int bufferSize = 81920)

这些 API 提供了异步拦截流程中的非阻塞响应写入、无需将全部负载加载到内存即可从 Stream 便捷流式写入，以及支持可配置缓冲区大小的分块写入。

写完所有分块后，请调用 Complete() 结束响应。如果无法完成写入，请调用 Fail()。

触控选择手柄

DotNetBrowser 现支持在触控环境中禁用 Chromium 的触控文本选择手柄。当应用程序需要自行管理文本选择 UI，且不希望显示 Chromium 内置触控手柄时，此功能非常有用。

DotNetBrowser 4.1.0

Thu, 28 May 2026 00:00:00 +0000

破坏性变更

`IHttpCache.DiskCacheCleared` 事件已移除

IHttpCache.DiskCacheCleared 已被移除。

IHttpCache.Clear() 会返回一个 Task，该任务会在缓存清理操作完成后结束。请使用返回的任务跟踪完成状态，而不是订阅已移除的事件。

Avalonia 12 支持

通过新的 DotNetBrowser.AvaloniaUi.v12 NuGet 包，新增了对 Avalonia 12 的支持。

该包提供与 Avalonia 12 应用兼容的集成组件，同时通过单独的 DotNetBrowser.AvaloniaUi 包保留对现有 Avalonia 11 集成的支持。

您可以在迁移指南中了解更多信息。

通过 IProfile.ClearAllData() 简化数据清理

现在，您可以使用新的 IProfile.ClearAllData() 方法，通过一次 API 调用在配置文件级别完整清除浏览数据。该方法会移除缓存、Cookie、浏览历史记录以及其他已存储的配置文件数据。

按浏览器缩放

默认情况下，缩放级别变更会应用到同一配置文件中共享相同源的所有浏览器。从 DotNetBrowser 4.1.0 开始，您可以将缩放范围限定到单个浏览器，从而使一个浏览器中的缩放变化不会影响其他浏览器：

DotNetBrowser 4.0.1

Mon, 04 May 2026 00:00:00 +0000

Chromium 147.0.7727.138

我们将 Chromium 升级到了较新的版本，该版本引入了 30 项安全修复，其中包括：

您可以在 Chromium 的博客文章中了解更多信息。

质量改进

修复了在 macOS 26.4.1 上创建 IEngine 时发生的崩溃问题。
修复了在 macOS 上触发屏幕捕获对话框时发生的崩溃问题。
在 WinUI 3 中，组合框下拉列表现在可以正确隐藏。

DotNetBrowser 4.0.0

Tue, 28 Apr 2026 00:00:00 +0000

我们很高兴地宣布 DotNetBrowser 4.0.0 正式发布！

此新主要版本引入了多项新功能和改进，包括对裁剪和 AOT 的支持。

我们没有对 API 进行重大更改，因此您可以轻松地将现有代码迁移到新版本。不过，我们建议您查阅迁移指南，以了解 DotNetBrowser 4.0.0 中的变更和改进详情。

以下是 DotNetBrowser 4.0.0 中新功能和改进的详细介绍。

裁剪和 Native AOT 支持（.NET 8+）

为面向 .NET 8+ 的核心软件包添加了裁剪和 Native AOT 兼容性支持。此功能适用于控制台应用程序和 Avalonia UI 应用程序。

更多信息请参阅此文章。

每个浏览器的渲染模式

此前，渲染模式是针对整个 IEngine 固定的。由该引擎创建的所有浏览器都共享同一种渲染模式，因此无法在离屏浏览器和硬件加速浏览器之间共享同一个配置文件。

在 DotNetBrowser 4.0.0 中，您可以为每个 IBrowser 实例单独指定渲染模式：

IBrowser browser = engine.Profiles.Default.CreateBrowser(RenderingMode.OffScreen);

通过 IEngine.CreateBrowser() 或 IProfile.CreateBrowser() 在不传递参数的情况下创建的浏览器仍然使用引擎的默认渲染模式。弹出浏览器会继承其父浏览器的渲染模式。

更多详情请参阅渲染指南。

新增 JavaScript 类型

在此版本中，我们新增了两种可在 .NET 和 JavaScript 之间自动转换的数据类型：

DotNetBrowser 3.5.1

Thu, 26 Mar 2026 00:00:00 +0000

扩展鼠标事件属性

在 DotNetBrowser 中，MouseExited、MouseEntered 和 MouseMoved 事件中新增了 KeyModifiers 和 MouseButton 属性，用于提供这些事件发生时键盘修饰键和鼠标按钮状态的附加信息。

browser.Mouse.Entered.Handler = new Handler<IMouseEnteredEventArgs, InputEventResponse>(p =>
{
 if (p.Button == MouseButton.Left && p.KeyModifiers.ControlDown)
 {
 return InputEventResponse.Suppress;
 }

 return InputEventResponse.Proceed;
});

.NET JavaScript 对象字符串大小限制

实现了 Chromium 设计上的限制：当从 .NET 向 JavaScript 发送 JavaScript 对象（例如 IJsObject）时，对字符串最大大小的限制。该限制为：在 32 位系统上为 2^28 − 16 字节，在 64 位系统上为 2^29 − 24 字节。

为了防止在超过此限制时 Chromium 进程崩溃，现在会抛出 ArgumentException 异常。

Chromium 146.0.7680.80

我们已将 Chromium 升级到较新的版本，该版本引入了两个高严重级别的安全修复，用于修补在现实环境中已存在已知利用方式的漏洞。

DotNetBrowser 3.5.0

Wed, 18 Feb 2026 00:00:00 +0000

新增了初始化异常

引入了新的异常类，用于覆盖各种引擎初始化失败的场景：

SandboxNotSupportedException - 当由于运行环境不支持在新的用户命名空间中创建进程，导致 Chromium 无法以沙盒模式启动时抛出该异常。
UserDataInUseException - 当另一个 Chromium 实例已经在使用相同的用户数据目录时抛出该异常。
UserDataCreationException - 当由于权限不足或目录路径无效而无法创建用户数据目录时抛出该异常。

所有新增的异常均继承自 EngineInitializationException，这既能确保现有代码继续正常工作，又能支持类型安全的异常处理。

PDF 文档加载的变更

现在您可以通过两个新的事件来跟踪 PDF 文档的加载情况：

PdfDocumentLoaded
PdfDocumentLoadFailed

使用示例：

browser.PdfDocumentLoaded += (sender, args) =>
{
 var url = args.Url;
 var frame = args.Frame;

 // This event is a good place to start PDF printing.
 frame.Print();
};

从 DotNetBrowser 3.5.0 开始，FrameLoadFinished 事件以及 Navigation.LoadUrl() 任务的返回结果不再是等待 PDF 文档加载完成的可靠方式。请改用新的事件。

更多详细信息请参阅

更多详细信息请参阅导航指南。

重大变更

由于 Chromium 已移除以下成员，我们也从 NetError 枚举中删除了它们：

DotNetBrowser 3.4.0

Wed, 21 Jan 2026 00:00:00 +0000

Linux 上的 Sandbox（沙箱）

在 DotNetBrowser 3.4.0 中，Chromium 沙箱现已在 Linux 上启用。这是一个关键的安全特性，之前已经在 Windows 和 macOS 上提供。

需要采取的操作

Chromium 依赖 user namespaces 来对其子进程进行沙箱隔离。当该功能不可用时，DotNetBrowser 无法启动 Chromium，并会在 IEngine 初始化过程中抛出 EngineInitializationException。

在某些 Linux 发行版上，非特权用户可能无法使用该功能。要启用它，请按照我们的沙箱配置指南对操作系统进行相应配置。

在不同存储之间复制密码

现在，你可以使用 IPasswordStore.All 和 IPasswordStore.Add() 在不同的配置文件（profile）之间复制密码记录。

// Copy passwords from one store to another
var sourcePasswordStore = sourceProfile.PasswordStore;
var targetPasswordStore = targetProfile.PasswordStore;

foreach (var passwordRecord in sourcePasswordStore.All)
{
 targetPasswordStore.Add(passwordRecord);
}

破坏性变更（Breaking changes）

移除枚举中的技术值

我们从所有枚举类型中移除了 *Unrecognized 和 *Unspecified 值。这些是仅用于内部的技术性枚举值。对于少量枚举，在被移除的值代表一个逻辑上的枚举状态时，我们新增了 Unknown 值。

DotNetBrowser 3.3.7

Thu, 18 Dec 2025 00:00:00 +0000

.NET 10 支持

DotNetBrowser 已完成测试，并确认可与 .NET 10 桌面应用程序顺利集成。

Chromium 143.0.7499.41

我们已将 Chromium 升级至更新版本，该版本包含 13 项安全修复，其中包括：

更多详细信息可参阅 Chromium 官方的博客文章。

质量改进

修复了在访问特定网页时偶发的崩溃问题。

DotNetBrowser 2.27.20

Wed, 26 Nov 2025 00:00:00 +0000

Chromium 142.0.7444.176

我们已将 Chromium 升级至新版本，该版本包含多项重要安全修复，其中包括：

您可以在 Chromium 博客文章中了解更多信息：

DotNetBrowser 3.3.6

Wed, 26 Nov 2025 00:00:00 +0000

Chromium 142.0.7444.176

我们已将 Chromium 升级至新版本，该版本包含多项重要安全修复，其中包括：

您可以在 Chromium 博客文章中了解更多信息：

质量改进

修复了在 WinUI3 中使用离屏渲染模式时发生的 NullPointerException 异常。
修复了在 macOS 上，VoiceOver 无法读取带有 aria-live 属性元素的问题。

DotNetBrowser 2.27.19

Fri, 07 Nov 2025 00:00:00 +0000

Chromium 142.0.7444.60

我们已将 Chromium 升级至更新版本，该版本包含多项重要安全修复，其中包括：

您可以在 Chromium 博客文章中了解更多相关信息：

DotNetBrowser 3.3.5

Fri, 07 Nov 2025 00:00:00 +0000

Chromium 142.0.7444.60

我们已将 Chromium 升级至更新版本，该版本包含多项重要安全修复，其中包括：

您可以在 Chromium 博客文章中了解更多相关信息：

从 .NET Task 转换为 JavaScript Promise

DotNetBrowser 现在支持将 .NET Task 转换为原生 JavaScript Promise。此功能旨在简化从 JavaScript 端调用异步 .NET 方法的过程。

DotNetBrowser 2.27.18

Fri, 10 Oct 2025 00:00:00 +0000

Chromium 141.0.7390.55

我们已将 Chromium 升级至新版本，其中包含若干重要的安全修复。其中包括：

您可以在以下 Chromium 官方博客文章中了解更多信息：

DotNetBrowser 3.3.4

Fri, 10 Oct 2025 00:00:00 +0000

Chromium 141.0.7390.55

我们已将 Chromium 升级至新版本，其中包含若干重要的安全修复。其中包括：

您可以在以下 Chromium 官方博客文章中了解更多信息：

质量改进

修复了在离屏渲染模式下 WinUI3 自动填充建议的显示问题。
修复了 WinUI3 对话框窗口的行为，使其能够正常工作并正确阻止父窗口交互。
修复了 Avalonia 在离屏渲染模式下出现的对角线调整大小光标错误问题。

DotNetBrowser 2.27.17

Wed, 17 Sep 2025 00:00:00 +0000

Chromium 140.0.7339.133

DotNetBrowser 已升级至 Chromium 140.0.7339.133，此版本包含最新的性能改进与安全补丁。该版本修复的主要安全漏洞包括：

有关此版本 Chromium 的完整修复和改进列表，请参阅官方 Chromium 博客文章。

DotNetBrowser 3.3.3

Wed, 17 Sep 2025 00:00:00 +0000

Chromium 140.0.7339.133

DotNetBrowser 已升级至 Chromium 140.0.7339.133，此版本包含最新的性能改进与安全补丁。该版本修复的主要安全漏洞包括：

有关此版本 Chromium 的完整修复和改进列表，请参阅官方 Chromium 博客文章。

质量改进

增强了客户端证书管理功能，支持在传输证书时附带私钥。
修复了 Linux 环境中使用非默认 DPI 设置时的缩放问题。
更新了 NetError 枚举，使其与 Chromium 的网络错误代码保持更好的一致性。

DotNetBrowser 2.27.16

Thu, 14 Aug 2025 00:00:00 +0000

Chromium 139.0.7258.67

我们已将 Chromium 升级至较新版本，该版本引入了 12 项安全修复，其中包括：

您可以在 Chromium 博客文章中了解更多相关信息。

结束对 macOS 11 的支持

Chromium 139 已不再支持 macOS 11，因此我们也在 DotNetBrowser 2.27.16 中移除了对此版本的支持。最后一个支持 macOS 11 的 DotNetBrowser 版本是 2.27.15。

DotNetBrowser 3.3.2

Thu, 14 Aug 2025 00:00:00 +0000

Chromium 139.0.7258.67

我们已将 Chromium 升级至较新版本，该版本引入了 12 项安全修复，其中包括：

您可以在 Chromium 博客文章中了解更多相关信息。

结束对 macOS 11 的支持

Chromium 139 已不再支持 macOS 11，因此我们也在 DotNetBrowser 3.3.2 中移除了对此版本的支持。最后一个支持 macOS 11 的 DotNetBrowser 版本是 3.3.1。

DotNetBrowser 2.27.15

Wed, 16 Jul 2025 00:00:00 +0000

Chromium 138.0.7204.97

我们已将 Chromium 升级至新版本，并引入了多项重要安全修复，其中包括以下已知漏洞：

您可以在 Chromium 博客文章中了解更多信息：

2025年6月30日。
2025年6月24日。

DotNetBrowser 3.3.1

Wed, 16 Jul 2025 00:00:00 +0000

Chromium 138.0.7204.97

我们已将 Chromium 升级至新版本，并引入了多项重要安全修复，其中包括以下已知漏洞：

您可以在 Chromium 博客文章中了解更多信息：

2025年6月30日。
2025年6月24日。

HTTP 状态代码属性

在此版本中，我们新增了 ResponseCode 属性，用于在导航完成事件中提供 HTTP 状态代码：

browser.Navigation.NavigationFinished += (sender, args) =>
{
 int responceCode = args.ResponseCode;
};

质量改进

现在，在 WinForms、WPF 或 WinUI 3 中使用离屏渲染模式时，缩小光标在 Windows 系统上能正确遵循 DPI 缩放比例。

DotNetBrowser 2.27.14

Fri, 20 Jun 2025 00:00:00 +0000

Chromium 137.0.7151.69

我们已将 Chromium 升级至更新版本，并引入了多项重要安全修复，包括修复了以下已知漏洞：

您可以在 Chromium 博客文章中阅读更多相关信息：

DotNetBrowser 3.3.0

Fri, 20 Jun 2025 00:00:00 +0000

Chromium 137.0.7151.69

我们已将 Chromium 升级至更新版本，并引入了多项重要安全修复，包括修复了以下已知漏洞：

您可以在 Chromium 博客文章中阅读更多相关信息：

DotNetBrowser 2.27.13

Mon, 26 May 2025 00:00:00 +0000

Chromium 136.0.7103.114

我们已将 Chromium 升级至更新版本，该版本引入了多项重要安全修复。其中包括针对一项已知漏洞的修复：

CVE-2025-4664: Insufficient policy enforcement in Loader

其他修复内容包括：

您可以在 Chromium 的博客文章中了解更多信息：

DotNetBrowser 3.2.1

Mon, 26 May 2025 00:00:00 +0000

Chromium 136.0.7103.114

我们已将 Chromium 升级至更新版本，该版本引入了多项重要安全修复。其中包括针对一项已知漏洞的修复：

CVE-2025-4664: Insufficient policy enforcement in Loader

其他修复内容包括：

您可以在 Chromium 的博客文章中了解更多信息：

DotNetBrowser 2.27.12

Wed, 23 Apr 2025 00:00:00 +0000

Chromium 135.0.7049.52

我们已将 Chromium 升级至更新版本，该版本引入了 13 项安全修复，其中包括：

您可以在 Chromium 的博客文章中了解更多详情。

质量改进

修复了 macOS 系统上 Widevine DRM 在 Netflix 等主流流媒体服务中无法正常使用的问题。

DotNetBrowser 3.2.0

Wed, 23 Apr 2025 00:00:00 +0000

Chromium 135.0.7049.52

我们已将 Chromium 升级至更新版本，该版本引入了 13 项安全修复，其中包括：

您可以在 Chromium 的博客文章中了解更多详情。

自定义用户代理客户端提示

现在您可以在创建 IEngine 实例时设置自定义的用户代理客户端提示，这些设置也适用于工作线程。以下代码片段展示了如何进行设置：

EngineOptions engineOptions = new EngineOptions.Builder
{
 UserAgentMetadata = new UserAgentMetadata.Builder
 {
 Platform = "Profile test platform",
 Architecture = "Profile test architecture",
 Bitness = "Profile test bitness",
 Mobile = true,
 Model = "Profile test model",
 Wow64 = true,
 FormFactors = { "Profile factor 1", "Profile factor 2" },
 FullVersion = "Profile test full version",
 PlatformVersion = "Profile test platform version",
 BrandVersionList =
 {
 new UserAgentBrandVersion.Builder { Brand = "Profile test Brand", Version = "Profile test Version" }
 .Build()
 },
 BrandFullVersionList =
 {
 new UserAgentBrandVersion.Builder
 { Brand = "Profile test Full Brand", Version = "Profile test Full Version" }.Build()
 },
 }.Build()
}.Build();

IEngine engine = EngineFactory.Create(engineOptions);

Avalonia 离屏渲染模式下的拖放支持

DotNetBrowser 现在支持在 Avalonia 的离屏渲染模式下实现完整的拖放（Drag & Drop）功能。在 macOS 上，此功能在硬件加速模式下同样可用。

DotNetBrowser 2.27.11

Wed, 26 Mar 2025 00:00:00 +0000

Chromium 134.0.6998.89

我们已将 Chromium 升级至更新版本，该版本引入了 23 项安全修复，其中包括：

如需自上次 Chromium 升级以来 Chromium 修复和改进的完整列表，请访问以下版本的产品博客文章：

DotNetBrowser 3.1.2

Wed, 26 Mar 2025 00:00:00 +0000

Chromium 134.0.6998.89

我们已将 Chromium 升级至更新版本，该版本引入了 23 项安全修复，其中包括：

如需自上次 Chromium 升级以来 Chromium 修复和改进的完整列表，请访问以下版本的产品博客文章：

质量优化

自定义光标在 Windows 的离屏渲染模式下现在能正确适应 DPI 缩放比例。
在 Windows 上支持 WebGPU，以提升图形性能。
在 macOS 上选择屏幕共享源时，现在可正常工作。

DotNetBrowser 2.27.10

Mon, 03 Mar 2025 00:00:00 +0000

Chromium 133.0.6943.99

我们已将 Chromium 升级至更新版本，该版本引入了 21 项安全修复，其中包括：

如需自上次 Chromium 升级以来 Chromium 修复和改进的完整列表，请访问以下版本的产品博客文章：

质量优化

修复了 32 位 Windows 系统上的本地输入键码
修复了 DockPanel 中 BrowserView 的尺寸行为

DotNetBrowser 3.1.1

Mon, 03 Mar 2025 00:00:00 +0000

Chromium 133.0.6943.99

我们已将 Chromium 升级至更新版本，该版本引入了 21 项安全修复，其中包括：

如需自上次 Chromium 升级以来 Chromium 修复和改进的完整列表，请访问以下版本的产品博客文章：

质量优化

改进了客户端提示行为
修复了 32 位 Windows 系统上的本地输入键码
修复了 DockPanel 中 BrowserView 的尺寸行为

DotNetBrowser 2.27.9

Mon, 17 Feb 2025 00:00:00 +0000

质量优化

在离屏渲染模式下，自动填充建议在选中后现在能被正确接受。
WPF 的 BrowserView 现在在离屏渲染模式下能够正确地遵循父容器的大小。
在 WPF 离屏模式下，按下 Shift+Tab 后，键盘焦点现在会离开 BrowserView。

DotNetBrowser 3.1.0

Mon, 17 Feb 2025 00:00:00 +0000

自定义用户代理客户端提示

传统上，User-Agent 字符串用于获取用户浏览器或设备的信息。然而，User-Agent Client Hints（用户代理客户端提示）提供了一种更注重隐私的方式，允许浏览器限制默认情况下暴露的信息量。例如，在 Chromium 中，User-Agent 字符串现在仅提供基本信息，而更具体的数据则可通过 User-Agent Client Hints API(用户代理客户端提示 API)访问。

此版本的 DotNetBrowser 引入了覆盖通过 User-Agent Client Hints API 返回的信息的功能，使您可以完全控制与网站共享哪些数据。

以下是如何以编程方式配置自定义用户代理客户端提示的示例：

UserAgentMetadata userAgentMetadata = new UserAgentMetadata.Builder
{
 Platform = "Windows",
 FullVersion = "140.0.7339.81",
 PlatformVersion = "10.0.0",
 BrandVersionList =
 {
 new UserAgentBrandVersion.Builder
 { Brand = "Chromium", Version = "140" }.Build()
 },
 BrandFullVersionList =
 {
 new UserAgentBrandVersion.Builder
 { Brand = "Chromium", Version = "140.0.7339.81" }.Build()
 },
}.Build();

browser.UserAgentMetadata = userAgentMetadata;

扩展程序的上下文菜单项

Chrome 扩展程序可以向上下文菜单添加菜单项。我们扩展了 ShowContextMenuHandler，以便在 Chromium 尝试显示上下文菜单时提供对这些菜单项的访问：

browser.ShowContextMenuHandler =
 new Handler<ShowContextMenuParameters, ShowContextMenuResponse>(p =>
 {
 var extensionMenuItems = p.ExtensionMenuItems;
 return ShowContextMenuResponse.Select(extensionMenuItems.First());
 });

质量优化

在离屏渲染模式下，自动填充建议在选中后现在能被正确接受。
WPF 的 BrowserView 现在在离屏渲染模式下能够正确地遵循父容器的大小。
在 WinUI 3 离屏渲染模式下，移动应用窗口后，组合框下拉菜单现在能够正常打开和关闭。
在 WPF 离屏模式下，按下 Shift+Tab 后，键盘焦点现在会离开 BrowserView。

DotNetBrowser 2.27.8

Fri, 24 Jan 2025 00:00:00 +0000

Chromium 132.0.6834.84

我们已将 Chromium 升级至新版本，该版本引入了 16 项安全修复，其中包括：

如需自上次 Chromium 升级以来 Chromium 修复和改进的完整列表，请访问以下版本的产品博客文章：

质量优化

修复了 Windows 和 Linux 上 Widevine 功能损坏的问题。

DotNetBrowser 3.0.1

Fri, 24 Jan 2025 00:00:00 +0000

Chromium 132.0.6834.84

我们已将 Chromium 升级至新版本，该版本引入了 16 项安全修复，其中包括：

如需自上次 Chromium 升级以来 Chromium 修复和改进的完整列表，请访问以下版本的产品博客文章：

密码、信用卡、用户数据配置文件

现在，您可以通过编程方式将密码、信用卡和用户数据配置文件添加到相应的存储中。在以前的版本中，只有当浏览器提示用户保存数据时，才能通过用户与浏览器的交互将这些数据添加到存储中。

以下代码演示了如何以编程方式将密码添加到密码存储中：

PasswordRecord passwordRecord = new PasswordRecord.Builder
 {
 Url = "https://company.com",
 Login = "login",
 Password = "password"
 }.Build();
IPasswordStore passwords = engine.Profiles.Default.PasswordStore;
passwords.Add(passwordRecord);

质量优化

重新设计了 WinUI 3 中默认对话框的实现，使其能够在硬件加速渲染模式下正常工作。
修复了 Windows 和 Linux 上 Widevine 功能损坏的问题。

DotNetBrowser 2.27.7

Thu, 05 Dec 2024 00:00:00 +0000

Chromium 131.0.6778.70

我们已将 Chromium 升级至更新版本，该版本引入了 12 项安全修复，其中包括：

如需自上次 Chromium 升级以来 Chromium 修复和改进的完整列表，请访问以下版本的产品博客文章：

质量优化

在所有 UI 框架中，工具提示现在能够在硬件加速渲染模式下正常显示。

DotNetBrowser 3.0.0

Tue, 03 Dec 2024 00:00:00 +0000

我们很高兴地宣布，DotNetBrowser 3.0.0 版本正式发布啦！

此新版本引入了多项新功能和改进，包括 WinUI 3 支持、Chrome 扩展程序、自定义 DOM 事件等。DotNetBrowser 现在要求使用 .NET Framework 4.6.2 或更高版本。

我们没有对 API 进行重大更改，因此您可以轻松地将现有代码迁移到新版本。不过，我们建议您查看迁移指南，以了解 DotNetBrowser 3.0.0 中的更改和改进。

有关 DotNetBrowser 3.0.0 中的新功能和改进的更多信息，请参阅下文。

Chrome 扩展程序

DotNetBrowser 现在提供了 Extensions API，允许您安装、更新、卸载并与 Chrome 扩展进行交互。这为将 Chrome 扩展程序集成到您的应用程序中开辟了广泛的可能性。

通过 Extensions API，您可以：

获取已安装扩展程序的列表；
从 Chrome 应用商店手动安装 Chrome 扩展程序；
控制哪些扩展程序可以由用户手动安装；
程序化地从 CRX 文件安装 Chrome 扩展程序；
程序化地卸载从 Chrome 应用商店或 CRX 文件安装的扩展程序；
控制哪些扩展程序可以由用户手动卸载；
在扩展程序安装、更新或卸载时获取通知；
显示扩展程序弹出窗口；
模拟扩展程序图标点击等更多操作。

WinUI 3

我们新增了对另一种 UI 工具包 —— WinUI 3 的支持。现在，您可以将 BrowserView 嵌入到 WinUI 3 应用程序中，并使用现代 UI 工具包构建现代桌面应用程序。

DotNetBrowser 2.27.6

Tue, 12 Nov 2024 00:00:00 +0000

Chromium 130.0.6723.70

我们已将 Chromium 升级至更新版本，新增了多项安全修复，以防止远程攻击者通过特制的 HTML 页面可能利用堆内存损坏漏洞进行攻击，其中包括：

如需自上次 Chromium 升级以来 Chromium 修复和改进的完整列表，请访问以下版本的产品博客文章：

质量优化

在 Windows 上，基于 Avalonia 11.1.x 的应用程序关闭时挂起的问题已不再复现。
在 WPF 应用程序中，当点击硬件加速的 BrowserView 外部时，键盘焦点现在能够正确切换。
当 DotNetBrowser 中禁用自动填充时，WebAuthn 自动填充建议不再显示。

DotNetBrowser 2.27.5

Wed, 02 Oct 2024 00:00:00 +0000

Chromium 129.0.6668.59

我们已将 Chromium 升级至更新版本，新增了多项安全修复，以防止远程攻击者通过特制的 HTML 页面可能利用堆内存损坏漏洞进行攻击，其中包括：

有关 DotNetBrowser 2.27.5 中 Chromium 修复和改进的完整列表，请访问以下版本的产品博客文章：

macOS Catalina

Chromium 129 更改了 macOS 的最低系统要求，DotNetBrowser 也做出了相应调整。从此版本开始，最低要求的 macOS 版本为 macOS Big Sur。

DotNetBrowser 2.27.4

Fri, 13 Sep 2024 00:00:00 +0000

Chromium 已升级至 128.0.6613.85

我们已将 Chromium 升级至更新版本，该版本中引入了多个安全修复，以防止远程攻击者通过精心设计的 HTML 页面利用堆损坏进行攻击，这些修复包括：

要查看 DotNetBrowser 2.27.4 版本中 Chromium 的完整修复和改进列表，请访问以下版本的产品博客文章：

质量优化

IEngine 接口新增了 Theme 属性，该属性允许为 Chromium 引擎设置浅色或深色模式。此属性会影响打印预览和 DevTools 使用的主题。
现在在离屏渲染模式下，键盘修饰符在 WinForms 中可以正确处理。
PermissionType 枚举现在包含所有支持的值。

DotNetBrowser 3.0.0 EAP

Tue, 20 Aug 2024 00:00:00 +0000

此页面包含了按逆时间顺序排列的 DotNetBrowser 3.0.0 EAP 构建版本的完整发布历史记录。

要将最新的 DotNetBrowser 3.0.0 EAP 构建依赖项作为 NuGet 包添加到您的项目中，请按照以下说明操作。

要了解此主要版本计划中的更多增强功能，请访问 DotNetBrowser 发展规划。

v3.0.0-eap.2

Chrome 扩展程序

DotNetBrowser 现在提供了 Extensions API，允许您安装、更新、卸载和管理 Chrome 扩展程序。这为将 Chrome 扩展程序集成到您的应用程序中提供了广泛的可能性。

通过 Extensions API，您可以：

获取已安装扩展程序的列表；
手动从 Chrome 应用商店安装 Chrome 扩展程序；
控制用户可以手动安装哪些扩展程序；
通过 CRX 文件编程方式安装 Chrome 扩展程序；
通过编程方式卸载从 Chrome 应用商店或 CRX 文件安装的扩展程序；
控制用户可以手动卸载哪些扩展程序；
在扩展程序安装、更新或卸载时获取通知；
显示扩展程序的弹出窗口；
模拟扩展程序图标点击等操作。

您可以在扩展程序指南中了解更多关于如何使用 Chrome 扩展程序的内容。

DotNetBrowser 2.27.3

Mon, 05 Aug 2024 00:00:00 +0000

Chromium 已升级至版本 127.0.6533.73

我们将 Chromium 升级到了新版本，引入了多个安全修复程序，可防止远程攻击者通过精心设计的 HTML 页面执行任意代码，其中包括：

有关 DotNetBrowser 2.27.3 中 Chromium 修复和改进的完整列表，请访问以下版本的产品博客文章：

原生键盘输入

在屏幕外渲染模式下，用户按下的任何键在到达网页之前都要经过漫长的传递过程。操作系统将键盘事件分发给 UI Frame，UI Frame 再将其传递给 DotNetBrowser，DotNetBrowser 又将其转发给 Chromium，最后由 Chromium 将事件传递给网页。

DotNetBrowser 2.27.2

Fri, 21 Jun 2024 00:00:00 +0000

Chromium 已升级至版本 126.0.6478.57

我们将 Chromium 升级到了新版本，引入了多个安全修复程序，可防止远程攻击者通过精心设计的 HTML 页面潜在地利用堆损坏，其中包括：

有关 Chromium 修复和改进的完整列表，请访问以下版本的产品博客文章：

质量优化

改进了嵌入本地窗口的 WPF BrowserView 的焦点行为。
在调用 SaveUserDataProfile 请求后，Chromium 崩溃的问题不再出现。
现在 OpenMultipleFilesHandler 能够正确触发 window.showOpenFilePicker JavaScript 函数，用于选择多个文件。

DotNetBrowser 2.27.1

Thu, 30 May 2024 00:00:00 +0000

Chromium 已升级至 125.0.6422.113

我们已将 Chromium 升级至新版本,该版本引入了多项安全修复。其中包括一个针对 已知被利用 漏洞的安全修复：

CVE-2024-5274: Type Confusion in V8

如需了解 125.0.6422.113 版本中 Chromium 的所有修复和改进的完整列表，请访问以下版本的产品博客文章：

质量优化

已更新 Windows 平台上的 DotNetBrowser DLLs 和 Chromium 二进制文件的代码签名证书。
改进了 IBrowser.DisposeAsync() 的实现，以避免未定义的行为。

DotNetBrowser 2.27.0

Wed, 22 May 2024 00:00:00 +0000

Chromium 已升级至 124.0.6367.221 版本

我们已将 Chromium 升级至新版本，该版本引入了针对已知被利用漏洞的安全修复：

如需了解 124.0.6367.221 版本中 Chromium 的所有修复和改进的完整列表，请访问以下版本的产品博客文章：

重大变更

在此版本中，我们移除了 Scaling.FitToPage 和 Scaling.FitToPaper 字段。这两个方法仅在使用系统打印机打印 PDF 文件时有用。当打印 HTML 页面或使用内置 PDF 打印机时，这些方法实际上是空操作（no-op），会让开发者感到困惑。

DotNetBrowser 2.26.2

Wed, 24 Apr 2024 00:00:00 +0000

Chromium 已升级至 123.0.6312.124 版本

我们已将 Chromium 升级至新版本，该版本引入了多项安全修复，可防止远程攻击者通过破坏 GPU 进程，并利用特定 UI 手势进行沙盒逃逸，或通过精心设计的 HTML 页面利用堆损坏漏洞进行潜在攻击，具体包括：

有关 123.0.6312.124 版本的 Chromium 完整修复和改进列表，请访问以下版本的产品博客文章：

质量优化

在 macOS 上进入全屏窗口模式时，现在打印预览能够正确显示在 BrowserView 中。
在离屏渲染模式下，Avalonia 中的 IME 候选窗口在单击 BrowserView 时关闭。
在离屏渲染模式下，当在 Windows 上将 BrowserView 与辅助功能工具结合使用时，Chromium 引擎将不再崩溃。
当 Avalonia BrowserView 尚未添加到可视树中时，不再从中抛出 ArgumentException。
IEngine.Disposed 事件不再触发两次。
在离屏渲染模式下，当 Linux 上的 Avalonia 应用程序窗口最小化时，组合框下拉列表现在会正确关闭。

DotNetBrowser 2.26.1

Thu, 28 Mar 2024 00:00:00 +0000

Chromium 已升级至 122.0.6261.94 版本

我们已将 Chromium 升级到最新版本，该版本引入了多项安全修复，以防止远程攻击者通过精心构造的 HTML 页面潜在地利用堆损坏漏洞，具体包括：

如需了解 Chromium 122.0.6261.94 版本中所有修复和改进的完整列表，请访问以下版本的产品博客文章：

质量优化

在 4K 显示器上使用离屏渲染模式时，不再出现间歇性的 OverflowException 异常。
在单击应用程序窗口中的任何位置后，.NET 进程不再偶尔崩溃。

DotNetBrowser 2.26.0

Tue, 27 Feb 2024 00:00:00 +0000

投射 API

现在，可以直接从 DotNetBrowser 将媒体内容投射到 Chromium 支持的设备上。以下是实现的简单步骤：

IMediaReceivers receivers = engine.Profile.Default.MediaCasting.Receivers;
IMediaReceiver receiver = await receivers.RetrieveAsync(r => r.Supports(CastMode.Screen));
ICastSession castSession = await browser.Cast.CastScreen(receiver);

欲了解更多关于这项功能的信息，请查阅完整的指南。

Chromium 已升级至 121.0.6167.184 版本

我们已将 Chromium 升级到最新版本，该版本引入了多项安全修复，以防止远程攻击者通过精心制作的 HTML 页面或恶意文件潜在地利用堆损坏漏洞进行攻击。其中包括：

如需了解 Chromium 121.0.6167.184 版本中所有修复和改进的完整列表，请访问以下版本的产品博客文章：

DotNetBrowser 2.25.1

Mon, 22 Jan 2024 00:00:00 +0000

`SaveFileHandler` 对话框处理器

在这个版本中，我们引入了一个新的处理器，当浏览器在网页上执行 window.showSaveFilePicker() 时，该处理器将被调用。

如果有从此浏览器初始化的 BrowserView ，它将显示默认的文件选择器。您还可以直接在代码中处理此操作，并以编程方式提供文件：

Browser.Dialogs.SaveFileHandler = new Handler<SaveFileParameters, SaveFileResponse>(p =>
{
 return SaveFileResponse.SaveToFile(fileName);
});

Chromium 已升级至 120.0.6099.216

我们升级了 Chromium 至新版本，其中包含了多项安全修复，包括：

CVE-2024-0333: Insufficient data validation in Extensions

要查看 120.0.6099.216 版本中 Chromium 的全部修复和改进内容，请访问此版本的产品博客文章.

质量优化

Avalonia UI 中默认的 OpenFileHandler 现在会尊重 Chromium 提供的建议起始位置。

DotNetBrowser 2.25.0

Wed, 27 Dec 2023 00:00:00 +0000

Avalonia UI 的 Blazor 混合模板

DotNetBrowser.Templates 包现在新增了一个模板 - 一个简单的 Blazor 混合应用程序，该程序利用Avalonia UI 和 DotNetBrowser 的功能在桌面应用程序中运行 Razor 组件。此方法可用于构建跨平台桌面应用程序，并使用 Blazor 和 Avalonia UI 功能构建其用户界面，在网络和桌面之间共享大量代码。详情请参见我们的快速入门指南。

重大变更

由于 Chromium 的更改，the OpenFileHandler 参数不再包含 DefaultFileName 属性。相反，添加了 InitialDirectory 属性，该属性包含文件对话框应显示的初始目录。

在迁移指南中了解有关这些更改的更多信息。

Chromium 已升级至 120.0.6099.109 版本

我们将 Chromium 升级到了一个更新的版本，其中引入了多个安全修复，包括：

有关 120.0.6099.109 版本中 Chromium 修复和改进的完整列表，请访问此版本的产品博客文章。

DotNetBrowser 2.24.2

Wed, 22 Nov 2023 00:00:00 +0000

更新内容

Chromium

我们将 Chromium 升级到了更新版本，其中引入了多项安全修复，具体包括:

有关 Chromium 119.0.6045.105 的全部修复和改进，请访问该版本的产品博客文章.

您可以配置 Chromium 如何控制第三方 cookie：

关闭控制。
阻止第三方 cookie。
在隐身模式下阻止第三方 cookie。

例如：

IProfile profile = engine.Profile.Default;
profile.Preferences.ThirdPartyCookieMode = CookieControlsMode.BlockThirdParty;

质量优化

在关闭嵌入 DotNetBrowser 的窗体时，不再抛出 ObjectDisposedException 异常。
macOS 环境下的 CSS3 光标现在大小调整正常。
macOS 上输入字段的默认 Avalonia 上下文菜单中的“粘贴”选项现已正常工作。
Avalonia 中的自动填充建议弹出窗口现在显示在正确的初始位置，并在窗口失去焦点时正确关闭。

DotNetBrowser 2.24.1

Fri, 20 Oct 2023 00:00:00 +0000

更新内容

Chromium

我们已将 Chromium 升级至 118.0.5993.70 版本。

您可以在这里查看完整的更改列表。特别是，此版本包含对 CVE-2023-5218: Use after free in Site Isolation的修复。

质量优化

改进了 CanSetCookieHandler 中IsSession 属性的行为。
修复了在离屏渲染模式下 WPF 触摸屏应用程序中无法选择下拉框的问题。
修复了默认上下文菜单中异常处理的问题。

DotNetBrowser 2.24

Tue, 03 Oct 2023 00:00:00 +0000

期待已久的 Avalonia UI 支持以及包含安全更新的新 Chromium。

更新内容

Avalonia UI

我们非常激动地宣布，DotNetBrowser 现已加入对 Avalonia UI 的支持！

随着工具箱中再次实现新的集成，DotNetBrowser 已成为 Windows、Linux 和 macOS 上功能最全面、最通用的 .NET WebView 控件。

查阅快速入门指南，轻松在 5 分钟内构建一个跨平台应用程序。

macOS 上启动的 DotNetBrowser + Avalonia 应用程序。

Chromium

我们将 Chromium 升级到了 117.0.5938.62 版本。

您可以在这里查看完整的更改列表。特别是，此版本包含了对关键安全问题 CVE-2023-4863: Heap buffer overflow in WebP 的修复。

DotNetBrowser 2.23.3

Wed, 06 Sep 2023 00:00:00 +0000

更新内容

Chromium

我们已将 Chromium 升级至版本 116.0.5845.140。自上次升级以来的完整更改列表：

质量优化

增加了对 H265/HEVC 编解码器的支持。
改进了 WinForms 应用程序中 BrowserView 工具箱组件的行为（DotNetBrowser VSIX 包）。
启用了覆盖 AmbientAuthenticationInPrivateModesEnabled 策略的功能。
改进了对话框窗口的初始位置。

DotNetBrowser 2.23.2

Thu, 03 Aug 2023 00:00:00 +0000

更新内容

Chromium

我们已将 Chromium 升级至版本 115.0.5790.99。此次更新包含了20 项安全修复.

质量优化

修复了通过系统打印机打印的问题。
修复了 AJAX 请求在使用自定义 URI 方案时无法工作的问题。

DotNetBrowser 2.23.1

Thu, 22 Jun 2023 00:00:00 +0000

更新内容

Chromium

我们已将 Chromium 升级至版本 114.0.5735.134，其中包含了5 项安全修复.

质量优化

修复了由默认 BeforeUnloadHandler导致的应用程序冻结问题。
修复了由 “Save credit card（保存信用卡）” 对话框导致的应用程序冻结问题。
修复了 DRM 内容播放问题。
修复了在确认模态对话框后无法将焦点放在输入字段上的问题。
改进了在没有父级 WPF 或 WinForms 窗口时的父窗口检测。
DevTools 窗口标题现在显示打开页面的 URL。

DotNetBrowser 2.23

Thu, 25 May 2023 00:00:00 +0000

更新内容

触摸屏支持

从本次更新开始，DotNetBrowser在离屏渲染模式下支持触摸屏设备。这包括滚动、长按、捏拉缩放和内容旋转。

在 WPF 中支持完整的触摸和手势操作。在 WinForms 中，由于 WinForms 本身对触摸的支持有限，因此此功能仅限于轻触和长按。

Chromium

我们已将 Chromium 升级至版本 113.0.5672.63，其中包含了 15 项安全修复.

质量优化

改进了 JavaScript-.NET 桥接性能和内存使用。
在尝试使用不支持的纸张尺寸进行打印时，添加了警告日志。
解决了调试器捕获的 System.IO.FileNotFoundException: "Could not load file or assembly 'DotNetBrowser.Core.XmlSerializers'" 首次异常的出现。

DotNetBrowser 2.22.1

Thu, 27 Apr 2023 00:00:00 +0000

更新内容

Chromium 112

在此版本中，我们将 Chromium 引擎升级至版本 112.0.5615.137，其中包含了8 项安全修复。

默认字体大小

借助新的设置，修改IBrowser实例中加载的网页的默认字体大小：

browser.Settings.DefaultFontSize = 22;

质量优化

修复了 HTML5 颜色选择器无法正常工作的问题。
将像素格式切换为 Pbgra32，略微提高了 WPF 中的离屏渲染性能。
如果日志文件不存在，将自动创建其路径。

DotNetBrowser 2.22

Thu, 23 Mar 2023 00:00:00 +0000

更新内容

Chromium

我们升级了 Chromium 引擎至 111.0.5563.65 版本，该版本包含 40 个安全修复程序。

异步 JavaScript 执行

我们在 IJsObject 和 IJsFunction 中添加了 InvokeAsync() 方法. 它允许在不阻塞当前 .NET 线程的情况下执行 JavaScript 函数：

IJsObject window = frame.ExecuteJavaScript<IJsObject>("window").Result;
window.InvokeAsync("alert", "Hello world!");

网络预测

Chromium 具有默认设置，该设置允许预加载最常访问的页面，以实现更快的浏览。这是通过 DNS 预取、TCP 和 SSL 预连接、网页预渲染以及资源预取来实现的。

这个更新提供了禁用此功能的 API：

browser.Profile.Preferences.NetworkPredictionEnabled = false;

Quality enhancements

修复了 HiDPI 显示器上自定义光标缩放的问题。
修复了 PDF 查看器无法显示某些土耳其字符的问题。

DotNetBrowser 2.21

Mon, 27 Feb 2023 00:00:00 +0000

更新内容

Windows ARM

从现在开始，您可以在具有 ARM64 架构的 Windows 设备上使用 DotNetBrowser。请参阅从 NuGet 或者 ZIP。

Chromium

我们已将 Chromium 升级到版本 110.0.5481.77。此次更新包含 15 个安全修复.

从这一版本开始，Chromium 需要 Windows 10 或 Windows Server 2016 的最低版本。DotNetBrowser 也有同样的要求。

相机和麦克风事件

当标签页使用相机或麦克风时，Chromium 会在该标签页上显示一个红点。我们增加了通过编程方式检测这些设备使用情况的可能性：

Browser.MediaStreamCaptureStarted += (sender, args) =>
{
 Console.WriteLine($"Started capturing {args.MediaStreamType}");
};

Browser.MediaStreamCaptureStopped += (sender, args) =>
{
 Console.WriteLine($"Stopped capturing {args.MediaStreamType}");
};

质量优化

修复了在创建和关闭浏览器时 Chromium 崩溃的问题。

DotNetBrowser 2.20.1

Tue, 07 Feb 2023 00:00:00 +0000

更新内容

Chromium

我们已将 Chromium 更新至 108.0.5359.215 版本。

清除 HTTP 身份验证缓存

该 API 已经扩展了功能，允许您清除 HTTP 身份验证缓存：

profile.HttpAuthCache.Clear();

转发鼠标修饰键

通过这些更改，现在可以将鼠标修饰符与鼠标输入事件一起转发，以指示在这些事件期间哪些鼠标按钮处于按下状态。例如，我们可以模拟在按下鼠标左键的同时鼠标移动的事件：

MouseMovedEventArgs moveEvent = new MouseMovedEventArgs
{
 Location = location,
 MouseModifiers = new MouseModifiers
 {
 PrimaryButtonDown = true
 };
};

browser.Mouse.Moved.Raise(moveEvent);

质量优化

修复了检查点检查返回 DOM 节点对象绑定到不正确框架的问题。

DotNetBrowser 2.20

Wed, 28 Dec 2022 00:00:00 +0000

更新内容

Chromium 108

我们已将 Chromium 升级至 108.0.5359.125 版本，该版本中包含 8 个重要安全修复。

VB.NET 的后期绑定支持

我们改进了现有的 dynamic 支持，以使其更好地适用于 VB.NET。现在，可以通过后期绑定获取 JavaScript 对象的属性。例如：

' 获取 document.readyState 的值。
Dim document As Object
document = browser.MainFrame.Document
Dim readyState = document.readyState

System.Console.WriteLine($"Ready state: {readyState}")

' 获取 A 标签的完整引用。
Dim link As Object
link = browser.MainFrame.Document.GetElementByTagName("a")
Dim reference = link.href

System.Console.WriteLine($"Reference: {reference}")

质量优化

修复了在离屏渲染模式下截图时 GPU 崩溃的问题。

DotNetBrowser 2.19

Mon, 05 Dec 2022 00:00:00 +0000

更新内容

ARM

在具有 ARM64 架构的 Linux 和 macOS 上使用 DotNetBrowser。

该库已经在下述硬件和软件上进行了测试：

Raspberry Pi 2 (搭载 900MHz 四核 ARM Cortex-A7 CPU) 以及运行 Ubuntu 20.04 LTS 系统的 AWS (AWS Graviton 处理器)
搭载 Apple Silicon M1 芯片的 macOS Big Sur 系统

该库包含为 ARM 架构编译的 Chromium 二进制文件。请查阅相关文档，了解在 Linux 和 macOS 上应安装哪些软件包以集成到您的项目中。

可访问性

盲人和视力受损用户现在可以使用像 Narrator 或 JAWS 这样的专业软件来读取在 DotNetBrowser 中显示的网页上的文本。这项功能无论是离屏渲染模式还是硬件加速渲染模式均适用。

DotNetBrowser 2.18

Fri, 21 Oct 2022 00:00:00 +0000

此次发布带来了 Chromium 106 和导航优化。

更新内容

Chromium

我们已将 Chromium 升级至 106.0.5249.119 版本。该版本包含了来自 Chromium 105，Chromium 106，以及最新稳定版本更新的修复内容。

质量优化

修复了创建和销毁浏览器时可能出现的内存泄漏问题。

DotNetBrowser 2.17

Wed, 05 Oct 2022 00:00:00 +0000

DotNetBrowser 的历史将翻开新的一页！我们很高兴地宣布，DotNetBrowser 现在是一款跨平台库啦！

更新内容

可在 Linux 和 macOS 上使用

从 2.17 版本开始，该库也支持在 Linux 和 macOS 上运行。

DotNetBrowser 应用程序在 macOS DotNetBrowser 应用程序在 Ubuntu

无需额外的努力，在所有三个平台上使用相同的代码。只需安装新的二进制文件即可。

# For macOS
dotnet add package DotNetBrowser.macOS-x64

# For Linux
dotnet add package DotNetBrowser.Linux-x64

请查阅我们的安装指南文章，了解如何将必要的软件包从 ZIP 或 NuGet 添加到您的应用程序中。

支持的平台

我们正式支持基于 Intel 的 macOS 10.15+ 以及多种 64 位 Linux 发行版：

DotNetBrowser 2.16.1

Tue, 23 Aug 2022 00:00:00 +0000

更新内容

我们添加了异步创建 IEngine 的可能性：

public Form1()
{
 InitializeComponent();
 EngineFactory.CreateAsync(new EngineOptions.Builder()
 {
 RenderingMode = RenderingMode.HardwareAccelerated
 }.Build()).ContinueWith(t =>
 {
 engine = t.Result;
 browser = engine.CreateBrowser();
 browserView.InitializeFrom(browser);
 browser.Navigation.LoadUrl("google.com");
 }, TaskScheduler.FromCurrentSynchronizationContext());
}

质量优化

修复了 IME（输入法编辑器）在离屏渲染模式下导致应用程序意外终止的问题。

DotNetBrowser 2.16

Mon, 08 Aug 2022 00:00:00 +0000

更新内容

IJsObject 的动态类型支持

我们不断改善产品的易用性。现在，以下语法也可以使用了：

dynamic document = Browser.MainFrame.ExecuteJavaScript("document").Result;
document.write("Hello world!");

Chromium

Chromium 已升级至版本 102.0.5005.167。其中包括关键的安全修复。

WebAuthn 支持

现在可以使用硬件令牌或内置平台认证器（如指纹传感器）进行身份验证。

重新设计的拼写检查器 API

欢迎体验全新升级的拼写检查 API。要了解详细变更，请查阅我们的迁移指南和更新的文章。

加密的 PDF 文档

现在可以在 DotNetBrowser 中打开密码保护的 PDF 文档。当加密的 PDF 文档被加载时，默认情况下会显示标准的 Chromium 对话框。

要在程序中以编程方式提供，或取消密码请求，请使用 RequestPdfDocumentPasswordHandler：

// 以编程方式提供密码。
Browser.RequestPdfDocumentPasswordHandler =
 new Handler<RequestPdfDocumentPasswordParameters, RequestPdfDocumentPasswordResponse>(p
 => RequestPdfDocumentPasswordResponse.Password(Password));

// 取消密码请求。
Browser.RequestPdfDocumentPasswordHandler =
 new Handler<RequestPdfDocumentPasswordParameters, RequestPdfDocumentPasswordResponse>(p
 => RequestPdfDocumentPasswordResponse.Cancel);

DotNetBrowser 2.15.1

Fri, 17 Jun 2022 00:00:00 +0000

更新内容

Chromium

Chromium 已升级至版本 102.0.5005.115，其中包括 7 项安全修复。

SSL 证书验证

我们在 VerifyCertificateHandler 中添加了用户友好的证书验证错误描述。

Engine.Profiles.Default.Network.VerifyCertificateHandler =
 new Handler<VerifyCertificateParameters,
 VerifyCertificateResponse>(p =>
 {
 foreach (CertificateVerificationError verificationError in p.VerifyErrors)
 {
 Console.WriteLine("CertificateVerificationStatus = " +
 verificationError.VerifyStatus);
 Console.WriteLine("Short description = " +
 verificationError.ShortDescription);
 Console.WriteLine("Detailed description = " +
 verificationError.DetailedDescription);
 }
 return VerifyCertificateResponse.Valid();
 });

DotNetBrowser 2.15

Tue, 14 Jun 2022 00:00:00 +0000

更新内容

Chromium

Chromium 引擎已升级至版本 102.0.5005.63，其中包括 32 项安全修复。

加载 PDF

我们已经改进了 FrameLoadFinished 事件。现在，当 PDF 文档完全加载完成时，该事件将会被触发。

客户端证书链

现在，在客户端证书认证过程中，库会从 PKCS#12 存储中向服务器发送整个证书链（终端实体证书和中间证书）。

以下是传递自定义证书的中间证书的方法：

Certificate cert = new Certificate(certificate, intermediateCertificates);

certificate 是 X509Certificate 的实例。
intermediateCertificates 是包含中间证书的 X509CertificateCollection。

已修复的问题

在 Windows 上以硬件加速渲染模式显示和隐藏 BrowserView 时出现的黑屏闪烁问题。
在关闭警告对话框后，无法将焦点放在输入框上的问题。
创建 DOM 键盘事件时出现的 NullReferenceException 异常。

DotNetBrowser 2.14

Fri, 29 Apr 2022 00:00:00 +0000

更新内容

Chromium

Chromium 已升级至版本 100.0.4896.127。

此 Chromium 版本中包含 2 个重要安全修复。

光标浏览

现在，您可以使用文本光标而不是鼠标来浏览网页、选择文本并点击链接：

Browser.Profile.Preferences.CaretBrowsingEnabled = true;

网页表单自动填充

用户数据配置文件

使用包含地址、城市、电话、名字等信息的用户数据配置自动填充网页表单。

要访问和管理保存的用户数据配置文件，请使用 IUserDataProfileStore：

IReadOnlyList<UserDataProfile> allUserDataProfiles =
 Engine.Profiles.Default.UserDataProfileStore.All;

信用卡

记住信用卡信息，自动填充其详情，并使用全新 API 管理已保存的信息：

IReadOnlyList<CreditCard> allCreditCards = Engine.Profiles.Default.CreditCardStore.All;

修复与增强：

Widevine CDM 初始化存在明显延迟。
在 Windows 7 环境中，内置的 DevTools 窗口无法拖动。

DotNetBrowser 2.13.1

Tue, 12 Apr 2022 00:00:00 +0000

更新内容

Chromium 100

Chromium 已升级至 100.0.4896.75 版本。此版本包含一项重要安全修复。

打印预览事件

使用 PrintPreviewOpened 和 PrintPreviewClosed 事件来获取打印预览对话框打开或关闭时的通知。

DotNetBrowser 2.13

Thu, 07 Apr 2022 00:00:00 +0000

更新内容

Password Manager API

Chromium 具有内置功能，用于在用户提交带有用户名和密码的网页表单后存储输入的凭据。在这种情况下，将使用 SavePasswordHandler 和 UpdatePasswordHandler 处理程序来决定是否保存凭据，或者如果凭据已保存则更新它们。

要以编程方式保存或更新用户凭据，请使用 SavePasswordHandler 和 UpdatePasswordHandler，如下所示：

Browser.Passwords.SavePasswordHandler =
 new Handler<SavePasswordParameters, SavePasswordResponse>(p =>
 {
 return SavePasswordResponse.Save;
 });

Browser.Passwords.UpdatePasswordHandler =
 new Handler<UpdatePasswordParameters, UpdatePasswordResponse>(p =>
 {
 return UpdatePasswordResponse.Update;
 });

如果您保存了这些凭据，下次加载同样的表单并尝试填写时，将显示自动填充弹出窗口：

要访问和管理已保存的凭据，请使用 IPasswordStore：

IReadOnlyList<PasswordRecord> allPasswords =
 Engine.Profiles.Default.PasswordStore.All;
IReadOnlyList<PasswordRecord> savedPasswords =
 Engine.Profiles.Default.PasswordStore.AllSaved;
IReadOnlyList<PasswordRecord> neverSavedPasswords =
 Engine.Profiles.Default.PasswordStore.AllNeverSaved;

IPasswordStore 中保存的条目可以通过 URL 移除：

PasswordStore.RemoveByUrl(url);

要清除所有密码，请使用以下方法：

PasswordStore.Clear();

Chromium 100

Chromium 引擎已升级至 100.0.4896.60 版本。

此 Chromium 版本包含许多安全修复，所以我们强烈建议您升级至该版本。

扩展数组和集合支持

此版本为 JS-.NET 桥接带来了对集合的扩展支持。

DotNetBrowser 2.12

Wed, 23 Mar 2022 00:00:00 +0000

更新内容

Chromium 98

Chromium 引擎已升级至 98.0.4758.102 版本。

此 Chromium 版本包含许多安全修复，因此我们强烈建议您升级至该版本。

输入法支持

现在，您可以在 WPF 和 WinForms 应用程序中的离屏渲染模式下使用输入法 (IME) 输入中文、日文、韩文等文字。

EngineFactory.Create() 方法重载

指定所需的渲染模式变得更加容易了：

IEngine engine = EngineFactory.Create(RenderingMode.HardwareAccelerated);

处理智能卡

现在可以通过编程方式解锁智能卡并提供其 PIN 码：

private void SetSmartCardPin(X509Certificate2 originalCertificate)
{
 try
 {
 RSACryptoServiceProvider privateKey =
 originalCertificate?.PrivateKey as RSACryptoServiceProvider;

 if (privateKey != null)
 {
 CspParameters parameters = new CspParameters()
 {
 KeyContainerName = privateKey.CspKeyContainerInfo.KeyContainerName,
 ProviderName = privateKey.CspKeyContainerInfo.ProviderName,
 ProviderType = privateKey.CspKeyContainerInfo.ProviderType,
 Pin = Pin
 };

 bool result = browser.SetPrivateKeyProviderPin(parameters);
 Debug.WriteLine($"PIN configured: {result}");
 }
 }
 catch (Exception ex)
 {
 Debug.WriteLine($"PIN is not configured: {ex}");
 }
}

质量优化

“Paste” 选项已添加到默认的上下文菜单实现中。
“Save as” 对话框现在正确显示 “Save as type” 选项和文件扩展名。
修复了当前线程文化导致 DOM 节点创建逻辑出错的问题。
修复了未检测到 SSL 证书吊销状态的问题。

DotNetBrowser 2.11

Fri, 14 Jan 2022 00:00:00 +0000

更新内容

Chromium 96

Chromium 已升级至 96.0.4664.110 版本。

此 Chromium 版本包含 5 个重要修复，因此我们强烈建议您升级至该版本。

拦截触摸事件

现在可以使用以下处理程序来处理触摸事件：Touch.Started.Handler、Touch.Moved.Handler、Touch.Canceled.Handler 和 Touch.Ended.Handler。请参考下面的示例：

private void Subscribe(IBrowser browser)
{
 // 订阅触摸开始事件
 browser.Touch.Started.Handler = new Handler<ITouchEventArgs, InputEventResponse>(e =>
 {
 ITouchPoint point = e.TouchPoints.First(p => p.TouchState == TouchState.Started);
 Console.WriteLine($@"Touch {point.Id} started at -
 ({point.LocationOnWidget.X} : {point.LocationOnWidget.X})");
 return InputEventResponse.Proceed;
 });

 // 订阅触摸移动事件
 browser.Touch.Moved.Handler = new Handler<ITouchEventArgs, InputEventResponse>(e =>
 {
 ITouchPoint point = e.TouchPoints.First(p => p.TouchState == TouchState.Moved);
 Console.WriteLine($@"Touch {point.Id} moved to -
 ({point.LocationOnWidget.X} : {point.LocationOnWidget.X})");
 return InputEventResponse.Proceed;
 });

 // 订阅触摸取消事件
 browser.Touch.Canceled.Handler = new Handler<ITouchEventArgs, InputEventResponse>(e =>
 {
 ITouchPoint point = e.TouchPoints.First(p => p.TouchState == TouchState.Canceled);
 Console.WriteLine($@"Touch {point.Id} canceled at -
 ({point.LocationOnWidget.X} : {point.LocationOnWidget.X})");
 return InputEventResponse.Proceed;
 });

 // 订阅触摸结束事件
 browser.Touch.Ended.Handler = new Handler<ITouchEventArgs, InputEventResponse>(e =>
 {
 ITouchPoint point = e.TouchPoints.First(p => p.TouchState == TouchState.Ended);
 Console.WriteLine($@"Touch {point.Id} ended at -
 ({point.LocationOnWidget.X} : {point.LocationOnWidget.X})");
 return InputEventResponse.Proceed;
 });
}

模拟触摸事件

触摸事件可以通过使用 browser.Touch.Started、browser.Touch.Moved 和 browser.Touch.Ended 输入事件来模拟：

DotNetBrowser 2.10

Thu, 18 Nov 2021 00:00:00 +0000

What’s new

Chromium 94

Chromium has been upgraded to version 94.0.4606.113.

In March 2021, Google announced that Chrome/Chromium is planning to release a new milestone every 4 weeks, starting with Chrome/Chromium 94 in Q3 of 2021. Additionally, they added a new Extended Stable option, with milestone updates every 8 weeks. Security updates on Extended Stable will be released every two weeks to fix important issues, however, those updates won’t contain new features or all security fixes that the 4-week option will receive.

DotNetBrowser 2.9

Fri, 24 Sep 2021 00:00:00 +0000

What’s new

Chromium 92

The Chromium engine has been upgraded to version 92.0.4515.159.

Load progress event

The INavigation interface has been extended with the LoadProgressChanged event. It allows getting notifications about load progress:

browser.Navigation.LoadProgressChanged += (s, e) =>
{
 //The value indicating the loading progress of the web page.
 double progress = e.Progress;
};

Mouse events

We added the recognition of the additional (back/forward) mouse buttons. Here is how you can use the new feature to suppress the corresponding mouse events, for example:

DotNetBrowser 2.8

Fri, 20 Aug 2021 00:00:00 +0000

What’s new

Chromium 91

In this version, we upgraded Chromium to version 91.0.4472.164 that includes 8 important security fixes.

Network connection state

Now you can get notifications when the network connection state is changed.

Chromium internally tracks the Internet connection status. When the Internet connection is dropped and then restored, Chromium detects this and programmatically reloads the currently loaded web page.

DotNetBrowser 2.7

Mon, 26 Jul 2021 00:00:00 +0000

New DotNetBrowser 2.7 brings an updated Chromium engine and the API with new functionality.

What’s new

Chromium 91

The Chromium engine has been updated to version 91.0.4472.114.

This Chromium version includes several important security fixes, so we recommend that you upgrade to this version.

Some of the Chromium features wrapped with the DotNetBrowser have been removed or changed. Check out the migration guide to see what DotNetBrowser API has been removed and what alternatives you should use instead.

DotNetBrowser 2.6

Thu, 27 May 2021 00:00:00 +0000

DotNetBrowser 2.6 is available for download. In this update the Chromium engine has been upgraded to version 90.

What’s New

Chromium 90

In this release of DotNetBrowser, the Chromium engine has been updated to version 90.0.4430.93. This Chromium build includes several important security fixes, so we recommend that you upgrade to this version.

Improvements

The focus is now handled better when WPF BrowserView is embedded into a WinForms application.
The default dialogs in both WPF and WinForms now have better layouts.

Fixed Issues

The keyboard focus in WPF and WinForms applications is now properly set after minimizing and restoring or deactivating and activating the window.
Session cookies are now properly saved after the browser is disposed, and the engine is reused for creating another browser.

DotNetBrowser 2.5

Wed, 07 Apr 2021 00:00:00 +0000

DotNetBrowser 2.5 is based on Chromium 88.

What’s New

Chromium 88

Chromium engine in DotNetBrowser 2.5 has been updated to version 88.0.4324.182.

In this Chromium build some of its features wrapped with the DotNetBrowser have been removed or changed, so this DotNetBrowser version introduces several breaking changes in the public API. Check out the migration guide for this version to see what API has been changed/removed and what alternatives you should use instead.

DotNetBrowser 2.4

Tue, 02 Mar 2021 00:00:00 +0000

What’s New

Printing API

The Printing API is back – improved and redesigned. Now you can print pages and documents as well as savе web pages to PDF silently from the code.

With the new Printing API you can:

select a printer device;
provide the required print settings such as paper size, orientation, page ranges, etc.;
get notifications when printing is completed;
cancel printing;
save the currently loaded web page to a PDF document and more.

The following example demonstrates how to save the currently loaded web page as a PDF:

DotNetBrowser 2.3

Thu, 26 Nov 2020 00:00:00 +0000

DotNetBrowser 2.3 is based on Chromium 84.

What’s New

Chromium 84

Chromium has been updated to version 84.0.4147.135.

In this Chromium build some of its features wrapped with the DotNetBrowser have been removed or changed, so this DotNetBrowser version introduces several breaking changes in the public API.

Check out the migration guide for this version to see what API has been changed/removed and what alternatives you should use instead.

DotNetBrowser 2.2

Wed, 09 Sep 2020 00:00:00 +0000

In this update we improved the rendering performance in the off-screen rendering mode, restored functionality that allows disabling the internal Chromium traffic, and extended your options in managing data and user interaction with the browser.

What’s New

Rendering Performance

The off-screen rendering performance has been improved on all supported platforms and UI toolkits.

The results of the rendering performance testing on the different platforms on an HTML5 video in Frame Per Second (FPS) are the following:

DotNetBrowser 2.1.1

Thu, 02 Jul 2020 00:00:00 +0000

This minor update brings improved searching assemblies algorithm for the Global Assembly Cache.

Improvement

Updated searching assemblies algorithm for the Global Assembly Cache.

Fixed issues

InvalidOperationException: “This Visual is not connected to a PresentationSource.” thrown when moving, minimizing or maximizing a BrowserView control in WPF applications in both rendering modes.
Unpredictable behavior when using BrowserView controls inside TabControls or equivalent.

DotNetBrowser 2.1

Thu, 18 Jun 2020 00:00:00 +0000

This update enhances the DotNetBrowser with possibilities of the Chromium 79 and a range of features, adding to the convenience of interaction with the library.

What’s New

Chromium 79

The Chromium engine has been upgraded to version 79.0.3945.130.

Access to Engine options

It got possible to access the Engine options when two or more Engine instances run simultaneously. Now you can easily customize the Engine language, rendering mode and much more.

DotNetBrowser 2.0

Thu, 27 Feb 2020 00:00:00 +0000

Please meet a major update of DotNetBrowser — version 2.0! It introduces fundamental changes to the public API of the library allowing lots of new features and space for further growth.

We have improved the library implementation to make it compatible with .NET Standard 2.0. As a result, DotNetBrowser 2.0 supports .NET Core 2.2 as well as 3.0 on Windows.

The new version requires .NET Framework 4.5 or higher.

DotNetBrowser 1.21.5

Tue, 25 Feb 2020 00:00:00 +0000

The new version comes with an important fix, that resolves the blocker issue with the TypeLoadException, which occurs on runtime if the DotNetBrowser64.dll is used in the project.

We strongly recommend that you use version 1.21.5 instead of 1.21.4.

Request evaluation licence

DotNetBrowser 1.21.4

Mon, 24 Feb 2020 00:00:00 +0000

This library update provides fix for the improper location of the IME input when using the Chinese language.

Request evaluation licence

DotNetBrowser 1.21.3

Tue, 11 Feb 2020 00:00:00 +0000

With this update the library gets more apt for localization and remote desktop operation.

Fixed issues

The InvalidOperationException error occurring, when a window with the WPFBrowserView control in the heavyweight rendering mode is used via a remote desktop connection.
The JSValue returning a wrong number value in the German culture.

Request evaluation licence

DotNetBrowser 1.21.2

Wed, 25 Dec 2019 00:00:00 +0000

With this release the library gets more stable due to some important fixes.

Fixed issues:

The NullReferenceException error, occurring, when a window with the WPFBrowserView control in the lightweight rendering mode is moved.
The native process crashing if the LoadHandler.OnLoad method returns true.

Request evaluation licence

DotNetBrowser 1.21.1

Thu, 24 Oct 2019 00:00:00 +0000

Improvements:

We have added the sign to the GZipCompress.exe utility, which will reduce the number of errors with firewalls, antiviruses and other security software, when launching applications, containing DotNetBrowser.
The embedding process of the WinFormsBrowserView component in a WPF application got better. Now pop up windows are available upon embedding.

Fixed issues:

The InvalidCastException occurring because of the new PermissionRequest.PermissionType values in Chromium 69.
The InvalidOperationException occurring with the Channel already closed exception if registering a protocol handler for two or more BrowserContext instances.

Request evaluation licence

DotNetBrowser 1.21

Tue, 20 Aug 2019 00:00:00 +0000

The new version of DotNetBrowser introduces a number of requested features, and fixes making the library work even smoother:

Certificate chain

The CertificateVerifyParams.IntermediateCertificates property allows getting the intermediate certificate list retrieved from the server that can be used to reconstruct and verify the complete certificate chain.

Disable form autofill functionality

The BrowserContext.AutoFillEnabled property allows enabling or disabling auto-fill functionality.

DotNetBrowser 1.20.1

Tue, 11 Jun 2019 00:00:00 +0000

New version features several important improvements adding up to the library’s convenience and productivity:

Now you can easily check if the binaries use proprietary codecs with the new ChromiumBinaries.IsCodecEnabled property.
It got simple to look the Chromium version up – just check the Product version property of assemblies.
Use DotNetBrowser conveniently with toolbox support for Visual Studio 2019.
The new dispose logic allows the instance not to wait until all separated threads are released after invoking Browser.Dispose() or BrowserView.Dispose() methods.
We have also improved the algorithm for unpacking the Chromium binaries.

Fixed Issues:

DotNetBrowser 1.20

Sat, 20 Apr 2019 00:00:00 +0000

This version allows you to:

Display web pages more accurately, play MP3 audio, and easily set up printing across devices with new Chromium.
Protect your application from security breaches with fix to CVE-2019-5786 Chrome vulnerability
Simulate complex real-life user interactions with key modifiers for simulated mouse events.
Timely track down errors of proxy in Chromium.
Define current Chromium version used in your application.

Chromium 69

The Chromium engine has been upgraded to version 69.0.3497.12. Here are a few of its helpful features:

DotNetBrowser 1.19.1

Mon, 14 Jan 2019 00:00:00 +0000

This minor update of the library contains a number of improvements and fixes.

Fixes:

The offset issue with 101-124 DPI setting when using the WPFBrowserView instance in the heavyweight rendering mode.
The disposal of the Browser and BrowserView instances in different AppDomains.

Improvements:

The extraction logic has been improved. Now, the Chromium 32-bit and 64-bit binaries are extracted to the different directories.
Mask passwords in the log messages.

Request evaluation licence

DotNetBrowser 1.19

Tue, 27 Nov 2018 00:00:00 +0000

The new version of DotNetBrowser got more flexible and stable due to the following changes:

Browser.Dispose(bool checkBeforeUnload) Implemented

Due to this method, it got possible to invoke the DialogHandler.OnBeforeUnload method which is fired if the web page contains the onbeforeunload JavaScript event.

FileChooserParams.Filter Introduced

This property provides a meaningful description of the file extensions accepted by the file chooser. This information comes from the accept attribute of the input HTML element with the type=file attribute.

DotNetBrowser 1.18

Mon, 08 Oct 2018 00:00:00 +0000

The new DotNetBrowser comes with the following new features:

Chromium 64-bit process support

DotNetBrowser distribution package now includes both Chromium 64-bit and 32-bit binaries.

Important: Please note that Chromium 64-bit binaries can be used only on Windows 64-bit and cannot be used on Windows 32-bit.

Clear HTTP (basic) authentication cache

The API has been extended with new functionality that allows clearing HTTP Auth cache.

DotNetBrowser 1.17

Fri, 31 Aug 2018 00:00:00 +0000

Summer months were quite fruitful for DotNetBrowser. Here comes several new features:

Default zoom level

It is now possible to set the default zoom level for the BrowserContext instance during its creation. This property allows you to specify the default zoom level for all browsers which use the same context. All pages which are loaded through these Browser instances will have the specified zoom level from the start.

DotNetBrowser 1.16

Fri, 29 Jun 2018 00:00:00 +0000

New version of DotNetBrowser comes with a whole bunch of useful changes:

HiDPI Displays

In this version, we are glad to introduce the HiDPI Displays support which allows using all DPI-aware modes. The BrowserView control is compatible with various DPI awareness modes and renders HTML content with respect to the scale factor.

FIPS-compliance

We are FIPS-compliant now! Starting from the version 1.16, it is possible to use DotNetBrowser in the environments where the Federal Information Processing Standard restriction is enabled.

DotNetBrowser 1.15

Mon, 04 Jun 2018 00:00:00 +0000

Good news everyone! Chromium version was upgraded in the new DotNetBrowser!

Chromium 64

The Chromium engine has been upgraded to version 64.0.3282.24.

Improvements:

The Printing API has been extended with the new color models.

Fixed issues:

The Chromium profile directory being unlocked while there are alive Browser instances related to the corresponding context.
The ArgumentNullException exception during raising the PreviewKeyDown event.
Render process crash during disposing Browser instances.

Request evaluation licence

DotNetBrowser 1.14.3

Wed, 16 May 2018 00:00:00 +0000

In this minor update all binary files are signed with an updated certificate.

The certificate, we used to sign binary files in DotNetBrowser 1.14.2 and lower, already expired. So, if you need to use DotNetBrowser in an environment where it’s required that all binary files including exe and dll are signed with a valid certificate, then we strongly recommend that you upgrade to 1.14.3.

Request evaluation licence

DotNetBrowser 1.14.2

Wed, 11 Apr 2018 00:00:00 +0000

New DotNetBrowser comes with an important fix that resolves the blocker issue in the IPC module introduced in DotNetBrowser 1.14.1.

We strongly recommend that you use 1.14.2 instead of 1.14.1.

Request evaluation licence

DotNetBrowser 1.14.1

Tue, 10 Apr 2018 00:00:00 +0000

Important: this version contains a blocker issue that has been fixed in 1.14.2. Please use 1.14.2 instead of 1.14.1.

Current release is focused on creating solutions for reported issues, and improving performance of some key areas:

Improvements

The available port detection algorithm during the socket initialization is improved.
Logging is improved.
The Browser.OnStartLoadingFrame and Browser.OnProvisionalLoadingFrame events is improved.
The VS 2017 VSIX package compatibility is added.

Fixed issues

DotNetBrowser WPF visual component raising an error in the Design mode. This issue was caused by the WPFBrowserView() constructor implementation.
Browser or BrowserView instance hanging in the different AppDomains. This issue was caused by an issue in the internal IPC module.
InvalidOperationException exception with the “Channel is already closed” message being thrown. This issue was caused by the native crash in the Chromium render process.
BrowserPreferences.SetChromiumDir() method having no effect on the Release configuration. The issue was related to the inline initialization of the static fields.
Some events not being present in the WinForms Properties window in the Design mode. This issue was caused by the lack of the event attributes.
Custom NetworkDelegate not working after all the Browser or BrowserView instances are disposed and created again. This issue was caused by an issue in the NetworkService implementation.
The issue with incorrect WPFBrowserView location hosted in ElementHost.
The issue with displaying mouse cursor WinFormsBrowserView.
The issue with focus stealing on every navigation.
The native crash when disposing Browserinstance when printing is in progress.
The issue when BrowserView.GetImage() returns black rectangle.
The issue when ProtocolService.Unregister(IProtocolHandler) method removes all protocols.

Request evaluation licence

DotNetBrowser 1.14

Thu, 30 Nov 2017 00:00:00 +0000

With this DotNetBrowser update we focused on enhancements for browsing privacy, and HTML5 handling.

Incognito Mode

By default, each Browser instance stores all user data such as history, cookies, cache on the disk. Starting from version 1.14, you can configure Browser to store all user data in memory (Chromium’s “Incognito” mode), so that all user data will be cleared once your .NET application is terminated.

DotNetBrowser 1.13

Wed, 18 Oct 2017 00:00:00 +0000

This version of the library was extended with the features, allowing to intercept all the URL requests for both standard URL schemes (such as http, https, ftp, file), and custom schemes declared in your application. After registering a protocol handler for a scheme, all the URLs with the specified scheme loaded into the Browser will be handled by this handler.

Protocol Handler

Implementing a new custom protocol handler in DotNetBrowser is pretty simple:

DotNetBrowser 1.12

Wed, 20 Sep 2017 00:00:00 +0000

We are happy to announce availability of the new DotNetBrowser version. Please find a detailed overview of the changes, introduced in v1.12:

Chromium 60

The Chromium engine was upgraded to version 60.0.3112.113. It means that support of WebGL 2.0 was automatically enabled.

New features

Ability to modify User-Agent string for the particular Browser instance at runtime.
Ability to change AcceptLanguage for the particular Browser instance at runtime.
Ability to convert JSObject to JSON string.

Improvements

The on-screen keyboard support in Windows 10.
Support of custom cursors (WPF, Lightweight). The previous implementation created undesired temporary files in the working directory. Such behavior may have caused exceptions when the working directory is read-only.
The startup errors handling. Now the exceptions that may be thrown during startup will include more information about the root cause of the error.
Stability when loading Flash content after displaying a PDF file.
Stability when loading Flash content after displaying popups.

Fixed issues:

The WPFBrowserView.PreviewMouseWheel event now provides the scroll delta properly (WPF, Heavyweight). In the previous implementation, the received scroll delta was always set to 0.
Issue with custom PopupHandler implementation being ignored and the default one being used when the WPFBrowserView control is hosted in the WinForms applications.
Unnecessary focus grabbing when the StartLoadingFrameEvent event has been received (WPF, Heavyweight).
Issue when it’s not possible to access some properties of the IDictionary object injected into JavaScript through JS-.NET bridge API. For example, the previous implementation worked improperly with the Keys property.
Losing keyboard focus after displaying a JavaScript dialog (WinForms, Lightweight).
Blurred text on a web page (WPF, WinForms, Lightweight).
PDF document rendered incorrectly in the environments with non-default DPI settings.

Request evaluation licence

DotNetBrowser 1.11.1

Mon, 14 Aug 2017 00:00:00 +0000

Resolved issues:

DownloadHandler not working if the DotNetBrowser assembly was loaded via Assembly.Load().
Sporadic Chromium crash for BrowserView running in the lightweight mode.
.NET memory leak in the ImageProvider implementation.
WPFBrowserView focus stealing issue (reproducible for WPF ToolBar buttons in the same window).

Request evaluation licence

DotNetBrowser 1.11

Mon, 26 Jun 2017 00:00:00 +0000

Please meet a new, more functional and stable version of DotNetBrowser. This update contains:

New features

Taking page screenshot without creating BrowserView. With this feature, it is possible to take screenshots of the loaded web page having only Browser instance. This feature works only if the Browser was created in the lightweight rendering mode.
Touch event handling. Now it is possible to intercept touch events and prevent them from being handled by the Chromium engine.
Unpacking Chromium binaries to the the non-default folder.
Ability to provide a custom CA certificate.
Extended drag and drop events, which provide the ability to access the underlying IDataObject instance.

Resolved issues

Incorrect HTML5 application cache behavior when offline.
An issue with missing JavaScript context, which was the cause of possible NullReferenceException, when working with JavaScript object and missing ScriptContextCreated events. .NET memory leak for synchronous methods.
KeyPress event handling issue for WinFormsBrowserView running in the heavyweight rendering mode.

Improvements

Removed dependency on Microsoft.VisualStudio.Shell.Immutable.10.0.dll
Added Chromium profile directory validator to prevent usage of the same data directory by multiple BrowserContext instances.

Request evaluation licence

DotNetBrowser 1.10

Thu, 27 Apr 2017 00:00:00 +0000

With this release we are pleased to introduce the long awaited upgrade. Now DotNetBrowser runs on a more powerful browser engine – Chromium 55.0.2883.87. But we did not stop there, check the full list of enhancements we delivered with this update:

Implemented Chromium sandbox support. By default, Chromium sandbox is disabled to keep the behavior of previous DotNetBrowser versions.
The library now supports HTML5 transparent background.
Added the OnPreviewKeyDown event support in WinForms heavyweight rendering mode.
Added support of the proper key modifiers for the keyboard events in WinForms heavyweight rendering mode.
Implemented an ability to embed WPFBrowserView into WinForms ElementHost.

Here’s what has been resolved in this update:

DotNetBrowser 1.9

Fri, 03 Feb 2017 00:00:00 +0000

Great news for Visual Studio users! DotNetBrowser 1.9 can be used as a web browser component for .NET apps, developed in Visual Studio 2017 RC.

Apart from Visual Studio 2017 RC support, in this version, we concentrated on extending DOM API with new features, ability to specify custom CSS rules which will be then applied to every loaded web page, enhancements in heavyweight rendering mode, and several other important updates, aimed at improving security and performance of the library.

DotNetBrowser 1.8.4

Mon, 19 Dec 2016 00:00:00 +0000

New features

Desktop notifications and permission request support. Now it is possible to handle the case when a web page wants to display desktop notifications or ask for a permission. You decide whether the web page is allowed to display notifications or not. By default, desktop notifications are suppressed.
Ability to get the download interruption reason. If there is an error during download and the download itself was interrupted, it is possible to obtain the interruption reason (file system, network or server errors).
Ability to disable and enable zoom for a specific Browser instance to prevent web page from zooming.
Ability to force full spell check on the web page.

Improvements in DOM API

Get XPath of the DOM element. Now it is possible to obtain the XPath expression that describes the particular DOM element.
Get bounding client rectangle of the DOM element. This DOM element property returns the bounds of the element and its position relative to the top-left corner of the current document’s viewport.

Bugfixes

Fixed an issue in the ResourceHandler. in the previous version, the handler was not working if the network delegate was not configured. Now these two features are working independently.

Request evaluation licence

DotNetBrowser 1.8.3

Mon, 21 Nov 2016 00:00:00 +0000

We focused on improving the following areas:

Performance

Improved page load performance.
Improved page scrolling smoothness. Now there is no visible delay when scrolling the loaded web page via dragging the scrollbar.

DOM API

Added the ability to obtain DOMElement position properties:

DOMElement.OffsetTop
DOMElement.OffsetLeft
DOMElement.OffsetWidth
DOMElement.OffsetHeight
DOMElement.ClientTop
DOMElement.ClientLeft
DOMElement.ClientWidth
DOMElement.ClientHeight
DOMElement.ScrollTop
DOMElement.ScrollLeft
DOMElement.ScrollWidth
DOMElement.ScrollHeight

New Features

Ability to configure proxy when browser is running. The previous versions of DotNetBrowser allowed to configure proxy settings only once – before creating a Browser instance. Now it is possible to switch to another proxy without creating a new Browser.
HTML5 App Cache support. This type of cache is used by some web applications to make them accessible even without an internet connection.
Ability to intercept HTTP response and access its contents. The previous versions of DotNetBrowser were able to intercept the requests, but not the responses.

Bugfixes

Fixed keyboard event handling for Windows Forms heavyweight control. In previous versions, the proper key events were not fired for this control.
Fixed an issue related to processing the User-Agent string with spaces.

Request evaluation licence

DotNetBrowser 1.8.1

Tue, 13 Sep 2016 00:00:00 +0000

The new version lists the following features and improvements:

DOM API update, which brings the possibility to modify DOM: create, append, insert, replace and remove DOM nodes.
Ability to get the DOM node at the particular location on the page.
Ability to emulate custom DOM events for the specific DOM elements.
Mute Audio API. This API allows to mute all audio output for the particular Browser instance. Also, it is possible to determine if the browser is currently muted or playing audio.
Ability to customize the filename for the native process. Now it is possible to set the custom name for DotNetBrowser.Chromium.exe and all native process instances will be subsequently renamed.
Back-forward navigation history list support. Now it is possible to navigate to the particular entry in the back-forward navigation history and even remove some entries from the history.
Browser.Loading property which allows to determine whether browser is currently loading something.
Editor commands support. Editor commands are the commands for text manipulation when editing in a text field, text area or WYSIWYG editor. Also these commands include more common commands like Cut, Copy, Paste, SelectAll, Undo, Redo, which can be executed for the frame in the loaded web page.
Web storage API. Now it is possible to access local or session web storage and create, store, find and remove key/value pairs in it.
Ability to get selected text or HTML for the frame with a specific ID.
Ability to pause, resume and cancel downloads.
Password Manager update. Now it is possible to be informed about the password update events (when the user enters a new password for the previously saved login).
Added RenderGone event. This event allows to detect unexpected render process termination and relaunch it by loading the same URL once more.

And the following issues have been fixed in this update:

DotNetBrowser 1.8.2

Tue, 13 Sep 2016 00:00:00 +0000

Preparing the new release, we focused on improvements in these areas:

JavaScript – .NET Bridge

Implemented C# objects support for JSFunction.Invoke(). In previous versions, only primitive types and DotNetBrowser JS wrappers could be used as parameters. Now it is possible to pass .NET objects as parameters to JavaScript function call.
Added JavaScript context events. These events can be used to execute any JavaScript code before the web page JavaScript is executed.

Lightweight rendering mode

Simplified embedding for lightweight controls. The previous version allowed embedding lightweight controls from source code only. Now they can be embedded from Toolbox or XAML directly.
Enhanced performance for saving web page as image in the lightweight mode.
Improved lightweight rendering performance.

DOM API

Now you can attach a single event listener to several DOM events by a single call.
Added LINQ support for XPath. Now you can use LINQ expressions to work with nodes returned after evaluating XPath expression.

Properties and events of the BrowserView controls are now available in the Designer.
Added ability to specify WebRTC IP handling policy. This allows to prevent exposing of the local IP addresses to servers.

Fixes

DotNetBrowser crash when handling custom cursors. This issue was reproducible when the custom cursor is detected in Chromium, but no image provided for it.
Several issues in the default context menu implementation.
ComboBox auto-close issue, which was reproducible when some popup windows were open.
Issue with debugger hanging on public properties evaluation.

DotNetBrowser 1.8

Mon, 08 Aug 2016 00:00:00 +0000

The main change in DotNetBrowser 1.8 is upgrade of its Chromium engine to version 51.0.2704.106.

In November 2015 Google announced the end of Chrome/Chromium’s support for Windows XP, as well as Windows Vista, and Mac OS X 10.6, 10.7, and 10.8, since these platforms are no longer actively supported by Microsoft and Apple. Starting with Google Chrome/Chromium 50, these platforms are no longer supported at all. Since DotNetBrowser 1.8 is based on Chromium 51, support of these platforms has been dropped as well.

DotNetBrowser 1.7.1

Mon, 04 Jul 2016 00:00:00 +0000

DotNetBrowser 1.7.1 comes with the following features and improvements:

Update of DOM API. Now it is easier to work with forms fields, modify field values and obtain modified values directly from .NET.
Improved inter-process communication between .NET and Chromium processes.
Added spell checker support. Now you can enable or disable spell checking, configure a specific language to use and be notified about spell check completion.
Added password manager support. Now it is possible to save login credentials or tell Chromium not to save them for a specific website.
Added media stream device manager API. Now it is possible to choose a non-default web camera or microphone.
Fixed heavyweight component freezing.
Fixed keyboard typing latency.

DotNetBrowser 1.7

Tue, 07 Jun 2016 00:00:00 +0000

DotNetBrowser 1.7 comes with the following features and improvements:

Upgrade to Chromium 49.
Update of Printing API. Now regular and PDF printing are handled by the same handler.
Improved JavaScript — C# bridge: now it is possible to access .NET objects and invoke their methods as if they were regular JavaScript objects. Please take a look at the migration guide that we have prepared.
Improved native process crash handling: now the dumps with information about crash are generated automatically when a process crashes.
Brand-new Certificate Validation API.
Intorduced frames IDs hierarchy API. Now it is possible to find the IDs of all the child frames for a specific frame.
Fix for incorrect rendering on resizing of the lightweight component.

There were some big changes, too. In this Chromium build support of NPAPI plugins has been removed at all. Now, NPAPI plugins such as Microsoft Silverlight, Java Applets, etc. are not supported. The --enable-npapi Chromium switcher doesn’t work either. PPAPI plugins such as Adobe Flash work well with this Chromium build.

DotNetBrowser 1.6.4

Wed, 27 Apr 2016 00:00:00 +0000

DotNetBrowser 1.6.4 contains the following features and improvements:

Default context menu implementation.
PluginInfo support for DotNetBrowser plugins.
Improved JavaScript C# bridge. Now it is possible to work with JavaScript objects.
Auto-dispose for browser views, created using the default constructor.
Fix for incorrect drop-down position and size for lightweight WPF views and non-default screen DPI.
Fixes for several deadlock issues for heavyweight controls.

DotNetBrowser 1.6.3

Tue, 05 Apr 2016 00:00:00 +0000

DotNetBrowser 1.6.3 contains the following features and improvements:

Added print handler for PrintToPDF() functionality.
Added InnerText property support for DOMElement.
Implemented GetImage() for HEAVYWEIGHT mode.
Implemented mouse and keyboard events for BrowserView.
Fixed resizing issue for the default popup implementation.
Fixed incorrect size calculation for non-default screen DPI.
Fixed Visibility property for WPFBrowserView.
Fixed scrollbar behavior and text selection for LIGHTWEIGHT mode.

DotNetBrowser 1.6.2

Thu, 03 Mar 2016 00:00:00 +0000

DotNetBrowser 1.6.2 contains the following features and improvements:

Implemented Text Search API.
Implemented web cursors support.
Implemented Flash context menu support.
Improved Flash Stage3D support. Now DotNetBrowser supports Flash games and applications with real-time interactive 3D graphics.
Resolved issue with drop-down lists behavior.
Fixed several native crashes and thread deadlock issues during Browser instantiation/disposal.

DotNetBrowser 1.6.1

Wed, 03 Feb 2016 00:00:00 +0000

DotNetBrowser 1.6.1 contains the following features and improvements:

Implemented XPath support.
Improved Video support (HTML5, Flash, Silverlight): now DotNetBrowser supports access to video-sharing websites, such as Vimeo and Maxdome and also works stably while enabling full screen video mode.
Resolved issue with NullReferenceException thrown during initialization on Windows 8/8.1/10.
Improved stability of WinForms/WPF BrowserView control in MS Visual Studio WinForms/XAML UI Designer.
Fixed thread deadlock issues during Browser instantiation/disposal.

DotNetBrowser 1.6

Tue, 22 Dec 2015 00:00:00 +0000

DotNetBrowser 1.6 contains the following features and improvements:

Chromium environment variables support has been implemented.
Support of Remote Debugging URL has been added.
NetworkDelegate for intercepting all HTTP request/response headers and obtain information about each request/response stage has been added.
Receiving a list of frames IDs in the currently loaded document has been implemented.
The issue with NullReferenceException thrown during initialization on Windows 8/8.1/10 has been fixed.
The issue with TypeInitializationException thrown in VisualStudio 2012 on Windows 10 has been fixed.
The issue with wrong BrowserView size when DPI is set to 125% has been fixed.

DotNetBrowser 1.5.2

Tue, 01 Dec 2015 00:00:00 +0000

DotNetBrowser 1.5.2 contains the following features and improvements:

Cache Storage API has been implemented.
Environment validation has been disabled.
The issue when Browser instances share proxy settings has been fixed.
The issue when proxy authentication doesn’t work has been fixed.

DotNetBrowser 1.5.1

Wed, 18 Nov 2015 00:00:00 +0000

DotNetBrowser 1.5.1 contains the following features and improvements:

Support of HiDPI monitors on Windows 8/8.1/10 has been implemented.
The issue with wrong Target attribute in DOMEventListener has been fixed.
Web page loading time has been improved.

DotNetBrowser 1.5

Mon, 02 Nov 2015 00:00:00 +0000

DotNetBrowser 1.5 contains the following features and improvements:

Printing API has been implemented. API allows printing web page with different print settings on a printer device or save loaded web page as PDF document.
Dotted border around focused WPF BrowserView control has been removed.
Stability has been improved.

DotNetBrowser 1.4

Tue, 27 Oct 2015 00:00:00 +0000

DotNetBrowser 1.4 contains the following features and improvements:

GPU-accelerated rendering mode has been implemented.
Chromium engine has been upgraded to version 43.
Support of .NET 4.0 has been added.
Support of Windows Server 2008 and 2012 has been implemented.
Integration with XAML has been improved.
The size of DotNetBrowser.Chromium.dll has been decreased (from 74Mb to 43Mb).
The PluginManager.GetPluginsInfo() method has been implemented.
The NetworkService and NetworkDelegate classes has been added.
The NetworkDelegate.OnAuthRequired() method for handling proxy server, basic, digest, and NTLM authentication has been added.
Stability and memory usage has been improved.

DotNetBrowser 1.3

Mon, 10 Aug 2015 00:00:00 +0000

DotNetBrowser 1.3 contains the following features and improvements:

Support of Windows 10 and .NET 4.6 has been implemented.
Cookies API has been added.
Custom Context Menu has been added.
File Downloads API has been implemented.

DotNetBrowser 1.2.1

Tue, 07 Jul 2015 00:00:00 +0000

DOM Events API

DotNetBrowser 1.2.1 contains the following features and improvements:

DOM Events API has been added.
Fixed issue when JavaScript .NET Bridge does not work sometimes.

DotNetBrowser 1.2

Fri, 03 Jul 2015 00:00:00 +0000

DotNetBrowser 1.2 contains the following features and improvements:

DOM API has been added.
Zoom API has been added.
Support of environment with dynamic assembly has been implemented.

DotNetBrowser 1.1

Mon, 08 Jun 2015 00:00:00 +0000

DotNetBrowser 1.1 contains the following fixes and improvements.

Support of Windows 8 and 8.1 has been added.
Support of Windows Forms has been implemented.
Automatic extraction of Chromium binaries into user’s temp folder has been implemented. Now you don’t need to configure path to the directory with Chromium binaries, DotNetBrowser will extract them into user’s temp directory and perform all necessary configuration programmatically.

DotNetBrowser 1.0

Mon, 06 Apr 2015 00:00:00 +0000

DotNetBrowser is a .NET Library that allows embedding Chromium-based component into .NET applications to display modern web pages built with HTML5, CSS3, JavaScript, etc.

DotNetBrowser provides WPF component that you can embed into WPF Desktop Application to display web pages. HTML content is rendered by Chromium engine. The component displays graphics that is rendered by Chromium engine in separate process. The library supports Chromium’s Multi-Process Architecture. There are no differences in web page rendering between DotNetBrowser and Google Chrome. The web page will look exactly as in Google Chrome.

DotNetBrowser 1.1.1

Mon, 06 Apr 2015 00:00:00 +0000

DotNetBrowser 1.1.1 contains the following features and improvements:

Support of both 32-bit and 64-bit architectures has been added.
JavaScript dialogs for both WinForms and WPF control has been implemented. See DotNetBrowser.WinForms.WinFormsDefaultDialogHandler and DotNetBrowser.WPF.WPFDefaultDialogHandler classes.

版本发布政策 on DotNetBrowser 文档

DotNetBrowser 4.2.0

macOS 上的 Touch ID

Chromium 150.0.7871.47

DotNetBrowser 4.1.1

UrlRequestJob API 改进

触控选择手柄

DotNetBrowser 4.1.0

破坏性变更

IHttpCache.DiskCacheCleared 事件已移除

Avalonia 12 支持

通过 IProfile.ClearAllData() 简化数据清理

按浏览器缩放

DotNetBrowser 4.0.1

Chromium 147.0.7727.138

质量改进

DotNetBrowser 4.0.0

裁剪和 Native AOT 支持（.NET 8+）

每个浏览器的渲染模式

新增 JavaScript 类型

DotNetBrowser 3.5.1

扩展鼠标事件属性

.NET JavaScript 对象字符串大小限制

Chromium 146.0.7680.80

DotNetBrowser 3.5.0

新增了初始化异常

PDF 文档加载的变更

重大变更

DotNetBrowser 3.4.0

Linux 上的 Sandbox（沙箱）

需要采取的操作

在不同存储之间复制密码

破坏性变更（Breaking changes）

移除枚举中的技术值

DotNetBrowser 3.3.7

.NET 10 支持

Chromium 143.0.7499.41

质量改进

DotNetBrowser 2.27.20

Chromium 142.0.7444.176

DotNetBrowser 3.3.6

Chromium 142.0.7444.176

质量改进

DotNetBrowser 2.27.19

Chromium 142.0.7444.60

DotNetBrowser 3.3.5

Chromium 142.0.7444.60

从 .NET Task 转换为 JavaScript Promise

DotNetBrowser 2.27.18

Chromium 141.0.7390.55

DotNetBrowser 3.3.4

Chromium 141.0.7390.55

质量改进

DotNetBrowser 2.27.17

Chromium 140.0.7339.133

DotNetBrowser 3.3.3

Chromium 140.0.7339.133

质量改进

DotNetBrowser 2.27.16

Chromium 139.0.7258.67

结束对 macOS 11 的支持

DotNetBrowser 3.3.2

Chromium 139.0.7258.67

结束对 macOS 11 的支持

DotNetBrowser 2.27.15

Chromium 138.0.7204.97

DotNetBrowser 3.3.1

Chromium 138.0.7204.97

HTTP 状态代码属性

质量改进

DotNetBrowser 2.27.14

Chromium 137.0.7151.69

DotNetBrowser 3.3.0

Chromium 137.0.7151.69

DotNetBrowser 2.27.13

Chromium 136.0.7103.114

DotNetBrowser 3.2.1

Chromium 136.0.7103.114

DotNetBrowser 2.27.12

Chromium 135.0.7049.52

`IHttpCache.DiskCacheCleared` 事件已移除

`SaveFileHandler` 对话框处理器