打开浏览器

UiPath.Core.Activities.OpenBrowser

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

备注：

当浏览器不直接接受内部 URL 作为命令行参数时，无法使用此活动打开内部 URL。您无法打开 Chrome ( chrome:// ) 或 Edge ( edge:// ) 的内部页面。但您可以使用 Firefox ( about: ) 打开内部页面。

在活动正文中

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

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

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

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

属性

常见

• ContinueOnError - Specifies if the automation should continue even when the activity throws an error. This field only supports Boolean values (True, False). The default value is False. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.

  备注：

  如果“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。

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

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