附加浏览器

UiPath.Core.Activities.BrowserScope

此容器用于附加到已打开的浏览器，并在其中执行多项操作。使用网页录制器时，也会自动生成该活动。

属性

输入

• “选取器”- 此为“文本”属性，用于在执行活动时查找特定用户界面元素。它实际上是 XML 片段，用于指定要查找的图形用户界面元素及其一些父元素的属性。如果同时配置了此属性和浏览器属性，则在设计时使用选取器属性，并在运行时使用浏览器属性。
• “浏览器类型” - 选择要使用的浏览器类型。可用的选项如下：IE、Firefox、Chrome、Edge、自定义。“自定义”类型适用于其他基于 Chromium 的浏览器，例如 JxBrowser。使用“自定义”浏览器类型时，不支持“隐藏”属性。有关配置自定义浏览器的更多信息，请查看自定义浏览器部分。
• “浏览器”- 要附加到的现有浏览器变量。如果同时配置了此属性和选取器属性，则在设计时使用选取器属性，并在运行时使用浏览器属性。
• “超时(毫秒)”- 指定最长等待时间（以毫秒为单位），如果超出该时间后活动并未运行，系统便会抛出错误。默认值为 30000 毫秒（30 秒）。

选项

• “搜索范围”- 此为应用程序窗口，可在其中搜索由“选取器”属性定义的用户界面元素。

输出

• 用户界面浏览器- 活动返回的“浏览器”变量。为避免再次指定浏览器的同一实例，并确保正在自动化的浏览器实例不会更改，您可以在“附加浏览器”或“使用应用程序/浏览器用于”活动中重用此输出变量作为输入变量示例，您甚至可以在另一个工作流中将其重用为参数。

常见

• “显示名称”- 活动的显示名称。

• 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”，则系统在执行项目时不会捕获任何错误。

其他

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

自定义浏览器

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