浏览器自动化操作

浏览器自动化操作使用户能够通过 UI 元素与 Web 应用程序和组件进行交互。 Web UI 元素也称为 Web 元素，是唯一描述操作将要处理的 Web 组件。

若要执行 Web 自动化，首先需要创建新的浏览器实例。 您可以使用“启动浏览器”操作来实现这一点，它支持 Microsoft Edge、Google Chrome、Mozilla Firefox 和 Internet Explorer。 通过“启动浏览器”操作，还可以指定该网页应在本地桌面还是虚拟桌面环境中启动。

备注

若要在虚拟桌面上启动浏览器，请首先捕获该桌面中的至少一个 UI 元素。 此元素需要可用于流程的 UI 元素存储库。

要添加新的 UI 元素，请通过部署的浏览器自动化操作或流设计器的 UI 元素窗格选择添加 UI 元素。

所有与 web 相关的 UI 元素都是由一个或多个 CSS 选择器（web 选择器）指定的，这些选择器确定了页面上组件的层次结构。 选择器使用 > 表示法指示每个元素都包含在其左侧的元素中。

虽然在添加 UI 元素时会自动创建 web 选择器，但某些特定场景需要手动创建的选择器。 当需要定制的 web 选择器时，您可以通过编辑现有的选择器或从头构建一个来创建自己的选择器。

要开发更多动态 Web 流，请将等于运算符替换为其他运算符或正则表达式。 此外，如果 web 选择器的属性值取决于先前操作的结果，请使用变量而不是硬编码值。

备注

要了解有关开发 web 流和为 web 元素创建自定义 web 选择器的更多信息，请访问自动化 Web 流和构建自定义选择器。

从网页中提取数据

从网页的特定部分中提取数据(单值、列表、行或表形式的数据)。

有关如何使用此操作的详细信息，请转到 Web 数据提取。

输入参数

参数	可选	接受	默认值	说明
Web browser instance	否	Web 浏览器实例		输入或选择包含要使用的 Web 浏览器实例的变量
UI 元素	否	UI 元素		选择网页上要从中提取数据的 UI 元素
提取参数	否	数据表		提取数据时要使用的参数。 根据提取模式的不同，此参数接受不同的数据。
Max web pages to process	否	数值		要处理的网页的最大数量
为下一页发送实际单击	不可用	布尔值	错误	指定在单击之前是否将鼠标光标物理移动到页面上。 如果模拟单击页面不对元素执行有意操作，则需要物理单击。 由于此选项需要聚焦浏览器窗口，因此它会自动将其调入前台。
页面 CSS 选择器	否	文本值		页面 CSS 选择器
Extraction mode	不可用	未定义、单值、手动选择的值、列表、表、整个 HTML 表	单值	指定要从网页中提取的内容
Use paging	不适用	布尔值	假	指定是否使用分页
Get all web pages	不适用	布尔值	False	指定是否获取所有网页
提取时处理数据	不适用	布尔值	False	指定是否处理提取的数据以完全按照网页中显示的方式呈现它们。 提取数据的处理包括显示嵌套在 iframe 中的信息以及通过隐藏或可见元素进行筛选。 对于较大的数据集，不建议启用此选项，因为它会增加提取时间。
超时	是	数值	60	设置您希望在操作失败之前等待提取操作完成的时间(以秒为单位)
存储数据模式	不适用	变量、Excel 电子表格	变量	指定要将所提取的数据存储到变量中还是 Excel 电子表格中

生成的变量

参数	类型​​	说明
ExcelInstance	Excel 实例	具有所提取数据的 Excel 实例。 使用此实例通过专门的 Excel 操作来操作电子表格（或保存并关闭它）。
DataFromWebPage	数据表	以单个值、列表、数据行或数据表形式提取的数据。

异常

例外	Description
无法提取数据	指示提取数据时出现问题
无法启动 Excel 实例	指示启动 Excel 实例时出现问题
无法向 Excel 中写入值	指示向 Excel 中写入值时出现问题

获取网页的详细信息

获取网页的属性，例如其标题或源文本。

输入参数

参数	可选	接受	默认值	说明
Web browser instance	否	Web 浏览器实例		输入或选择包含要使用的 Web 浏览器实例的变量
Get	不适用	网页说明、网页 meta 关键字、网页标题、网页文本、网页源、Web 浏览器的当前 URL 地址	网页说明	选择要从网页中检索的信息

生成的变量

参数	类型​​	说明
WebPageProperty	文本值	从网页检索到的详细信息

异常

例外	描述
无法获取网页的详细信息	指示获取指定网页的详细信息时出现问题

获取网页上的元素的详细信息

获取网页上的元素的属性值。

输入参数

参数	可选	接受	默认值	说明
Web browser instance	否	Web 浏览器实例		输入或选择包含要使用的 Web 浏览器实例的变量
UI 元素	否	UI 元素		选择网页上要从中获取详细信息的 UI 元素
属性名称	否	文本值	自己的文本	输入或选择要检索其值的属性

生成的变量

参数	类型​​	说明
AttributeValue	文本值	Web 元素的属性值

异常

例外	描述
无法检索网页上的 UI 元素的属性	指示检索网页元素的属性时出现问题

获取网页的屏幕截图

获取当前显示在浏览器中的网页(或网页元素)的屏幕截图，然后将该图像保存到文件或剪贴板中。

输入参数

参数	可选	接受	默认值	说明
Web browser instance	否	Web 浏览器实例		输入或选择包含要使用的 Web 浏览器实例的变量
Capture	不适用	整个网页、特定元素	整个网页	指定要捕获整个网页还是仅捕获网页的特定元素
UI 元素	否	UI 元素		选择网页上要捕获的 UI 元素
保存模式	不适用	剪贴板、文件	剪贴板	指定要将图像保存到文件中还是将其存储到剪贴板中
Image file	否	文件		设置用于保存图像捕获的文件的完整路径
File format	不适用	BMP、EMF、EXIF、GIF、JPG、PNG、TIFF、WMF	BMP	选择图像文件的格式

生成的变量

此操作不会生成任何变量。

异常

例外	说明
未找到具有指定的 CSS 选择器的元素	指示未找到具有指定的 CSS 选择器的网页元素
无法保存文件	指示保存指定的文件时出现问题
无法保存到剪贴板中	指示保存到剪贴板时出现问题
无法获取屏幕截图	指示获取屏幕截图时出现问题

聚焦网页上的文本字段

对网页的输入元素设置焦点，并将其滚动到视图中。

输入参数

参数	可选	接受	默认值	说明
Web browser instance	否	Web 浏览器实例		输入或选择包含要使用的 Web 浏览器实例的变量
UI 元素	否	UI 元素		选择网页上要聚焦的 UI 元素
等待页面加载	不适用	布尔值	真	指定在继续之前是否等待新网页完全加载
网页加载的超时时间	否	数值	60	设置在页面加载操作引发错误之前加载页面的时间(以秒为单位)
如果显示弹出对话框	不适用	立即关闭、按下按钮、不执行任何操作	不执行任何操作	指定显示弹出对话框时要执行的操作
Dialog button to press	是	文本值	确定	如果显示弹出对话框，则输入要按的对话框按钮

生成的变量

此操作不会生成任何变量。

异常

例外	说明
未找到具有指定的 CSS 选择器的元素	指示未找到具有指定的 CSS 选择器的网页元素
无法对网页文本字段设置输入焦点	指示在对指定的网页文本字段设置输入焦点时出现问题

填充网页上的文本字段

使用指定的文本填充网页中的文本字段。

输入参数

参数	可选	接受	默认值	说明
Web browser instance	否	Web 浏览器实例		输入或选择包含要使用的 Web 浏览器实例的变量
UI 元素	否	UI 元素		选择要填充的文本字段
文本	否	直接加密的输入或文本值		输入要在文本字段中填写的文本
如果字段不为空	是	替换文本、追加文本	替换文本	指定是替换现有内容还是追加。
使用物理击键填充文本	不可用	布尔值	错误	将文本填充到 UI 文本字段元素时使用物理击键进行模拟。 对于模拟文本填充未对元素执行有意操作的情况，物理击键是必需的。 由于此选项需要聚焦浏览器窗口，因此它会自动将其调入前台。
Emulate typing	不可用	布尔值	TRUE	指定要通过设置文本框的值来填写文本字段，还是通过逐个发送字符来模拟用户键入。 后一方法较慢，但在某些复杂的网页中需要采用这一方法。
Unfocus text box after filling it	不适用	布尔值	假	选择在此操作使用指定的文本填充文本框之后是否取消聚焦该文本框。 如果抓取自动完成列表，此参数应设置为 False。
等待页面加载	不可用	布尔值	TRUE	指定在填充文本字段后是否等待新网页完全加载
网页加载的超时时间	否	数值	60	设置在页面加载操作引发错误之前加载页面的时间(以秒为单位)
如果显示弹出对话框	不适用	立即关闭、按下按钮、不执行任何操作	不执行任何操作	指定在填充文本字段后显示弹出对话框时要执行的操作
Dialog button to press	是	文本值	确定	如果显示弹出对话框，则输入要按的对话框按钮

生成的变量

此操作不会生成任何变量。

异常

例外	说明
未找到具有指定的 CSS 选择器的元素	指示未找到具有指定的 CSS 选择器的网页元素
无法写入文本字段	指示写入指定的文本字段时出现问题

设置网页上的复选框状态

选中或取消选中 Web 窗体中的复选框。

输入参数

参数	可选	接受	默认值	说明
Web browser instance	否	Web 浏览器实例		输入或选择包含要使用的 Web 浏览器实例的变量
UI 元素	否	UI 元素		选择要设置状态的复选框
复选框状态	不适用	已选中、已取消选中	已选中	选择复选框状态
Wait for page to load	不适用	布尔值	真	指定在设置复选框状态后是否等待新网页完全加载
网页加载的超时时间	否	数值	60	设置在页面加载操作引发错误之前加载页面的时间(以秒为单位)
如果显示弹出对话框	不适用	立即关闭、按下按钮、不执行任何操作	不执行任何操作	指定在设置复选框状态后显示弹出对话框时要执行的操作
Dialog button to press	是	文本值	确定	如果显示弹出对话框，则输入要按的对话框按钮

生成的变量

此操作不会生成任何变量。

异常

例外	说明
未找到具有指定的 CSS 选择器的元素	指示未找到具有指定的 CSS 选择器的网页元素
无法设置复选框的状态	指示设置所指定复选框的状态时出现问题

选择网页上的单选按钮

选择网页上的单选按钮。

输入参数

参数	可选	接受	默认值	说明
Web browser instance	否	Web 浏览器实例		输入或选择包含要使用的 Web 浏览器实例的变量
UI 元素	否	UI 元素		要选择的单选按钮
等待页面加载	不适用	布尔值	真	指定在选择单选按钮后是否等待新网页完全加载
网页加载的超时时间	否	数值	60	设置在页面加载操作引发错误之前加载页面的时间(以秒为单位)
如果显示弹出对话框	不适用	立即关闭、按下按钮、不执行任何操作	不执行任何操作	指定在选择单选按钮后显示弹出对话框时要执行的操作
Dialog button to press	是	文本值	确定	显示弹出对话框时要按的对话框按钮

生成的变量

此操作不会生成任何变量。

异常

例外	说明
未找到具有指定的 CSS 选择器的元素	指示未找到具有指定的 CSS 选择器的网页元素
无法选择单选按钮	指示选择指定的单选按钮时出现问题

设置网页上的下拉列表值

设置或清除 Web 窗体中下拉列表的选定选项。

输入参数

参数	可选	接受	默认值	说明
Web browser instance	否	Web 浏览器实例		输入或选择包含要使用的 Web 浏览器实例的变量
UI 元素	否	UI 元素		选择要设置其值的下拉列表
操作	不适用	清除所有选项、选择选项（按名称）、选择选项（按索引）	清除所有选项	选择要为下拉列表选择值还是清除其选定值
选项名称	否	文本值列表		在下拉列表中输入要选择的选项或选项列表。 只有在使用多选列表时多个选项才有意义。 如果列表是单选，将仅使用指定的列表的第一个选项。
使用正则表达式	不适用	布尔值	False	指定选项是否指定了要解释为正则表达式的值
选项索引	否	数值列表		在下拉列表中输入要选择的索引或索引列表。 只有在使用多选列表时多个选项才有意义。 如果列表是单选，将仅使用指定的列表的第一个选项。
等待页面加载	不适用	布尔值	TRUE	指定在设置下拉列表值后是否等待新网页完全加载
网页加载超时	否	数值	60	设置在页面加载操作引发错误之前加载页面的时间(以秒为单位)
如果显示弹出对话框	不适用	立即关闭、按下按钮、不执行任何操作	不执行任何操作	指定在设置下拉列表值后显示弹出对话框时要执行的操作
Dialog button to press	是	文本值	确定	如果显示弹出对话框，则输入要按的对话框按钮

生成的变量

此操作不会生成任何变量。

异常

例外	说明
未找到具有指定的 CSS 选择器的元素	指示未找到具有指定的 CSS 选择器的网页元素
无法设置选定的选项	指示设置所选下拉列表选项时出现问题

按网页上的按钮

按下网页按钮。

输入参数

参数	可选	接受	默认值	说明
Web browser instance	否	Web 浏览器实例		输入或选择包含要使用的 Web 浏览器实例的变量
UI 元素	否	UI 元素		选择要按的按钮
等待页面加载	不适用	布尔值	真	指定在按下按钮后是否等待新网页完全加载
网页加载的超时时间	否	数值	60	设置在页面加载操作引发错误之前加载页面的时间(以秒为单位)
如果显示弹出对话框	不适用	立即关闭、按下按钮、不执行任何操作	不执行任何操作	指定在按下按钮后显示弹出对话框时要执行的操作
Dialog button to press	是	文本值	确定	如果显示弹出对话框，则输入要按的对话框按钮

生成的变量

此操作不会生成任何变量。

异常

例外	说明
未找到具有指定的 CSS 选择器的元素	指示未找到具有指定的 CSS 选择器的网页元素
无法单击网页按钮	指示单击指定的网页按钮时出现问题

如果网页包含

根据网页中是否存在特定的文本或元素，标记条件操作块的开头。

输入参数

参数	可选	接受	默认值	说明
Web browser instance	否	Web 浏览器实例		输入或选择包含要使用的 Web 浏览器实例的变量
Check if web page	不适用	包含元素、不包含元素、包含文本、不包含文本	包含元素	检查网页中是否存在特定的文本或网页元素
UI 元素	否	UI 元素		选择网页上要选中的 UI 元素
文本	否	文本值		输入网页上要选中的 UI 元素

生成的变量

此操作不会生成任何变量。

异常

例外	说明
无法与浏览器通信	指示浏览器出错

等待网页内容

挂起该流，直至特定的文本或网页元素在网页中出现或消失。

输入参数

参数	可选	接受	默认值	说明
Web browser instance	否	Web 浏览器实例		输入或选择包含要使用的 Web 浏览器实例的变量
Wait for web page to	不适用	包含元素、不包含元素、包含文本、不包含文本	包含元素	指定是否等待特定文本或网页元素在网页中出现或消失
UI 元素	否	UI 元素		选择网页上要选中的 UI 元素
文本	否	文本值		输入网页上要选中的 UI 元素

生成的变量

此操作不会生成任何变量。

异常

例外	说明
等待网页内容失败	指示等待操作失败

启动新 Internet Explorer

启动新实例或者附加到正在运行的 Internet Explorer 实例，以自动执行网站和 Web 应用程序。

输入参数

参数	可选	接受	默认值	说明
Launch mode	不适用	启动自动化浏览器、启动新 Internet Explorer、附加到正在运行的 Internet Explorer	启动自动化浏览器	指定要启动自动化浏览器或新的 Internet Explorer 实例，还是附加到现有的实例
Attach to Internet Explorer tab	不适用	按标题、按 URL、使用前景窗口	按标题	指定要按标题、URL 附加到 Internet Explorer 选项卡，还是附加到正在作为前景窗口运行的 Internet Explorer 活动选项卡
Initial URL	否	文本值		输入在启动 Web 浏览器时要访问的网站的 URL
Tab title	否	文本值		输入要附加到的 Internet Explorer 选项卡的标题(或其一部分)
Tab URL	否	文本值		输入要附加到的 Internet Explorer 选项卡的 URL (或其一部分)
Window state	不适用	正常、最大化、最小化	一般	指定要以正常、最小化还是最大化状态启动浏览器窗口
目标桌面	不可用	本地计算机，当前已连接或至少捕获了一个 UI 元素的任何虚拟桌面	本地计算机	设置浏览器启动的目标桌面的连接字符串
Clear cache	不可用	布尔值	错误	指定在启动 Web 浏览器后是否立即清除其整个缓存
Clear cookies	不适用	布尔值	假	指定在启动 Web 浏览器后是否立即清除其中存储的所有 Cookie
Wait for page to load	不适用	布尔值	真	指定在继续之前是否等待新网页完全加载
网页加载的超时时间	否	数值	60	设置在页面加载操作引发错误之前加载页面的时间(以秒为单位)
如果显示弹出对话框	不适用	立即关闭、按下按钮、不执行任何操作	不执行任何操作	指定在加载初始网页时如果显示弹出对话框要执行的操作
Dialog button to press	是	文本值	确定	如果显示弹出对话框，则输入要按的对话框按钮
Custom user agent string	是	文本值		为运行时 Web 帮助程序指定自定义用户代理字符串。 如果此字段保留为空，则运行时 Web 帮助程序将默认使用计算机上安装的 Internet Explorer 的用户代理字符串。

备注

仅当在 Internet 选项菜单中禁用了在保护模式下运行时，清除缓存和清除 Cookie 选项才能按预期工作。

生成的变量

参数	类型​​	说明
InternetExplorer	Web browser instance	要与浏览器自动化操作一起使用的 Internet Explorer 实例

异常

例外	Description
无法启动 Internet Explorer	指示启动 Internet Explorer 时出现问题
URL 无效	指示所提供的 URL 无效

启动新 Firefox

启动新实例或者附加到正在运行的 Firefox 实例，以自动执行网站和 Web 应用程序。

输入参数

参数	可选	接受	默认值	说明
Launch mode	不适用	启动新实例、附加到正在运行的实例	启动新实例	指定要启动新的 Firefox 实例还是附加到现有的实例
Attach to Firefox tab	不适用	按标题、按 URL、使用前景窗口	按标题	指定要按标题、URL 附加到 Firefox 选项卡，还是附加到正在作为前景窗口运行的 Firefox 活动选项卡
Initial URL	否	文本值		输入在启动 Web 浏览器时要访问的网站的 URL
Tab title	否	文本值		输入要附加到的 Firefox 选项卡的标题(或其一部分)
Tab URL	否	文本值		输入要附加到的 Firefox 选项卡的 URL (或其一部分)
Window state	不适用	正常、最大化、最小化	一般	指定要以正常、最小化还是最大化状态启动浏览器窗口
目标桌面	不可用	本地计算机，当前已连接或至少捕获了一个 UI 元素的任何虚拟桌面	本地计算机	设置浏览器启动的目标桌面的连接字符串
Clear cache	不可用	布尔值	错误	指定在启动 Web 浏览器后是否立即清除其整个缓存
Clear cookies	不适用	布尔值	假	指定在启动 Web 浏览器后是否立即清除其中存储的所有 Cookie
Wait for page to load	不适用	布尔值	真	指定在继续之前是否等待新网页完全加载
网页加载的超时时间	否	数值	60	设置在页面加载操作引发错误之前加载页面的时间(以秒为单位)
如果显示弹出对话框	不适用	立即关闭、按下按钮、不执行任何操作	不执行任何操作	指定在加载初始网页时如果显示弹出对话框要执行的操作
Dialog button to press	是	文本值	确定	如果显示弹出对话框，则输入要按的对话框按钮
Timeout	否	数值	60	设置您希望在操作失败之前等待浏览器启动的时间(以秒为单位)
用户数据文件夹	不可用	Picture-in-Picture 默认、浏览器默认、自定义	Picture-in-Picture 默认值	指定流以 Picture-in-Picture 模式运行时浏览器使用的用户数据文件夹。 如果选择了浏览器默认设置，则不能同时在桌面和 Picture-in-Picture 中打开浏览器。 了解更多
用户数据文件夹路径	否	文件夹		指定流以 Picture-in-Picture 模式运行时浏览器使用的用户数据文件夹的路径。 了解更多

生成的变量

参数	类型​​	Description
Browser	Web browser instance	要与浏览器自动化操作一起使用的 Firefox 实例

异常

例外	Description
无法启动 Firefox	指示启动 Firefox 时出现问题
URL 无效	指示所提供的 URL 无效

启动新 Chrome

启动新实例或者附加到正在运行的 Chrome 实例，以自动执行网站和 Web 应用程序。

输入参数

参数	可选	接受	默认值	说明
Launch mode	不适用	启动新实例、附加到正在运行的实例	启动新实例	指定要启动新的 Chrome 实例还是附加到现有的实例
Attach to Chrome tab	不适用	按标题、按 URL、使用前景窗口	按标题	指定要按标题、URL 附加到 Chrome 选项卡，还是附加到正在作为前景窗口运行的 Chrome 活动选项卡
Initial URL	否	文本值		输入在启动 Web 浏览器时要访问的网站的 URL
Tab title	否	文本值		输入要附加到的 Chrome 选项卡的标题(或其一部分)
Tab URL	否	文本值		输入要附加到的 Chrome 选项卡的 URL (或其一部分)
Window state	不适用	正常、最大化、最小化	一般	指定要以正常、最小化还是最大化状态启动浏览器窗口
目标桌面	不可用	本地计算机，当前已连接或至少捕获了一个 UI 元素的任何虚拟桌面	本地计算机	设置浏览器启动的目标桌面的连接字符串
Clear cache	不可用	布尔值	错误	指定在启动 Web 浏览器后是否立即清除其整个缓存
Clear cookies	不适用	布尔值	假	指定在启动 Web 浏览器后是否立即清除其中存储的所有 Cookie
Wait for page to load	不适用	布尔值	真	指定在继续之前是否等待新网页完全加载
网页加载的超时时间	否	数值	60	设置在页面加载操作引发错误之前加载页面的时间(以秒为单位)
如果显示弹出对话框	不适用	立即关闭、按下按钮、不执行任何操作	不执行任何操作	指定在加载初始网页时如果显示弹出对话框要执行的操作
Dialog button to press	是	文本值	确定	如果显示弹出对话框，则输入要按的对话框按钮
Timeout	否	数值	60	设置您希望在操作失败之前等待浏览器打开的时间（以秒为单位）
用户数据文件夹	不可用	Picture-in-Picture 默认、浏览器默认、自定义	Picture-in-Picture 默认值	指定流以 Picture-in-Picture 模式运行时浏览器使用的用户数据文件夹。 如果选择了浏览器默认设置，则不能同时在桌面和 Picture-in-Picture 中打开浏览器。 了解更多
用户数据文件夹路径	否	文件夹		指定流以 Picture-in-Picture 模式运行时浏览器使用的用户数据文件夹的路径。 了解更多

生成的变量

参数	类型​​	Description
Browser	Web browser instance	要与浏览器自动化操作一起使用的 Chrome 实例

异常

例外	Description
无法启动 Chrome	指示启动 Chrome 时出现问题
URL 无效	指示所提供的 URL 无效

启动新 Microsoft Edge

启动新实例或者附加到正在运行的 Microsoft Edge 实例，以自动执行网站和 Web 应用程序。

输入参数

参数	可选	接受	默认值	说明
Launch mode	不适用	启动新实例、附加到正在运行的实例	启动新实例	指定要启动新的 Microsoft Edge 实例还是附加到现有的实例
Attach to Microsoft Edge tab	不适用	按标题、按 URL、使用前景窗口	按标题	指定要按标题、URL 附加到 Microsoft Edge 选项卡，还是附加到正在作为前景窗口运行的 Microsoft Edge 活动选项卡
Initial URL	否	文本值		输入在启动 Web 浏览器时要访问的网站的 URL
Tab title	否	文本值		输入要附加到的 Microsoft Edge 选项卡的标题(或其一部分)
Tab URL	否	文本值		输入要附加到的 Microsoft Edge 选项卡的 URL (或其一部分)
Window state	不适用	正常、最大化、最小化	一般	指定要以正常、最小化还是最大化状态启动浏览器窗口
目标桌面	不可用	本地计算机，当前已连接或至少捕获了一个 UI 元素的任何虚拟桌面	本地计算机	设置浏览器启动的目标桌面的连接字符串
Clear cache	不可用	布尔值	错误	指定在启动 Web 浏览器后是否立即清除其整个缓存
Clear cookies	不适用	布尔值	假	指定在启动 Web 浏览器后是否立即清除其中存储的所有 Cookie
Wait for page to load	不适用	布尔值	真	指定在继续之前是否等待新网页完全加载
网页加载的超时时间	否	数值	60	设置在页面加载操作引发错误之前加载页面的时间(以秒为单位)
如果显示弹出对话框	不适用	立即关闭、按下按钮、不执行任何操作	不执行任何操作	指定在加载初始网页时如果显示弹出对话框要执行的操作
Dialog button to press	是	文本值	确定	如果显示弹出对话框，则输入要按的对话框按钮
Timeout	否	数值	60	设置您希望在操作失败之前等待浏览器启动的时间(以秒为单位)
用户数据文件夹	不可用	Picture-in-Picture 默认、浏览器默认、自定义	Picture-in-Picture 默认值	指定流以 Picture-in-Picture 模式运行时浏览器使用的用户数据文件夹。 如果选择了浏览器默认设置，则不能同时在桌面和 Picture-in-Picture 中打开浏览器。 了解更多
用户数据文件夹路径	否	文件夹		指定流以 Picture-in-Picture 模式运行时浏览器使用的用户数据文件夹的路径。 了解更多

生成的变量

参数	类型​​	Description
Browser	Web browser instance	要与浏览器自动化操作一起使用的 Microsoft Edge 实例

异常

例外	Description
无法启动 Microsoft Edge	指示启动 Microsoft Edge 时出现问题
URL 无效	指示所提供的 URL 无效

创建一个新选项卡

创建一个新的选项卡，并导航到给定的 URL（在 Microsoft Edge、Chrome 和 Firefox 中受支持）。

输入参数

参数	可选	接受	默认值	说明
Web browser instance	否	Web 浏览器实例		输入或选择包含要使用的 Web 浏览器实例的变量
URL to navigate to	否	文本值		输入要导航到的 URL 或包含该 URL 的变量
Wait for page to load	不适用	布尔值	真	指定在继续之前是否等待新网页完全加载
网页加载的超时时间	否	数值	60	设置在页面加载操作引发错误之前加载页面的时间(以秒为单位)
如果显示弹出对话框	不适用	立即关闭、按下按钮、不执行任何操作	不执行任何操作	指定在加载网页时如果显示弹出对话框要执行的操作
Dialog button to press	是	文本值	确定	如果显示弹出对话框，则输入要按的对话框按钮

生成的变量

参数	类型​​	说明
NewBrowser	Web browser instance	要与浏览器自动化操作一起使用的新 Web 浏览器实例

异常

例外	Description
URL 无效	指示所提供的 URL 无效
无法创建新选项卡	指示创建新选项卡时出现问题

转到网页

将 Web 浏览器导航到新页面。

输入参数

参数	可选	接受	默认值	说明
Web browser instance	否	Web 浏览器实例		输入或选择包含要使用的 Web 浏览器实例的变量
Navigate	不适用	目标 URL、后退、前进、重新加载网页	目标 URL	指定要导航到的位置
URL	否	文本值		输入要导航到的 URL
Wait for page to load	不适用	布尔值	真	指定在继续之前是否等待网页完全加载
网页加载的超时时间	否	数值	60	设置在页面加载操作引发错误之前加载页面的时间(以秒为单位)
如果显示弹出对话框	不适用	立即关闭、按下按钮、不执行任何操作	不执行任何操作	指定在加载网页时如果显示弹出对话框要执行的操作
Dialog button to press	是	文本值	确定	如果显示弹出对话框，则输入要按的对话框按钮

生成的变量

此操作不会生成任何变量。

异常

例外	说明
无法导航到网页	指示导航到指定的网页时出现问题
URL 无效	指示所提供的 URL 无效

单击网页上的链接

单击网页的链接或任何其他元素。

输入参数

参数	可选	接受	默认值	说明
Web browser instance	否	Web 浏览器实例		输入或选择包含要使用的 Web 浏览器实例的变量
UI 元素	否	UI 元素		选择网页上要单击的 UI 元素
点击类型	不适用	左键单击、右键单击、双击、按下左键、上弹左键、按下右键、上弹右键、中键单击	左键单击	要执行的单击类型
发送物理单击	不适用	布尔值	False	指定在单击之前是否将鼠标光标物理移动到元素上。 如果模拟单击不对元素执行有意操作，则需要物理单击。 由于此选项需要聚焦浏览器窗口，因此它会自动将其调入前台。
等待页面加载	不可用	布尔值	TRUE	指定在单击链接后是否等待新网页完全加载
网页加载的超时时间	否	数值	60	设置在页面加载操作引发错误之前加载页面的时间(以秒为单位)
如果显示弹出对话框	不适用	立即关闭、按下按钮、不执行任何操作	不执行任何操作	指定在单击链接后显示弹出对话框时要执行的操作
Dialog button to press	是	文本值	确定	如果显示弹出对话框，则输入要按的对话框按钮

生成的变量

此操作不会生成任何变量。

异常

例外	说明
未找到具有指定的 CSS 选择器的元素	指示未找到具有指定的 CSS 选择器的网页元素
无法单击 UI 元素	指示单击指定的元素时出现问题

单击网页上的下载链接

单击网页中会导致下载文件的链接。

输入参数

参数	可选	接受	默认值	说明
Web browser instance	否	Web 浏览器实例		输入或选择包含要使用的 Web 浏览器实例的变量
UI 元素	否	UI 元素		选择网页上要单击的 UI 元素
目标文件夹	否	文件夹		输入或选择文件夹的完整路径或包含文件夹的变量，作为保存下载文件的目标位置

生成的变量

参数	类型​​	说明
DownloadedFile	文件	磁盘上用于保存下载内容的文件。 此值是一个文件路径，由上面指定的下载文件夹加上 Web 服务器提供的文件名组成。

异常

例外	描述
无法下载文件	指示下载指定的文件时出现问题
未找到具有指定的 CSS 选择器的元素	指示未找到具有指定的 CSS 选择器的网页元素
无法单击 UI 元素	指示单击指定的元素时出现问题
无法保存文件	指示保存指定的文件时出现问题

在网页上运行 JavaScript 函数

在网页上运行 JavaScript 函数并获取返回的结果。

备注

迁移到 Manifest V3 浏览器扩展会影响此操作。 要查找有关 Manifest V3 的更多信息以及它如何影响在网页上运行 JavaScript 函数操作，请转到迁移到 Manifest V3。

输入参数

参数	可选	接受	默认值	说明
Web browser instance	否	Web 浏览器实例		输入或选择包含要使用的 Web 浏览器实例的变量
JavaScript function	是	文本值	function ExecuteScript() { /*your code here, return something (optionally); */ }	在网页上输入要运行的 JavaScript 函数

生成的变量

参数	类型​​	说明
结果	文本值	运行 JavaScript 函数的结果

异常

例外	说明
无法运行 JavaScript	指示运行 JavaScript 时出现问题

将鼠标悬停在网页的元素上

将鼠标悬停在网页的元素上。

输入参数

参数	可选	接受	默认值	说明
Web browser instance	否	Web 浏览器实例		输入或选择包含要使用的 Web 浏览器实例的变量
UI 元素	否	UI 元素		选择网页上要将鼠标悬停在其上的 UI 元素
移动鼠标以进行悬停	否	布尔值	错误	指定是否在元素上物理移动鼠标光标以悬停 UI 元素。 如果模拟悬停不对元素执行有意操作，则需要物理悬停。 由于此选项需要聚焦浏览器窗口，因此它会自动将其调入前台。

生成的变量

此操作不会生成任何变量。

异常

例外	说明
无法将鼠标悬停在元素上方	指示在将鼠标悬停在指定的元素上时出现问题

关闭 Web 浏览器

关闭 Web 浏览器窗口。

输入参数

参数	可选	接受	默认值	说明
Web browser instance	否	Web 浏览器实例		输入或选择包含要关闭的 Web 浏览器实例的变量

生成的变量

此操作不会生成任何变量。

异常

例外	说明
无法关闭 Web 浏览器	指示关闭 Web 浏览器时出现问题