打开浏览器

UiPath.Core.Activities.OpenBrowser

此容器用于在指定 URL 中打开浏览器，并在其中执行多项活动。

注意：

当浏览器不直接接受内部 URL 作为命令行参数时，无法使用此活动打开内部 URL。

您无法打开 Chrome (chrome://) 或 Edge (edge://) 内部页面。但您可以打开 Firefox (about:) 内部页面。

在活动正文中

在设计器面板中，活动显示为容器，您可以在其中添加活动以与指定的浏览器交互。

URL 字段允许您提供浏览器打开的链接。

单击 URL 字段旁边的按钮将使用当前配置设置打开一个新的浏览器会话。 这样就可以在保留现有配置的同时使用新的浏览器用户数据集。 当您在 画中画中自动化浏览器时，它尤其有用。

还存在一个序列，用于添加在浏览器上执行的操作。

属性

常见

• “出错时继续”- 指定在活动引发错误时是否应继续自动化操作。该字段仅支持“布尔值”(True 和 False)。默认值为 False。因此，如果该字段为空且活动引发错误，系统将停止执行项目。如果该值设为“True”，则无论出现何种错误，系统都将继续执行项目。

  注意：如果 Try Catch 异常处理中包含该活动且出错时继续属性的值为 True，则系统在执行项目时不会捕获任何错误。
• “显示名称”- 活动的显示名称。

输入

• 浏览器类型- 使用下拉按钮选择要使用的浏览器类型。可用的选项如下：IE、Firefox、Chrome、Edge、自定义。“自定义”类型适用于其他基于 Chromium 的浏览器，例如 JxBrowser。使用自定义浏览器类型时，不支持隐藏属性。有关配置自定义浏览器的更多信息，请查看自定义浏览器部分。

  注意： 如果“ 浏览 器类型”属性设置为 “自定义”，则必须将“ 通信 方法”属性设置为“ WebDriver ”，活动才能正常运行。
• Url- 要在指定浏览器中打开的 URL。

其他

• “私有”- 选中后将不再以“Verbose”级别记录变量和参数的值。

选项

• 自动 下载 WebDriver - 如果选中，则自动从 Internet 将所需的 WebDriver 可执行文件下载到 %localappdata%\UiPath\WebdriverExe 文件夹中。 默认情况下，清除此复选框。
• “通信 方法” - 选择通信方法。 可用的选项如下：“原生”、“WebDriver”。
• 隐藏- 打开隐藏的浏览器。
• 新会话- 为所选浏览器启动新会话。此选项特定于 Internet Explorer。
• 私有- 打开一个私人/匿名会话。

• 用户数据文件夹模式 - 要设置的用户数据文件夹模式。该模式用于通过特定用户数据文件夹启动浏览器。

  • “用户数据文件夹模式自动”- 画中画模式使用与默认模式下不同的文件夹。如果未设置用户数据文件夹路径，则系统会自动生成该路径。
  • “UserDataFolderMode.DefaultFolder”- 使用默认浏览器文件夹，无论其在主会话还是 PIP 会话中运行。
  • “UserDataFolderMode.CustomFolder”- 使用用户数据文件夹路径中指定的文件夹。如果未设置用户数据文件夹路径，则使用自动生成的路径。
• “用户数据文件夹路径 ” - 浏览器将使用的用户数据文件夹。 如果未设置，则默认为 %LocalAppData%\UiPath\PIP Browser Profiles\BrowserType 。

有关 UserDataFolderMode 和 UserDataFolderPath 的更多详细信息，请参见 此处。

输出

• 用户界面浏览器- 以用户界面浏览器对象呈现的活动结果。存储所有与浏览器会话有关的信息。仅支持浏览器变量。

自定义浏览器

自定义浏览器不同于广泛使用的浏览器（Chrome、Chromium Edge、Firefox、IE 等），它基于 Chromium 项目构建。我们支持两类这样的浏览器：使用 Chromium 嵌入式框架 (CEF) 构建的浏览器和使用 JxBrowser 框架的浏览器。

可以使用 WebDriver 通信方法自动化这些自定义浏览器。

为此，它们必须支持 --remote-debugging-port 命令行参数，就像所有基于 Chromium 的浏览器一样。

配置自定义浏览器

您要使用的自定义浏览器必须具有适用于在 PATH 中构建自定义浏览器的 Chromium 版本的 chromedriver.exe 可执行文件。

在注册表项 HKEY_CURRENT_USER 或 HKEY_LOCAL_MACHINE 中，在 Software\UiPath\UiPath Platform\CustomBrowser 下，Command 值必须包含自定义浏览器可执行文件的路径，或用于启动该自定义浏览器的命令。

（可选）如果您只需要运行自定义浏览器的单个实例，并且出于安全原因，想要指定与自定义浏览器进行通信的远程调试端口，则必须使用名为 RemoteDebuggingPort 的注册表值将添加到指定 Command 的同一注册表项中。

此类自定义浏览器页面中的选取器具有浏览器应用程序名称 custom_browser。

使用“打开浏览器”活动的示例

您 可以在此查看包含多个活动的示例，了解如何使用 打开浏览器 活动。