阿里云首页 机器人流程自动化RPA 相关技术圈

IETab

close

close()

方法描述

关闭浏览器对象

调用样例- rpa.app.ie.IETab.close-

# 注意事项:此方法仅能基于IETab实例对象进行操作
# 代码调用样例如下:
page = rpa.app.ie.create('www.taobao.com')
page.close()

navigate

navigate(url, wait=True, timeout=100)

方法描述

跳转到指定链接

参数说明

url<str>要打开的url

wait<bool>是否等待加载完成

timeout<int>等待超时时间, 默认100s

调用样例- rpa.app.ie.IETab.navigate-

# 注意事项:此方法仅能基于IETab实例对象进行操作
# 代码调用样例如下:
page = rpa.app.ie.create('www.taobao.com')
page.navigate('www.aliyun.com')

back

back(wait=True, timeout=100)

方法描述

浏览器后退

参数说明

wait<bool>是否等待加载完成

timeout<int>等待超时时间, 默认100s

调用样例- rpa.app.ie.IETab.back-

# 注意事项:此方法仅能基于IETab实例对象进行操作
# 代码调用样例如下:
page = rpa.app.ie.create('www.taobao.com')
page.navigate('www.aliyun.com')
page.back()

forward

forward(wait=True, timeout=100)

方法描述

浏览器前进

参数说明

wait<bool>是否等待加载完成

timeout<int>等待超时时间, 默认100s

调用样例- rpa.app.ie.IETab.forward-

# 注意事项:此方法仅能基于IETab实例对象进行操作
# 代码调用样例如下:
page = rpa.app.ie.create('www.taobao.com')
page.navigate('www.aliyun.com')
page.back()
page.forward()

get_cookies

get_cookies()

方法描述

获取cookie

返回值说明

返回cookie<list>

调用样例- rpa.app.ie.IETab.get_cookies-

# 注意事项:此方法仅能基于IETab实例对象进行操作
# 代码调用样例如下:
page = rpa.app.ie.create('www.taobao.com')
cookies = page.get_cookies()

wait_loaded

wait_loaded(element, index=1, parent_element=None, timeout=10, ignore_error=True)

方法描述

控件加载

参数说明

element<str>控件

index<int>如果有多个,给出控件下标

timeout<int>超时时间

parent_element<Element>父控件对象

ignore_error<bool>忽略错误

调用样例- rpa.app.ie.IETab.wait_loaded-

# 注意事项:此方法仅能基于IETab实例对象进行操作,使用前需要确认已通过捕捉控件功能录制了页面元素
# 代码调用样例如下:
page = rpa.app.ie.create('www.taobao.com')
flag = page.wait_loaded('淘宝logo')

wait_disappear

wait_disappear(element, index=1, parent_element=None, timeout=10)

方法描述

等待控件消失

参数说明

element<str>控件

index<int>如果有多个,给出控件下标

timeout<int>超时时间

parent_element<Element>父控件对象

调用样例- rpa.app.ie.IETab.wait_disappear-

# 注意事项:此方法仅能基于IETab实例对象进行操作,超过预定时间控件仍未消失则抛出异常
# 代码调用样例如下:
page = rpa.app.ie.create('www.taobao.com')
flag = page.wait_disappear('淘宝logo')

download_by_url

download_by_url(url, path, wait=True, complete_timeout=120)

方法描述

根据url下载文件

参数说明

url<str>下载文件的链接

path<str>保存的文件路径

complete_timeout<int>超时时间

wait<bool>是否等待完成

调用样例- rpa.app.ie.IETab.download_by_url-

# 注意事项:此方法仅能基于IETab实例对象进行操作
# 代码调用样例如下,运行后会下载对应文件到指定路径:
page = rpa.app.ie.create('www.cninfo.com.cn')
download_url = 'www.cninfo.com.cn/new/announcement/download?bulletinId=1209275224&announceTime=2021-02-10'
download_path = r'D:\阿里巴巴-SW.pdf'
page.download_by_url(download_url,download_path)

download_by_element

download_by_element(path, element, index=1, parent_element=None, wait=True, complete_timeout=120)

方法描述

根据控件下载文件

参数说明

path<str>保存的文件路径

element<str>控件

index<int>如果有多个,给出控件下标

parent_element<Element>父控件对象

complete_timeout<int>超时时间

wait<bool>是否等待完成

调用样例- rpa.app.ie.IETab.download_by_element-

# 注意事项:此方法仅能基于IETab实例对象进行操作,使用前需要先通过捕捉控件功能获取页面上的下载按钮并验证可用
# 代码调用样例如下,运行后会下载对应文件到指定路径:
url = 'http://www.cninfo.com.cn/new/disclosure/detail?plate=hke&orgId=9900042435&stockCode=09988&announcementId=1209275224'
page = rpa.app.ie.create(url)
download_path = r'D:\阿里巴巴-SW-公开资料.pdf'
page.download_by_element(download_path,'公告下载-ie')

upload

upload(element, file, index=1, parent_element=None, timeout=10)

方法描述

上传文件

参数说明

file<str>上传的文件路径

element<str>控件

index<int>如果有多个,给出控件下标

parent_element<Element>父控件对象

timeout<int>超时时间

调用样例- rpa.app.ie.IETab.upload-

# 注意事项:此方法仅能基于IETab实例对象进行操作,使用前需要先通过捕捉控件功能获取页面上的上传按钮并验证可用
# 代码调用样例如下,最终会产生XX结果(即对示例代码做简要描述)
url = 'https://duguang.aliyun.com/experience?type=standard&subtype=idcard#intro'
page = rpa.app.ie.create(url)
upload_path = r'D:\2_测试文件归档\OCR身份证识别.jpg'
page.upload('上传图片-ie',upload_path)

execute_js

execute_js(code, timeout=10)

方法描述

执行js代码

参数说明

code<str>js代码

timeout<int>超时时间

调用样例- rpa.app.ie.IETab.execute_js-

# 注意事项:此方法仅能基于IETab实例对象进行操作,如果需要在js中获取返回值,请使用js标准的function写法。
# 代码调用样例如下,需要先创建一个IETab对象,将在此页面对象上执行对应js脚本:
page = rpa.app.ie.create('www.baidu.com')
js_code = """
    function test(){ 
    var div1 = document.getElementById("su").getAttribute('%s');
    return(div1) 
    } ; 
result = test() ; 
console.log(result) ; 
alert(result);
return result;
"""%'value'

value = page.execute_js(js_code)
print(value)

table

table(element, return_type='text', index=1, parent_element=None, timeout=10)

方法描述

获取表格

参数说明

return_type<str>返回类型

可选项:

  • text : 文本类型

  • html : html类型

index<int>如果有多个,给出控件下标

parent_element<Element>父控件对象

timeout<int>超时时间

返回值说明

返回二维数组或html<list>

调用样例- rpa.app.ie.IETab.table-

# 注意事项:此方法仅能基于IETab实例对象进行操作,使用前需要先通过捕捉控件功能捕捉页面上的标准表格元素(html标签为table的)
# 代码调用样例如下:
url = 'https://help.aliyun.com/document_detail/175379.html'
page = rpa.app.ie.create(url)
table_data = page.table('表格-ie')

scroll

scroll(height, element=None, index=1, parent_element=None, timeout=10, direction='top')

方法描述

滚动页面(传入控件则为设置控件内的滚动条)

参数说明

element<str>控件

index<int>如果有多个,给出控件下标

parent_element<Element>父控件对象

timeout<int>超时时间

height<int>设置则滚动指定高度

direction<str>选择滚动条方向

可选项:

  • left : 向左滚动

  • top : 向下滚动

返回值说明

返回True表示还能滚动,返回False表示已经滚到底<bool>

调用样例- rpa.app.ie.IETab.scroll-

# 注意事项:此方法仅能基于IETab实例对象进行操作
# 代码调用样例如下,运行后,会在打开的网页中将滑块向下滑动500个像素:
url = 'https://help.aliyun.com/document_detail/175379.html'
page = rpa.app.ie.create(url)
page.scroll(500)

scroll_into_view

scroll_into_view(element, index=1, parent_element=None, timeout=10)

方法描述

滚动控件到可视区域

参数说明

element<str>控件

index<int>如果有多个,给出控件下标

parent_element<Element>父控件对象

timeout<int>超时时间

调用样例- rpa.app.ie.IETab.scroll_into_view-

# 注意事项:此方法仅能基于IETab实例对象进行操作,使用前需要先使用捕捉控件功能获取页面元素
# 代码调用样例如下,运行后会在打开的网页中,将滑块向下滑动,直到指定的页面元素处于可见范围内:
url = 'https://help.aliyun.com/document_detail/175379.html'
page = rpa.app.ie.create(url)
page.scroll_into_view('网页底部-ie')

get_scroll_height

get_scroll_height(element=None, index=1, parent_element=None, timeout=10)

方法描述

获取纵向滚动条高度(传入控件则为设置控件内的滚动条)

参数说明

element<str>控件

返回值说明

返回纵向滚动条高度<str>

调用样例- rpa.app.ie.IETab.get_scroll_height-

# 注意事项:此方法仅能基于IETab实例对象进行操作
# 代码调用样例如下,运行后会获取对应网页纵向滑块当前的位置:
url = 'https://help.aliyun.com/document_detail/175379.html'
page = rpa.app.ie.create(url)
height = page.get_scroll_height()

get_scroll_width

get_scroll_width(element=None, index=1, parent_element=None, timeout=10)

方法描述

获取横向滚动宽度(传入控件则为设置控件内的滚动条)

参数说明

element<str>控件

返回值说明

返回横向滚动宽度<str>

调用样例- rpa.app.ie.IETab.get_scroll_width-

# 注意事项:此方法仅能基于IETab实例对象进行操作
# 代码调用样例如下,运行后会获取对应网页横向滑块当前的位置:
url = 'https://help.aliyun.com/document_detail/175379.html'
page = rpa.app.ie.create(url)
height = page.get_scroll_width()

text

text(element=None, index=1, parent_element=None, timeout=10)

方法描述

获取文本

参数说明

element<str>控件

index<int>如果有多个,给出控件下标

parent_element<Element>父控件对象

timeout<int>超时时间

返回值说明

返回文本,不传控件返回浏览器上所有的文本<str>

调用样例- rpa.app.ie.IETab.text-

# 注意事项:此方法仅能基于IETab实例对象进行操作,如果要获取指定元素的文本,使用前需要先使用捕捉控件功能获取页面元素
# 代码调用样例如下:
url = 'https://help.aliyun.com/document_detail/175379.html'
page = rpa.app.ie.create(url)
text = page.text(element='网页底部-ie')

html

html(element=None, index=1, parent_element=None, timeout=10)

方法描述

获取html

参数说明

element<str>控件

index<int>如果有多个,给出控件下标

parent_element<Element>父控件对象

timeout<int>超时时间

返回值说明

返回html,不传控件返回浏览器上所有的html<str>

调用样例- rpa.app.ie.IETab.html-

# 注意事项:此方法仅能基于IETab实例对象进行操作,如果要获取指定元素的html,使用前需要先使用捕捉控件功能获取页面元素
# 代码调用样例如下:
url = 'https://help.aliyun.com/document_detail/175379.html'
page = rpa.app.ie.create(url)
html = page.html('网页底部-ie')

input_text

input_text(element, value, index=1, parent_element=None, simulate=True, replace=True, sent_raw=False, wait_mili_seconds=20, timeout=10)

方法描述

输入文本

参数说明

element<str>控件

index<int>如果有多个,给出控件下标

value<str>输入的内容

parent_element<Element>父控件对象

simulate<bool>是否模拟输入

replace<bool>是否清空之前的内容

sent_raw<bool>是否发送原始按键,仅非模拟模式有效

wait_mili_seconds<int>字符间输入间隔(毫秒),仅在模拟输入下有效,默认值为20,最大值100,该值设置过大可能会引起超时

timeout<int>超时时间

调用样例- rpa.app.ie.IETab.input_text-

# 注意事项:此方法仅能基于IETab实例对象进行操作,使用前需要先通过捕捉控件功能获取页面输入框元素
# 代码调用样例如下:
url = 'www.taobao.com'
page = rpa.app.ie.create(url)
page.input_text('淘宝搜索框-ie','RPA')

input_hotkeys

input_hotkeys(element, value, index=1, parent_element=None, timeout=10)

方法描述

输入快捷键

参数说明

element<str>控件

value<str>输入的内容

index<int>如果有多个,给出控件下标

parent_element<Element>父控件对象

timeout<int>超时时间

调用样例- rpa.app.ie.IETab.input_hotkeys-

# 注意事项:此方法仅能基于IETab实例对象进行操作,虚拟键写法请参考:https://www.yuque.com/aliyun_rpa/quzm63/vk
# 代码调用样例如下:
url = 'www.taobao.com'
page = rpa.app.ie.create(url)
page.input_text('淘宝搜索框-ie','RPA')
page.input_hotkeys('淘宝搜索框-ie','VK_RETURN')

value

value(element, index=1, parent_element=None, timeout=10)

方法描述

获取值

参数说明

element<str>控件

index<int>如果有多个,给出控件下标

parent_element<Element>父控件对象

timeout<int>超时时间

返回值说明

返回值<str>

调用样例- rpa.app.ie.IETab.value-

# 注意事项:此方法仅能基于IETab实例对象进行操作,使用前需要先通过捕捉控件功能获取页面元素
# 代码调用样例如下:
url = 'https://help.aliyun.com/document_detail/175379.html'
page = rpa.app.ie.create(url)
value = page.value('网页底部-ie')

option

option(element, text, type='match', index=1, parent_element=None, clear_selected=False, timeout=10)

方法描述

通过文本下拉框选择

参数说明

element<str>控件

index<int>如果有多个,给出控件下标

text<str>选择内容

parent_element<Element>父控件对象

type<str>匹配类型

可选项:

  • match : 模糊匹配

  • full : 完全匹配

  • regex : 正则匹配

clear_selected<bool>是否清空之前的选择(仅作用于多选时)

timeout<int>超时时间

调用样例- rpa.app.ie.IETab.option-

# 注意事项:
# 1.此方法仅能基于IETab实例对象进行操作,使用前需要先通过捕捉控件功能获取页面标准下拉框元素(html标签为select)
# 2.需确认下拉框中存在对应的文本选项
# 代码调用样例如下:
url = 'https://kyfw.12306.cn/otn/leftTicket/init'
page = rpa.app.ie.create(url)

page.option('下拉框-ie','00:00--06:00')

option_by_index

option_by_index(element, item_index, index=1, parent_element=None, clear_selected=False, timeout=10)

方法描述

通过下标下拉框选择

参数说明

element<str>控件

index<int>如果有多个,给出控件下标

item_index<int>选项下标

parent_element<Element>父控件对象

clear_selected<bool>是否清空之前的选择(仅作用于多选时)

timeout<int>超时时间

调用样例- rpa.app.ie.IETab.option_by_index-

# 注意事项:
# 1.此方法仅能基于IETab实例对象进行操作,使用前需要先通过捕捉控件功能获取页面标准下拉框元素(html标签为select)
# 2.需确认下拉框中选项个数,索引从1计算,不能超过选项最大个数
# 代码调用样例如下:
url = 'https://kyfw.12306.cn/otn/leftTicket/init'
page = rpa.app.ie.create(url)

page.option_by_index('下拉框-ie',4)

get_options

get_options(element, mode='all', index=1, parent_element=None, timeout=10)

方法描述

返回下拉框选中的值/所有的选项

参数说明

element<str>控件

mode<str>返回类型

可选项:

  • selected : 选中项

  • all : 所有项

index<int>如果有多个,给出控件下标

parent_element<Element>父控件对象

timeout<int>超时时间

返回值说明

返回列表<list>

调用样例- rpa.app.ie.IETab.get_options-

# 注意事项:此方法仅能基于IETab实例对象进行操作,使用前需要先通过捕捉控件功能获取页面标准下拉框元素(html标签为select)
# 代码调用样例如下:
url = 'https://kyfw.12306.cn/otn/leftTicket/init'
page = rpa.app.ie.create(url)
options = page.get_options('下拉框-ie')

get_checked_state

get_checked_state(element, index=1, parent_element=None, timeout=10)

方法描述

获取勾选状态

参数说明

element<str>控件

index<int>如果有多个,给出控件下标

parent_element<Element>父控件对象

timeout<int>超时时间

返回值说明

返回勾选状态<bool>

调用样例- rpa.app.ie.IETab.get_checked_state-

# 注意事项:此方法仅能基于IETab实例对象进行操作,使用前需要先通过捕捉控件功能获取页面上的勾选框元素
# 代码调用样例如下:
url = 'https://kyfw.12306.cn/otn/leftTicket/init'
page = rpa.app.ie.create(url)
check_state = page.get_checked_state('复选框-ie')

set_checked_state

set_checked_state(element, value=True, index=1, parent_element=None, timeout=10)

方法描述

勾选框操作

参数说明

element<str>控件

index<int>如果有多个,给出控件下标

value<bool>传入True则勾选,传入False取消勾选

parent_element<Element>父控件对象

timeout<int>超时时间

调用样例- rpa.app.ie.IETab.set_checked_state-

# 注意事项:此方法仅能基于IETab实例对象进行操作,使用前需要先通过捕捉控件功能获取页面上的勾选框元素
# 代码调用样例如下:
url = 'https://kyfw.12306.cn/otn/leftTicket/init'
page = rpa.app.ie.create(url)
page.set_checked_state('复选框-ie')

click

click(element, index=1, parent_element=None, simulate=True, button='left', timeout=10)

方法描述

点击

参数说明

element<str>控件

index<int>如果有多个,给出控件下标

parent_element<Element>父控件对象

simulate<bool>是否模拟点击

button<str>鼠标键位

可选项:

  • left : 左键

  • right : 右键

timeout<int>超时时间

调用样例- rpa.app.ie.IETab.click-

# 注意事项:
# 1. 此方法仅能基于IETab实例对象进行操作,使用前需要通过捕捉控件功能获取页面上的可点击元素
# 2. simulate=True,即模拟点击情况下,需要对应的页面元素在可见区域,模拟鼠标点击
# 3. simulate=False,即在非模拟点击情况下,将直接向元素发送对应点击指令
# 代码调用样例如下:
url = 'www.aliyun.com'
page = rpa.app.ie.create(url)
page.click('登录按钮-ie')

double_click

double_click(element, index=1, parent_element=None, simulate=True, timeout=10)

方法描述

双击

参数说明

element<str>控件

index<int>如果有多个,给出控件下标

parent_element<Element>父控件对象

simulate<bool>是否模拟点击

timeout<int>超时时间

调用样例- rpa.app.ie.IETab.double_click-

# 注意事项:
# 1. 此方法仅能基于IETab实例对象进行操作,使用前需要通过捕捉控件功能获取页面上的可点击元素
# 2. simulate=True,即模拟点击情况下,需要对应的页面元素在可见区域,模拟鼠标点击
# 3. simulate=False,即在非模拟点击情况下,将直接向元素发送对应点击指令
# 代码调用样例如下:
url = 'www.aliyun.com'
page = rpa.app.ie.create(url)
page.double_click('登录按钮-ie')

count

count(element, parent_element=None)

方法描述

获取控件个数

参数说明

element<str>控件

parent_element<Element>父控件对象

返回值说明

返回个数<int>

调用样例- rpa.app.ie.IETab.count-

# 注意事项:此方法仅能基于IETab实例对象进行操作,使用前需要通过捕捉控件功能获取页面上的元素
# 通过捕捉相似控件功能获取相似控件元素后,常使用此方法统计控件数量
# 代码调用样例如下:
url = 'www.aliyun.com'
page = rpa.app.ie.create(url)
page.count('登录按钮-ie')

href

href(element, index=1, parent_element=None, timeout=10)

方法描述

获取链接

参数说明

element<str>控件

index<int>如果有多个,给出控件下标

parent_element<Element>父控件对象

timeout<int>超时时间

返回值说明

返回链接<str>

调用样例- rpa.app.ie.IETab.href-

# 注意事项:此方法仅能基于IETab实例对象进行操作,使用前需要通过捕捉控件功能获取页面上附带href属性的元素
# 代码调用样例如下:
url = 'https://help.aliyun.com/document_detail/175379.html'
page = rpa.app.ie.create(url)
link = page.href('登录按钮-ie')

process_alert

process_alert(option='ok', element=None, simulate=True, index=1, parent_element=None, timeout=10)

方法描述

弹出框点击

参数说明

option<str>弹出框处理

可选项:

  • ok : 点击确定

  • cancel : 点击取消

element<str>控件(不传控件则为浏览器内的弹出框点击)

simulate<bool>是否模拟

index<int>如果有多个,给出控件下标

parent_element<Element>父控件对象

timeout<int>超时时间

调用样例- rpa.app.ie.IETab.process_alert-

# 注意事项:
# 1. 此方法仅能基于IETab实例对象进行操作
# 2. 此方法仅能处理confirm或alert弹窗
# 代码调用样例如下:
url = 'https://help.aliyun.com/document_detail/175379.html'
page = rpa.app.ie.create(url)
page.execute_js('alert("提示框")')
page.process_alert()

process_prompt

process_prompt(text, option='ok', element=None, simulate=True, index=1, parent_element=None, timeout=10)

方法描述

输入框输入并点击

参数说明

text<str>输入内容

option<str>弹出框处理

可选项:

  • ok : 点击确定

  • cancel : 点击取消

element<str>控件(不传控件则为浏览器内的弹出框点击)

simulate<bool>是否模拟

index<int>如果有多个,给出控件下标

parent_element<Element>父控件对象

timeout<int>超时时间

调用样例- rpa.app.ie.IETab.process_prompt-

# 注意事项:
# 1. 此方法仅能基于IETab实例对象进行操作
# 2. 此方法仅能处理prompt弹窗
# 代码调用样例如下:
url = 'https://help.aliyun.com/document_detail/175379.html'
page = rpa.app.ie.create(url)
page.execute_js('prompt("请输入内容:","")')
page.process_prompt('RPA_TEST')

alert_message

alert_message()

方法描述

获取弹出框消息

返回值说明

返回弹出框消息<str>

调用样例- rpa.app.ie.IETab.alert_message-

# 注意事项:
# 1. 此方法仅能基于IETab实例对象进行操作
# 2. 此方法仅能处理prompt弹窗
# 代码调用样例如下:
url = 'https://help.aliyun.com/document_detail/175379.html'
page = rpa.app.ie.create(url)
page.execute_js('alert("阿里云RPA_TEST")')
message = page.alert_message()

pos

pos(element, index=1, parent_element=None, timeout=10)

方法描述

获取控件坐标

参数说明

element<str>控件

index<int>如果有多个,给出控件下标

parent_element<Element>父控件对象

timeout<int>超时时间

返回值说明

返回坐标<dict>

调用样例- rpa.app.ie.IETab.pos-

# 注意事项:
# 1. 此方法仅能基于IETab实例对象进行操作,使用前需要通过捕捉控件功能获取页面上的元素
# 2. 此方法返回的坐标是以屏幕左上角为原点,页面元素的坐标------即移动网页窗口,此坐标会变化
# 代码调用样例如下:
url = 'https://help.aliyun.com/document_detail/175379.html'
page = rpa.app.ie.create(url)
pos = page.pos('登录按钮-ie')

screenshot

screenshot(element, file, index=1, parent_element=None, timeout=10)

方法描述

截图

参数说明

element<str>控件

file<str>保存的截图路径

index<int>如果有多个,给出控件下标

parent_element<Element>父控件对象

timeout<int>超时时间

调用样例- rpa.app.ie.IETab.screenshot-

# 注意事项:
# 1. 此方法仅能基于IETab实例对象进行操作,使用前需要通过捕捉控件功能获取页面上的元素
# 2. 此方法会自动滚动滑块,将要操作的元素滚动到可见区域
# 代码调用样例如下,运行后程序会对页面元素进行截图并将截图保存在指定路径:
url = 'https://help.aliyun.com/document_detail/175379.html'
page = rpa.app.ie.create(url)
save_path = r'D:\阿里云底部文本截图.jpg'
page.screenshot('网页底部-ie',save_path)

mouse_move

mouse_move(element, index=1, parent_element=None, timeout=10)

方法描述

鼠标移入

参数说明

element<str>控件

index<int>如果有多个,给出控件下标

parent_element<Element>父控件对象

timeout<int>超时时间

调用样例- rpa.app.ie.IETab.mouse_move-

# 注意事项:
# 1. 此方法仅能基于IETab实例对象进行操作,使用前需要通过捕捉控件功能获取页面上的元素
# 2. 此方法会自动滚动滑块,将要操作的元素滚动到可见区域
# 代码调用样例如下,运行后程序会将鼠标移动到对应元素上
url = 'https://help.aliyun.com/document_detail/175379.html'
page = rpa.app.ie.create(url)
page.mouse_move('网页底部-ie')

drag

drag(element, x=0, y=0, index=1, parent_element=None, timeout=10)

方法描述

将控件拖拽到指定的位置

参数说明

element<str>控件

index<int>如果有多个,给出控件下标

parent_element<Element>父控件对象

timeout<int>超时时间

x<int>x轴偏移量

y<int>y轴偏移量

调用样例- rpa.app.ie.IETab.drag-

# 注意事项:此方法仅能基于IETab实例对象进行操作,使用前需要通过捕捉控件功能获取页面上的元素
# 代码调用样例如下:
url = 'https://help.aliyun.com/document_detail/175379.html'
page = rpa.app.ie.create(url)
page.drag('登录按钮-ie',x=-500,y=100)

get_element_by_name

get_element_by_name(element, index=1, parent_element=None, timeout=10)

方法描述

获取对象

参数说明

element<str>控件

index<int>如果有多个,给出控件下标

parent_element<Element>父控件对象

timeout<int>超时时间

返回值说明

返回控件对象<Element>

调用样例- rpa.app.ie.IETab.get_element_by_name-

# 注意事项:此方法仅能基于IETab实例对象进行操作,使用前需要通过捕捉控件功能获取页面上的元素
# 代码调用样例如下:
url = 'https://www.baidu.com/'
page = rpa.app.ie.create(url)
element = page.get_element_by_name('百度一下按钮-ie')
text = element.text()

get_element_by_css

get_element_by_css(css, index=1, parent_element=None, timeout=10)

方法描述

根据CSS表达式获取控件

参数说明

css<str>CSS表达式

index<int>如果有多个,给出控件下标

parent_element<Element>父控件对象

timeout<int>超时时间

返回值说明

返回控件对象<Element>

调用样例- rpa.app.ie.IETab.get_element_by_css-

# 注意事项:
# 1. 此方法仅能基于IETab实例对象进行操作
# 2. 此方法使用css选择器定位要操作的元素,请使用标准的css-selector表达式
# 代码调用样例如下:
url = 'https://help.aliyun.com/document_detail/175379.html'
page = rpa.app.ie.create(url)
css_selector = "span.menu-title-text"
element = page.get_element_by_css(css_selector)
text = element.text()

url

url()

方法描述

获取url

返回值说明

返回url<str>

调用样例- rpa.app.ie.IETab.url-

# 注意事项:此方法仅能基于IETab实例对象进行操作
# 代码调用样例如下:
url = 'https://help.aliyun.com/document_detail/175379.html'
page = rpa.app.ie.create(url)
get_url = page.url()

title

title()

方法描述

获取title

返回值说明

返回标题<str>

调用样例- rpa.app.ie.IETab.title-

# 注意事项:此方法仅能基于IETab实例对象进行操作
# 代码调用样例如下:
url = 'https://help.aliyun.com/document_detail/175379.html'
page = rpa.app.ie.create(url)
title= page.title()

reload

reload(wait=True, timeout=100)

方法描述

刷新页面

参数说明

wait<bool>是否等待加载完成

timeout<int>等待超时时间, 默认100s

调用样例- rpa.app.ie.IETab.reload-

# 注意事项:此方法仅能基于IETab实例对象进行操作
# 代码调用样例如下:
url = 'https://help.aliyun.com/document_detail/175379.html'
page = rpa.app.ie.create(url)
page.reload()

attr

attr(element, name, index=1, parent_element=None, timeout=10)

方法描述

获取属性

参数说明

element<str>控件

name<str>属性名

index<int>如果有多个,给出控件下标

parent_element<Element>父控件对象

timeout<int>超时时间

返回值说明

返回属性<str>

调用样例- rpa.app.ie.IETab.attr-

# 注意事项:此方法仅能基于IETab实例对象进行操作
# 代码调用样例如下:
url = 'https://help.aliyun.com/document_detail/175379.html'
page = rpa.app.ie.create(url)
attribute = page.attr('登录按钮-ie','class')

in_view

in_view(element, index=1, parent_element=None, timeout=10)

方法描述

控件是否在可见区域

参数说明

element<str>控件

index<int>如果有多个,给出控件下标

parent_element<Element>父控件对象

timeout<int>超时时间

返回值说明

返回控件是否在可见区域<bool>

调用样例- rpa.app.ie.IETab.in_view-

# 注意事项:此方法仅能基于IETab实例对象进行操作,使用前需要通过捕捉控件功能获取页面上的元素
# 代码调用样例如下,最终会产生XX结果(即对示例代码做简要描述)
url = 'https://help.aliyun.com/document_detail/175379.html'
page = rpa.app.ie.create(url)
flag = page.in_view('登录按钮-ie')