附加浏览器

UiPath.Core.Activities.BrowserScope

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

属性

输入

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

选项

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

输出

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

常见

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

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

  注意：如果 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。