通用浏览器

通用浏览器自动化是通过selenium驱动的方式对浏览器内网页元素进行自动化控制，操作时需要安装浏览器对应版本的驱动，支持谷歌浏览器、IE浏览器、火狐浏览器。

网页内元素都是元素xpath来进行定位（注意跟桌面软件元素的区别），通过捕获元素按钮捕获后，都会对网页元素生成一个元素xpath，如下图：

打开浏览器

打开浏览器

输入参数：

参数名	类型	是否必须	说明
类型	string	是	浏览器类型
网址	string	是	访问的网址，必须包含协议头http://或https://
标识	string	否	浏览器标识，打开多个浏览器时需要标记，方便切换

输出参数：

变量名	类型	说明
自定义	string	浏览器标识，如果标识为空则自动生成

关闭指定浏览器

根据浏览器标识关闭浏览器

输入参数：

参数名	类型	是否必须	说明
浏览器标识	string	是	浏览器标识

输出参数：

无

关闭当前浏览器

关闭当前操作的浏览器

输入参数：

无

输出参数：

无

关闭所有浏览器

关闭所有打开的浏览器

输入参数：

无

输出参数：

无

切换浏览器

根据浏览器标识切换浏览器

输入参数：

参数名	类型	是否必须	说明
浏览器标识	string	是	浏览器标识

输出参数：

无

跳转网页

在当前tab页签跳转到指定网址

输入参数：

参数名	类型	是否必须	说明
跳转URL	string	是	网页URL，必须包含协议头http://或https://

输出参数：

无

执行JS代码

在当前页面执行JS代码

输入参数：

参数名	类型	是否必须	说明
JS代码	string	是	JS代码

输出参数：

变量名	类型	说明
自定义	string	执行返回结果

提示

如果执行js代码以$开头（如：Jquery代码），则在$前添加空格。

切换到最新窗口

切换窗口到最新窗口或者切换到最新打开tab页签，打开多个窗口或tab页签时使用。

输入参数：

无

输出参数：

无

切换到原始窗口

切换最开始打开的窗口，打开多个窗口或tab页签时使用。

输入参数：

无

输出参数：

无

切换窗口

根据打开窗口的索引切换窗口

输入参数：

参数名	类型	是否必须	说明
窗口索引	int	是	从0开始，最早打开的窗口索引是0，然后依此递增

输出参数：

无

前进

执行浏览器前进操作，网页会跳转到历史记录中的后一个网址

输入参数：

无

输出参数：

无

后退

执行浏览器后退操作，网页会跳转到历史记录中的前一个网址

输入参数：

无

输出参数：

无

刷新

刷新当前页面

输入参数：

无

输出参数：

无

创建标签页

创建新的tab页签

输入参数：

参数名	类型	是否必须	说明
链接	string	是	新打开tab页签的链接

输出参数：

无

切换标签页

根据标签页名称切换标签页

输入参数：

参数名	类型	是否必须	说明
标签页名称	string	是	标签页名称

输出参数：

无

提示

标签名称如图：

关闭当前标签页

关闭当前打开的标签页

输入参数：

无

输出参数：

无

关闭指定标签页

根据索引关闭标签页

输入参数：

参数名	类型	是否必须	说明
索引	int	是	标签页索引，最早打开的tab索引是0，然后依此递增

输出参数：

无

获取标题

获取网页标题，标题位置如下图所示

输入参数：

无

输出参数：

变量名	类型	说明
自定义	string	网页标题

获取网址

获取网页网址，网址位置如下图所示

输入参数：

无

输出参数：

变量名	类型	说明
自定义	string	网页网址

获取源代码

获取网页源代码

输入参数：

无

输出参数：

变量名	类型	说明
自定义	string	网页源代码

获取Cookie

获取当前网页的Cookie信息

输入参数：

无

输出参数：

变量名	类型	说明
自定义	string	网页Cookie, 格式为json字符串，如：{"PSTM":"1666849775","BD_UPN":"12314353","BD_HOME":"1"}

设置Cookie

设置当前网页Cookie信息

输入参数：

参数名	类型	是否必须	说明
cookie	string	是	cookie信息，格式为json字符串，如{“uid”:"123"}

输出参数：

变量名	类型	说明
自定义	string	网页源代码

Xpath转元素

将xpath路径转换成元素对象

输入参数：

参数名	类型	是否必须	说明
xpath	string	是	xpath

输出参数：

变量名	类型	说明
自定义	RemoteWebElement	元素对象

点击元素

点击目标元素

输入参数：

参数名	类型	是否必须	说明
元素xpath	string	是	元素定位路径，通过捕获元素按钮进行捕获

输出参数：

无

根据链接文本点击

根据文本进行点击

输入参数：

参数名	类型	是否必须	说明
文本路径	string	否	该项为可选项，如果设置，则会在该元素范围内查找文本进行点击，如果不设置，则全文查找
文本内容	string	是	要点击的文本内容

输出参数：

无

获取元素文本

获取指定元素的文本内容

输入参数：

参数名	类型	是否必须	说明
元素xpath	string	是	元素定位路径，通过捕获元素按钮进行捕获

输出参数：

变量名	类型	说明
自定义	string	元素文本内容

获取元素属性

获取指定元素的属性，比如href、alt等属性

输入参数：

参数名	类型	是否必须	说明
元素xpath	string	是	元素定位路径，通过捕获元素按钮进行捕获

输出参数：

变量名	类型	说明
自定义	string	元素的属性值

设置输入框内容

设置文本输入框的输入内容

输入参数：

参数名	类型	是否必须	说明
元素xpath	string	是	元素定位路径，通过捕获元素按钮进行捕获
元素值	string	是	要填写的值

输出参数：

无

设置密码框内容

设置密码输入框的输入内容

输入参数：

参数名	类型	是否必须	说明
元素xpath	string	是	元素定位路径，通过捕获元素按钮进行捕获
密码	string	是	要填写的密码

输出参数：

无

获取输入框内容

获取文本输入框的内容

输入参数：

参数名	类型	是否必须	说明
元素xpath	string	是	元素定位路径，通过捕获元素按钮进行捕获

输出参数：

变量名	类型	说明
自定义	string	文本输入框的内容

获取下拉框内容

获取下拉选择框选中项的文本内容

输入参数：

参数名	类型	是否必须	说明
元素xpath	string	是	元素定位路径，通过捕获元素按钮进行捕获

输出参数：

变量名	类型	说明
自定义	string	下拉框选中项的文本内容

选择下拉框内容

选中下拉框的值

输入参数：

参数名	类型	是否必须	说明
元素xpath	string	是	元素定位路径，通过捕获元素按钮进行捕获
元素值	string	是	要选中的值

输出参数：

无

获取下拉框选项

获取下拉框的所有选项

输入参数：

参数名	类型	是否必须	说明
元素xpath	string	是	元素定位路径，通过捕获元素按钮进行捕获

输出参数：

变量名	类型	说明
自定义	List<string>	所有选项

选择上传文件

设置选择文件控件的值，如下图

输入参数：

参数名	类型	是否必须	说明
元素xpath	string	是	元素定位路径，通过捕获元素按钮进行捕获
上传文件	string	是	上传文件的路径

输出参数：

无

滚动到元素

滚动到指定元素

输入参数：

参数名	类型	是否必须	说明
元素xpath	string	是	元素定位路径，通过捕获元素按钮进行捕获

输出参数：

无

等待元素出现

等待指定元素出现

输入参数：

参数名	类型	是否必须	说明
元素xpath	string	是	元素定位路径，通过捕获元素按钮进行捕获
超时时间	int	是	最大等待时间

输出参数：

无

元素是否存在

判断指定元素是否存在

输入参数：

参数名	类型	是否必须	说明
元素xpath	string	是	元素定位路径，通过捕获元素按钮进行捕获

输出参数：

变量名	类型	说明
自定义	bool	true:存在,false:不存在

获取相似元素

根据A、B两个元素获取所有跟A或B相似的元素，如下图，相同颜色的框都是相似元素，只要选择两个元素，就可以获取整个页面所有相似元素

输入参数：

参数名	类型	是否必须	说明
A元素Fullxpath	string	是	元素定位路径，通过选择按钮进行捕获
B元素Fullxpath	string	是	元素定位路径，通过选择按钮进行捕获

输出参数：

变量名	类型	说明
自定义	List<IWebElement>	所有的相似元素数组

元素截图

对指定元素进行截图

输入参数：

参数名	类型	是否必须	说明
元素xpath	string	是	元素定位路径，通过捕获元素按钮进行捕获
保存路径	string	是	图片保存路径

输出参数：

变量名	类型	说明
自定义	string	图片保存路径

获取父元素

获取当前元素的父元素

输入参数：

参数名	类型	是否必须	说明
元素xpath	string	是	元素定位路径，通过捕获元素按钮进行捕获

输出参数：

变量名	类型	说明
自定义	IWebElement	父元素

获取兄弟元素（含自己）

获取当前元素的所有兄弟元素（包含自己）

输入参数：

参数名	类型	是否必须	说明
元素xpath	string	是	元素定位路径，通过捕获元素按钮进行捕获

输出参数：

变量名	类型	说明
自定义	List<IWebElement>	所有兄弟元素

Frame切换

切换控制句柄到其他frame，默认的控制句柄是指向top frame（主页面）的，当网页中包含子页面（frame或者iframe）时，会用到该操作。

输入参数：

参数名	类型	是否必须	说明
元素xpath	string	是	元素定位路径，通过捕获元素按钮进行捕获

输出参数：

无

提示

当发现某一个元素内的子元素不能被捕获时，则先进行该操作，然后再捕获里面的子元素。

返回主Frame

切换控制句柄到top frame

输入参数：

无

输出参数：

无

操作交互框

操作网页上弹出的浏览器原生警告框(alert)、确认框(confirm)、输入框(prompt)，不包括用户自定义的弹窗，如下图：

输入参数：

参数名	类型	是否必须	说明
操作类型	string	是	确认：点击确认按钮，取消：点击取消按钮
输入内容	string	否	当交互框类型为prompt时，通过该参数输入内容

输出参数：

无

获取元素坐标

获取元素内的点相对于屏幕的坐标

输入参数：

参数名	类型	是否必须	说明
元素xpath	string	是	元素定位路径，通过捕获元素按钮进行捕获
坐标位置	string	是	坐标位置，默认：中心
横向偏移	int	是	基于坐标位置的x轴偏移，负左正右
纵向偏移	int	是	基于坐标位置的y轴偏移，负上正下

输出参数：

变量名	类型	说明
自定义	string	点的真实坐标（相对于屏幕），如：{"X":342, "Y":457}

点击元素坐标

点击元素内的坐标

输入参数：

参数名	类型	是否必须	说明
元素xpath	string	是	元素定位路径，通过捕获元素按钮进行捕获
坐标位置	string	是	坐标位置，默认：中心
横向偏移	int	是	基于坐标位置的x轴偏移，负左正右
纵向偏移	int	是	基于坐标位置的y轴偏移，负上正下
操作类型	string	是	操作类型

输出参数：

变量名	类型	说明
自定义	string	真实点击坐标（相对于屏幕），如：{"X":342, "Y":457}