浏览器自动化操作
浏览器自动化操作使用户能够通过 UI 元素与 Web 应用程序和组件进行交互。 Web UI 元素也称为 Web 元素,是唯一描述操作将要处理的 Web 组件。
要添加新的 UI 元素,请通过部署的浏览器自动化操作或流设计器的 UI 元素窗格选择添加 UI 元素。
所有与 web 相关的 UI 元素都是由一个或多个 CSS 选择器(web 选择器)指定的,这些选择器确定了页面上组件的层次结构。 选择器使用 > 表示法指示每个元素都包含在其左侧的元素中。
虽然在添加 UI 元素时会自动创建 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 |
不适用 |
正常、最大化、最小化 |
一般 |
指定要以正常、最小化还是最大化状态启动浏览器窗口 |
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 选项才能按预期工作。
生成的变量
异常
例外 |
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 |
不适用 |
正常、最大化、最小化 |
一般 |
指定要以正常、最小化还是最大化状态启动浏览器窗口 |
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 |
无法启动 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 |
不适用 |
正常、最大化、最小化 |
一般 |
指定要以正常、最小化还是最大化状态启动浏览器窗口 |
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 |
无法启动 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 |
不适用 |
正常、最大化、最小化 |
一般 |
指定要以正常、最小化还是最大化状态启动浏览器窗口 |
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 |
无法启动 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 |
是 |
文本值 |
确定 |
如果显示弹出对话框,则输入要按的对话框按钮 |
生成的变量
异常
例外 |
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 元素 |
No |
UI 元素 |
|
选择网页上要将鼠标悬停在其上的 UI 元素 |
移动鼠标以进行悬停 |
No |
布尔值 |
错误 |
指定是否在元素上物理移动鼠标光标以悬停 UI 元素。 如果模拟悬停不对元素执行有意操作,则需要物理悬停。 由于此选项需要聚焦浏览器窗口,因此它会自动将其调入前台。 |
生成的变量
此操作不会生成任何变量。
异常
例外 |
说明 |
无法将鼠标悬停在元素上方 |
指示在将鼠标悬停在指定的元素上时出现问题 |
关闭 Web 浏览器
关闭 Web 浏览器窗口。
参数 |
可选 |
接受 |
默认值 |
说明 |
Web browser instance |
否 |
Web 浏览器实例 |
|
输入或选择包含要关闭的 Web 浏览器实例的变量 |
生成的变量
此操作不会生成任何变量。
异常
例外 |
说明 |
无法关闭 Web 浏览器 |
指示关闭 Web 浏览器时出现问题 |