发布日期 2020年11月6日

JxBrowser 7.12

Chromium 84

Chromium 已更新至 84.0.4147.135 版本。

在此 Chromium 版本中，JxBrowser 中包含的一些功能已被删除或更改，因此该 JxBrowser 版本在公共 API 中引入了几项重大更改。

请查看此版本的迁移指南，了解哪些 API 已更改/移除以及应使用哪些替代方法。

DOM

可信事件

com.teamdev.jxbrowser.dom.event.Event 接口已扩展 isTrusted() 该方法允许检测事件是由用户操作生成，还是通过 EventTarget.dispatchEvent() 方法创建、修改并分发的。

MouseEvent：页面位置

com.teamdev.jxbrowser.dom.event.MouseEvent 接口已扩展 pageLocation() 方法，该方法允许获取事件发生时鼠标光标在文档坐标系中的位置。

KeyEvent：键码

获取 com.teamdev.jxbrowser.dom.event.KeyEvent 键码的功能已重新设计，使其类似于 DOM KeyboardEvent。我们引入了 DomKeyCode 枚举来表示 DOM 键码，并扩展了 com.teamdev.jxbrowser.dom.event.KeyEvent，添加了获取 DOM 键码和表示与物理键关联的 UTF-8 字符串的方法（如果该键有打印表示）。例如：

document.addEventListener(EventType.KEY_PRESS, event -> {
    if (event instanceof KeyEvent) {
        KeyEvent keyEvent = (KeyEvent) event;
        DomKeyCode keyCode = keyEvent.domKeyCode();
        String character = keyEvent.character();
        System.out.println("DOM KeyEvent: keyCode=" + keyCode + ", character=" + character);
    }
}, false);

JS 可访问的 Java 类

JavaScript-Java 桥接 API 已扩展 com.teamdev.jxbrowser.js.JsAccessibleClasses，该类允许指定类型的 Java 实例可以从 JavaScript 中访问。例如：

JsAccessibleClasses.add(ArrayList.class, LinkedList.class);

Cookie SameSite

已添加对 SameSite Cookie 属性的支持。

改进

• 现在该库在离屏渲染模式下通过了检测 “MovementX 和 MovementY 在鼠标事件中变化” 的 JS 测试。
• 从此版本开始，Frame.isMain() 方法不再向 Chromium Engine 发送请求来确定该 Frame 是否是 Browser 中的主（顶级）Frame。现在，这些信息在创建 Frame 时提供，并缓存以供后续调用。
• 现在不允许运行与 JxBrowser Chromium 二进制文件一起提供的 Chromium 可执行文件。JxBrowser 使用的 Chromium 二进制文件仅供 JxBrowser 使用，用户不应能够直接运行它并将其用作常规的 Web Browser 应用程序。
• 现在允许将 JavaFX 的 BrowserView 嵌入到继承自 JFXPanel 的容器中。例如：

  JFXPanel fxPanel = new MyJFXPanel();
  BrowserView view = BrowserView.newInstance(browser);
  fxPanel.setScene(new Scene(new BorderPane(view), 600, 600));
  
  private static final class MyJFXPanel extends JFXPanel {}
  

• TextFinder 的 Javadoc 已扩展，提供了关于文本搜索如何工作、如何高亮显示匹配项、如何检测第一个匹配项等额外详细信息。
• 默认情况下，Chromium 会在二进制文件所在目录中创建 debug.log 文件。在某些环境中，访问该目录可能被禁止，操作系统可能会报告此类尝试。从此版本开始，Chromium 将不再创建 debug.log 文件，相应的日志消息将重定向到 JxBrowser 日志中。
• 现在，库中使用的 Chromium 构建是使用 is_official_build=true 标志构建的。官方的 Chromium 构建禁用了在官方 Google Chrome 构建中禁用的实验性 Study Configurations（测试配置）。在 JxBrowser 之前的版本中启用的实验性功能之一是 Page Freezing（页面冻结），该功能可能会冻结网页并停止 JavaScript 执行。因此，库中使用的 Chromium Engine 在启用/禁用的内部功能方面变得更接近官方 Chromium 构建。
• 已禁用触发 Windows Audit Failures（Windows 审核失败) 的功能。此问题由 Chromium 调用 Windows API 中的 LogonUser() 函数，并传递空密码导致。我们通过禁用尝试使用空密码登录的功能解决了此问题。此更改不会影响任何其他 Chromium 功能。

已修复的问题

• 当 Chromium 渲染进程崩溃时，不再显示 “Aw, snap” 页面。
• 在 Windows 上，JavaFX 7.9 版本中，离屏渲染模式下出现渲染错误。
• 在 Linux 上，在硬件加速渲染模式下隐藏和显示带有嵌入式 BrowserView 的 JFrame 后，Web 内容不显示的问题。
• 在离屏渲染模式下，带有空数据类型的 HTML5 拖放事件被忽略，这导致部分 HTML5 拖放事件完全无法工作。
• 在离屏渲染模式下，从文件系统拖动文件到 Swing 的 BrowserView 实例时出现 NullPointerException 错误。
• 在离屏渲染模式下，主 Stage 显示后，尝试显示包含嵌入式 BrowserView 实例的 JavaFX Scene 时出现 NullPointerException 错误。
• CookieStore 不保存未指定 SameSite 属性的 Cookies。
• 在 PDF 查看器内部右键点击时，ShowContextMenuCallback 未被调用。
• 在 Linux 上使用 NVidia GeForce 1650 和 430.64 驱动版本时，离屏渲染无法正常工作。
• 如果存在其他同名方法，则 JavaScript-Java Bridge 功能无法调用被 @JsAccessible 注解标记的 Java 方法。
• 当 Engine 实例在隐身模式下运行时，拼写检查词典未被配置。
• 在 macOS 上的 SWT 中，使用硬件加速渲染模式时，Print Preview（打印预览）对话框中的渲染出现问题。
• 在 macOS 上的 SWT 中，离屏渲染模式下未显示 Print Preview 对话框。
• 在 Windows 和 Linux 上，在硬件加速渲染模式下，右键单击网页上的 Flash 时，默认的 Swing BrowserView 上下文菜单不可见。
• 在 macOS 上，无法将 Browser 调整为小于 300px 的大小。
• EventType.DOUBLE_CLICK 的 DOM 事件监听器从未被调用。
• 在离屏渲染模式下，EnterMouseCallback 和 ExitMouseCallback 未被调用。在 Windows 和 Linux 上的硬件加速渲染模式下，EnterMouseCallback 由于被 Chromium Engine 忽略而无法被调用。
• 在离屏渲染模式下，在 Eclipse 的 Part 切换标签时，SWT BrowserView 组件不可见。
• 在 SWT 中将当前加载的网页打印为 PDF 时，默认保存文件名错误。
• 在禁用 Chromium 流量的情况下，在加载的网页上的输入字段中键入一些文本时，拼写检查器初始化失败。
• 在离屏渲染模式下，自定义 CSS 光标在 Windows 上模糊。
• 在 Windows 的硬件加速渲染模式下，将 JavaFX BrowserView 添加到 SplitPane 或从中移除时，出现黑色闪烁。
• 在 Windows 的离屏渲染模式下，显示/隐藏 BrowserView 时，屏幕会随机出现黑色矩形闪烁。
• 当关闭 Browser 时，注入到 JavaScript 中的 Java 对象上标记有 @JsAccessible 注解的方法会被多调用一次。
• 通过 window.close() JavaScript 函数关闭 Swing BrowserView 弹出实例时，会出现 IndexOutOfBoundsException 错误。
• 加载具有无效 SSL 证书的 HTTPS 网页时，ShowNetErrorPageCallback 回调不会被调用。
• 在离屏渲染模式下，无法将焦点设置到具有不同域的 IFRAME 内的 HTML 输入字段。
• 恢复支持 Firebase Cloud Messaging。
• 在 v7.8 之后重新引入 macOS 和 Windows 上的 Widevine 功能。
• 在离屏渲染模式下，对于不同的鼠标移动事件，MouseEvent.movementX 和 MouseEvent.movementY 属性应该有所不同。
• 在 macOS 上由于与 mach_port 功能相关的多个 JNI 错误导致 JVM 崩溃。

下载 JxBrowser 7.12

请提供您的电子邮箱地址，我们会尽快将下载说明发送给您。

很抱歉，我们无法成功发送消息。请再次检查您的电子邮件地址是否正确无误。

提交

点击提交，即表示您同意 条款与条件.

发送...

请检查您的收件箱。

我们无法发送电子邮件。请使用直接链接下载JxBrowser。

如果您已经是我们的注册客户，您无需任何操作，即可轻松享受此次更新。

如果您希望深入了解并体验我们的产品，您可以申请评估许可证。

获取免费 30 天体验

关注 @JxBrowserTeam ，获取库的更新动态。

订阅我们的 RSS feed ，获取最新版本动态。

订阅以获取有关最新发布的通知。

订阅

请输入正确的电子邮件地址。 订阅 点击订阅即表示您同意我们的条款和条件。

谢谢，您很快将收到一封确认电子邮件。