打开浏览器

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。使用自定义浏览器类型时，不支持隐藏属性。有关配置自定义浏览器的更多信息，请查看自定义浏览器部分。

  备注：

  If the BrowserType property is set to Custom, the CommunicationMethod property must be set to WebDriver for the activity to work properly.

• “Url”- 要在指定浏览器中打开的 URL。

其他

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

选项

• AutomaticallyDownloadWebDriver - If selected, automatically downloads from the Internet the required WebDriver executable into the %localappdata%\UiPath\WebdriverExe folder. By default, this check box is cleared.
• CommunicationMethod - Choose the communication method. The following are available: Native, WebDriver.
• “隐藏”- 打开隐藏的浏览器。
• NewSession - Starts a new session of the selected browser. This option is specific to Internet Explorer.
• “私有”- 打开一个私人/匿名会话。
• UserDataFolderMode - The UserDataFolderMode you want to set. It is used to start the browser with a specific user data folder.
  • UserDataFolderMode.Automatic - Picture In Picture mode uses a different folder than the default mode, automatically generated if UserDataFolderPath is not set.
  • UserDataFolderMode.DefaultFolder - Uses the default browser folder, no matter if it runs in the main or PIP session.
  • UserDataFolderMode.CustomFolder - Uses the folder specified in UserDataFolderPath or an auto generated path if UserDataFolderPath is not set.
• UserDataFolderPath - The user data folder that the browser will use. Defaults to %LocalAppData%\UiPath\PIP Browser Profiles\BrowserType if not set.

有关用户数据文件夹模式和用户数据文件夹路径的更多详细信息，请参见此处。

输出

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

自定义浏览器

自定义浏览器不同于广泛使用的浏览器（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。

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

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