已知问题和限制

对于可见模式和无头模式，使用 Chromium 自动化自动化浏览器时要记住的行为和约束。

本页列出了使用 Chromium 自动化自动化浏览器时的已知问题和限制。有些适用于两种模式，而其他则特定于无头自动化。

常规

这些限制适用于Chromium 自动化和Chromium 自动化 headless ：

仅限基于 Chromium 的浏览器

Chromium 自动化支持 Chrome、Edge 和其他基于 Chromium 的浏览器。为 Firefox 或 Safari 选择该自动化方法会返回错误，并且不会自动回退到另一种自动化方法。对于这些浏览器，请使用浏览器扩展程序或WebDriver 协议。

对开发者工具可用性策略的依赖项

“开发者工具可用性”组策略可以阻止此浏览器自动化方法。当开发者工具可用性组策略设置为2 （禁止使用开发者工具）时，Chromium 自动化无法启动浏览器。在强制执行此策略的环境中，使用浏览器扩展程序或 WebDriver 协议。

专用浏览器会话

系统始终会创建新的浏览器会话。Chromium 自动化将使用自己的 user-data-dir 打开一个新的隔离浏览器会话，并且无法附加到已在用户桌面上打开的浏览器。这使其不适合有人值守的自动化，但不限于无人值守的自动化。

默认用户数据目录限制

Chromium 自动化不能与默认的 user-data-dir 一起使用。由于会话是隔离的，因此用户默认浏览器配置文件中的浏览器扩展程序、已保存的密码和会话 Cookie 不可用。无需额外配置即可支持匿名模式。

网站兼容性限制

Chromium 自动化无法用于某些公共网站（与 WebDriver 的限制类似）。

通过 Chromium Automation 实现无头自动化

这些限制适用于Chromium Automation headless ，其中浏览器运行时不显示可见窗口。

1. 不支持硬件事件。如果没有可见窗口，则无法执行依赖于硬件事件的操作。对单击和键入等活动使用模拟单击、模拟键入和模拟悬停输入方法，而不是默认的硬件事件输入。

2. 不支持基于图像的活动。依赖呈现屏幕的活动（例如“单击图像”和“查找图像” ）在无头模式下不可用。

3. 不支持依赖于窗口的操作。不支持依赖可见窗口或操作系统级别呈现的操作，例如原生拖放和硬件鼠标模拟。

4. 事件监控受到限制。无头模式不支持依赖硬件事件的触发器。

5. 使用一致大小的浏览器窗口。由于布局可能取决于视口大小，因此在构建自动化项目时请使用默认浏览器窗口大小，以使选取器和元素位置保持一致。