全部产品
云市场

rpa.ie

更新时间:2020-03-03 15:38:39

目录

ie

要使用ie模块,需要rpa.ie

ie模块是用来向用户提供一系列操作IE浏览器的SDK,让用户通过简单的参数和方法调用来实现一些复杂的操作。

create

方法名
create(url, *, try_attach=False, wait=True, visible=True)

方法描述
该方法会创建一个Browser对象,并在IE浏览器打开对应的页面。

版本信息
该方法适用于从3.3.0及以上版本。

参数说明

  • url : 要打开的url
  • try_attach : 尝试抓取 默认False
  • wait : 是否等待加载完成
  • timeout : 等待超时时间

返回值说明
返回一个Browser类型的对象。
示例

  1. page = rpa.ie.create('www.baidu.com')

catch

方法名
create(url, *, try_attach=False, wait=True, visible=True)

方法描述
该方法会根据url或者标题在IE浏览器捕获一个已经打开的页面。

版本信息
该方法适用于从3.3.0及以上版本。

参数说明

  • name : 标题或者url
  • mode : ‘title’|’url’

返回值说明
返回一个Browser类型的对象。
示例

  1. page = rpa.ie.catch('www.baidu.com')

closeall

方法名
closeall()

方法描述
该方法会关闭所有的页面。

版本信息
该方法适用于从3.3.0及以上版本。

参数说明

返回值说明

示例

  1. rpa.ie.closeall()

Browser

Browser : 负责为用户提供Browser相关的一些操作。

close

方法名
close(self)

方法描述
该方法会关闭所有浏览器对象。

版本信息
该方法适用于从3.3.0及以上版本。

参数说明

返回值说明

示例

  1. page.close()

navigate

方法名
navigate(self, url, *, wait=True)

方法描述
该方法会从当前浏览器对象的链接跳转到另指定的链接。

版本信息
该方法适用于从3.3.0及以上版本。

参数说明

  • url : 要打开的url
  • wait : 是否等待加载完成

返回值说明

示例

  1. page.navigate("www.taobao.com")

back

方法名
back(self)

方法描述
该方法会从当前浏览器对象后退。

版本信息
该方法适用于从3.3.0及以上版本。

参数说明

返回值说明

示例

  1. page.back()

wait

方法名
wait(self, element, *, index=1, parent_element=None, timeout=10)

方法描述
该方法会等待控件加载。

版本信息
该方法适用于从3.3.0及以上版本。

参数说明

  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • parent_elemet : 父控件对象
  • timeout : 等待超时时间

返回值说明

示例

  1. page.wait('控件名称')

wait_disappear

方法名
wait_disappear(self, element, *, index=1, parent_element=None,timeout=10)

方法描述
该方法会等待控件消失。

版本信息
该方法适用于从3.3.0及以上版本。

参数说明

  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • parent_elemet : 父控件对象
  • timeout : 等待超时时间

返回值说明

示例

  1. page.wait_disappear('控件名称')

download

方法名
download(self, path, element, *, index=1, parent_element=None,timeout=10)

方法描述
下载

版本信息
该方法适用于从3.3.0及以上版本。

参数说明

  • path : 保存的文件路径
  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • parent_elemet : 父控件对象
  • timeout : 等待超时时间

返回值说明

示例

  1. page.download(r'D:/','控件名称')

upload

方法名
upload(self, element, file, *, index=1, parent_element=None,timeout=10)

方法描述
上传文件

版本信息
该方法适用于从3.3.0及以上版本。

参数说明

  • element : 控件名称
  • file : 保存的文件路径
  • index : 如果有多个,给出控件下标
  • parent_elemet : 父控件对象
  • timeout : 等待超时时间

返回值说明

示例

  1. page.upload('控件名称',r'D:/baidu.jpg')

table

方法名
table(self, value, type=’index’, rtrtype=’text’, parent_element=None)

方法描述
获取表格

版本信息
该方法适用于从3.3.0及以上版本。

参数说明

  • value : 类型为index时是下标,否则为正则表达式模糊匹配。
  • type : ‘index’|’text’|’html’
  • rtrtype : ‘text’|’html’返回类型文本或者html
  • parent_elemet : 父控件对象

返回值说明
返回二维数组或html
示例

  1. result = page.table(1,'index','html')
  2. result = page.table(1,'index','text')
  3. result = page.table('Month','text','html')
  4. result = page.table('Month','text','text')
  5. result = page.table('<table border="1">','html','html')
  6. result = page.table('<table border="1">','html','text')

text

方法名
text(self, *, element=None, index=1, parent_element=None)

方法描述
获取文本

版本信息
该方法适用于从3.3.0及以上版本。

参数说明

  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • parent_elemet : 父控件对象

返回值说明
返回文本
示例

  1. result = page.text('控件名称')

html

方法名
html(self, element=None, *, index=1, parent_element=None)

方法描述
获取html

版本信息
该方法适用于从3.3.0及以上版本。

参数说明

  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • parent_elemet : 父控件对象

返回值说明
返回html
示例

  1. result = page.html('控件名称')

input

方法名
input(self, element, value, *, index=1, parent_element=None,simulate=True, timeout=10)

方法描述
输入框输入

版本信息
该方法适用于从3.3.0及以上版本。

参数说明

  • element : 控件名称
  • value : 输入的内容
  • index : 如果有多个,给出控件下标
  • parent_elemet : 父控件对象
  • simulate : 是否模拟输入
  • timeout : 等待超时时间

返回值说明

示例

  1. result = page.input('控件名称','你好,码栈')

value

方法名
value(self, element, *, index=1, parent_element=None, timeout=10)

方法描述
获取value属性的值

版本信息
该方法适用于从3.3.0及以上版本。

参数说明

  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • parent_elemet : 父控件对象
  • timeout : 等待超时时间

返回值说明
返回value属性的值
示例

  1. result = page.value('控件名称')

option

方法名
option(self, element, value, *, index=1, parent_element=None,type=’match’, timeout=10)

方法描述
下拉框选择

版本信息
该方法适用于从3.3.0及以上版本。

参数说明

  • element : 控件名称(下拉框控件)
  • value : 选择内容
  • index : 如果有多个,给出控件下标
  • type : ‘match’|’full’|’regex’ 分表标识模糊匹配|完全匹配|正则匹配
  • parent_elemet : 父控件对象
  • timeout : 等待超时时间

返回值说明

示例

  1. page.option('控件名称','Sa')
  2. page.option('控件名称','Saab',type='full')
  3. page.option('控件名称','Saab',type='regx')

check

方法名
check(self, element, *, value=None, index=1, parent_element=None,timeout=10)

方法描述
勾选框操作
获取勾选状态时有返回值

版本信息
该方法适用于从3.3.0及以上版本。

参数说明

  • element : 控件名称(复选框控件)
  • index : 如果有多个,给出控件下标
  • value : 不给获取勾选状态,传入True则勾选,传入False取消勾选
  • parent_elemet : 父控件对象
  • timeout : 等待超时时间

返回值说明
返回复选框是否勾选
示例

  1. result = page.check('控件名称')
  2. page.check('控件名称',value=True)
  3. page.check('控件名称',value=False)

click

方法名
click(self, element, *, index=1, parent_element=None, simulate=True,timeout=10)

方法描述
点击

版本信息
该方法适用于从3.3.0及以上版本。

参数说明

  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • parent_element : 父控件对象
  • simulate : 是否模拟点击
  • timeout : 等待超时时间

返回值说明

示例

  1. page.click('控件名称')

element_count

方法名
element_count(self, element, *, parent_element=None)

方法描述
获取控件个数

版本信息
该方法适用于从3.3.0及以上版本。

参数说明

  • element : 控件名称
  • parent_element : 父控件对象

返回值说明
返回控件个数
示例

  1. result = page.element_count('控件名称')

href

方法名
href(self, element, *, index=1, parent_element=None, timeout=10)

方法描述
获取链接

版本信息
该方法适用于从3.3.0及以上版本。

参数说明

  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • parent_elemet : 父控件对象
  • timeout : 等待超时时间

返回值说明
返回链接
示例

  1. result = page.href('下一步')

alert

方法名
alert(self, element, value=’yes’, *, index=1, parent_element=None,timeout=10)

方法描述
弹出框点击

版本信息
该方法适用于从3.3.0及以上版本。

参数说明

  • element : 控件名称(弹出框点击)
  • index : 如果有多个控件,给出下标
  • value : ‘yes’|’no’ 点确定或取消
  • parent_elemet : 父控件对象
  • timeout : 等待超时时间

返回值说明
返回链接
示例

  1. result = page.alert('控件名称',value='no')

pos

方法名
pos(self, element, *, index=1, parent_element=None, timeout=10)

方法描述
获取控件坐标

版本信息
该方法适用于从3.3.0及以上版本。

参数说明

  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • parent_elemet : 父控件对象
  • timeout : 等待超时时间

返回值说明
返回坐标 json格式{x1:y1;x2:y2}
示例

  1. result = json.loads(page.pos('百度一下'))
  2. #解析json格式的坐标,并转换成int类型。
  3. x1 = int(float(result["x1"]))
  4. x2 = int(float(result["x2"]))
  5. y1 = int(float(result["y1"]))
  6. y2 = int(float(result["y2"]))

mouse_move

方法名
mouse_move(self, element, *, index=1, parent_element=None, timeout=10)

方法描述
鼠标移入

版本信息
该方法适用于从3.3.0及以上版本。

参数说明

  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • parent_elemet : 父控件对象
  • timeout : 等待超时时间

返回值说明

示例

  1. result = page.mouse_move('控件名称')

get_element

方法名
get_element(self, element, *, index=1, parent_element=None, timeout=10)

方法描述
获取控件对象

版本信息
该方法适用于从3.3.0及以上版本。

参数说明

  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • parent_elemet : 父控件对象
  • timeout : 等待超时时间

返回值说明
返回控件对象
示例

  1. element = page.get_element('百度一下')

url

方法名
url(self)

方法描述
获取当前网页对象url

版本信息
该方法适用于从3.3.0及以上版本。

参数说明

返回值说明
返回当前网页对象url
示例

  1. url = page.url()

title

方法名
title(self)

方法描述
获取当前网页对象标题

版本信息
该方法适用于从3.3.0及以上版本。

参数说明

返回值说明
返回当前网页对象标题
示例

  1. title = page.title()

reload

方法名
reload(self)

方法描述
刷新页面

版本信息
该方法适用于从3.3.0及以上版本。

参数说明

返回值说明

示例

  1. page.reload()

方法名
cookie(self)

方法描述
获取控件对象cookie

版本信息
该方法适用于从3.3.0及以上版本。

参数说明

返回值说明
返回控件对象cookie
示例

  1. page = rpa.ie.create("www.baidu.com")
  2. a = page.cookie()
  3. print(a)