ChromeElement

scroll_into_view()

方法描述

将元素调整到可视区域

调用样例- rpa.app.chrome.ChromeTab.ChromeElement.scroll_into_view-

# 注意事项：
# 1. 此方法需要确认已安装并启用Aliyun RPA对应的chrome扩展插件
# 2. 使用前需要确认已通过捕捉控件功能录制了页面元素
# 代码调用样例如下：
url = 'https://help.aliyun.com/document_detail/175379.html'
page = rpa.app.chrome.create(url)
element = page.get_element_by_name('网页底部-售前咨询-chrome')
element.scroll_into_view()

click(simulate=True, button='left', offset_x=0, offset_y=0)

方法描述

点击

参数说明

simulate<bool>是否模拟点击

button<str>鼠标键位

可选项：

• left : 左键

• right : 右键

offset_x<int>横向偏移

offset_y<int>纵向偏移

调用样例- rpa.app.chrome.ChromeTab.ChromeElement.click-

# 注意事项：
# 1. 此方法需要确认已安装并启用Aliyun RPA对应的chrome扩展插件
# 2. 使用前需要确认已通过捕捉控件功能录制了页面元素
# 代码调用样例如下：
url = 'https://help.aliyun.com/document_detail/175379.html'
page = rpa.app.chrome.create(url)
element = page.get_element_by_name('登录按钮-chrome')

element.click()

double_click(simulate=True, offset_x=0, offset_y=0)

方法描述

双击

参数说明

simulate<bool>是否模拟点击

offset_x<int>横向偏移

offset_y<int>纵向偏移

调用样例- rpa.app.chrome.ChromeTab.ChromeElement.double_click-

# 注意事项：
# 1. 此方法需要确认已安装并启用Aliyun RPA对应的chrome扩展插件
# 2. 使用前需要确认已通过捕捉控件功能录制了页面元素
# 代码调用样例如下：
url = 'https://help.aliyun.com/document_detail/175379.html'
page = rpa.app.chrome.create(url)
element = page.get_element_by_name('queryClientViews-chrome')

element.double_click()

input_text(value, simulate=True, replace=True, sent_raw=False, wait_mili_seconds=20)

方法描述

输入文本

参数说明

value<str>输入的内容

simulate<bool>是否模拟输入

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

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

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

调用样例- rpa.app.chrome.ChromeTab.ChromeElement.input_text-

# 注意事项：
# 1. 此方法需要确认已安装并启用Aliyun RPA对应的chrome扩展插件
# 2. 使用前需要确认已通过捕捉控件功能录制了页面元素
# 代码调用样例如下：
url = 'www.baidu.com'
page = rpa.app.chrome.create(url)
element = page.get_element_by_name('百度输入框-chrome')

element.input_text('阿里云RPA')

input_hotkeys(value)

方法描述

输入快捷键

参数说明

value<str>输入的内容

调用样例- rpa.app.chrome.ChromeTab.ChromeElement.input_hotkeys-

# 注意事项：
# 1. 此方法需要确认已安装并启用Aliyun RPA对应的chrome扩展插件
# 2. 使用前需要确认已通过捕捉控件功能录制了页面元素
# 3. 虚拟键码表请参考：https://www.yuque.com/aliyun_rpa/quzm63/vk
# 代码调用样例如下：
url = 'www.taobao.com'
page = rpa.app.chrome.create(url)
element = page.get_element_by_name('淘宝输入框-chrome')
element.input_text('阿里云')

element.input_hotkeys('VK_RETURN')

download(path, suffix=None, prepare_timeout=10, complete_timeout=120)

方法描述

点击控件开始下载，并等待下载结束

参数说明

path<str>下载结果存放的完整文件路径

suffix<str>文件名后缀格式

可选项：

• datetime: 日期时间 （年月日时分）

• date: 日期（年月日）

prepare_timeout<int>等待进入下载的超时时间

complete_timeout<int>等待下载完成的超时时间

返回值说明

返回是否下载成功<bool>

调用样例- rpa.app.chrome.ChromeTab.ChromeElement.download-

# 注意事项：
# 1. 此方法需要确认已安装并启用Aliyun RPA对应的chrome扩展插件
# 2. 使用前需要确认已通过捕捉控件功能录制了页面元素
# 代码调用样例如下：
url = 'http://www.cninfo.com.cn/new/disclosure/detail?plate=hke&orgId=9900042435&stockCode=09988&announcementId=1209275224'
page = rpa.app.chrome.create(url)
element = page.get_element_by_name('公告下载-chrome')
download_path = r'D:\阿里巴巴-SW-公开资料.pdf'

element.download(download_path)

upload(file)

方法描述

点击控件开始上传，并等待上传结束

参数说明

file<str>上传文件完整路径

调用样例- rpa.app.chrome.ChromeTab.ChromeElement.upload-

# 注意事项：
# 1. 此方法需要确认已安装并启用Aliyun RPA对应的chrome扩展插件
# 2. 使用前需要确认已通过捕捉控件功能录制了页面元素
# 代码调用样例如下：
url = 'https://duguang.aliyun.com/experience?type=standard&subtype=idcard#intro'
page = rpa.app.chrome.create(url)
upload_path = r'D:\2_测试文件归档\OCR身份证识别.jpg'
element = page.get_element_by_name('上传图片-chrome')

element .upload(upload_path)

execute_js(code)

方法描述

执行js代码

参数说明

code<str>js代码

返回值说明

返回执行结果（JSON字符串形式）<str>

调用样例- rpa.app.chrome.ChromeTab.ChromeElement.execute_js-

# 注意事项：
# 1. 此方法需要确认已安装并启用Aliyun RPA对应的chrome扩展插件
# 2. 使用前需要确认已通过捕捉控件功能录制了页面元素
# 代码调用样例如下：
url = 'www.baidu.com'
page = rpa.app.chrome.create(url)
js = """
var div1 = document.getElementById("su");
div1.style.display = "none";
"""
element = page.get_element_by_name('百度一下-chrome')

element.execute_js(js)

text()

方法描述

获取元素内容文本

返回值说明

返回元素内容文本<str>

调用样例- rpa.app.chrome.ChromeTab.ChromeElement.text-

# 注意事项：
# 1. 此方法需要确认已安装并启用Aliyun RPA对应的chrome扩展插件
# 2. 使用前需要确认已通过捕捉控件功能录制了页面元素
# 代码调用样例如下：
url = 'www.baidu.com'
page = rpa.app.chrome.create(url)
element = page.get_element_by_name('百度一下-chrome')

text = element.text()

html()

方法描述

获取元素HTML源代码

返回值说明

返回元素内容文本<str>

调用样例- rpa.app.chrome.ChromeTab.ChromeElement.html-

# 注意事项：
# 1. 此方法需要确认已安装并启用Aliyun RPA对应的chrome扩展插件
# 2. 使用前需要确认已通过捕捉控件功能录制了页面元素
# 代码调用样例如下：
url = 'www.baidu.com'
page = rpa.app.chrome.create(url)
element = page.get_element_by_name('百度一下-chrome')

html= element.html()

value()

方法描述

获取元素值

返回值说明

返回元素值<str>

调用样例- rpa.app.chrome.ChromeTab.ChromeElement.value-

# 注意事项：
# 1. 此方法需要确认已安装并启用Aliyun RPA对应的chrome扩展插件
# 2. 使用前需要确认已通过捕捉控件功能录制了页面元素
# 3. 此方法获取的是对应元素的html标签中value属性的值
# 代码调用样例如下：
url = 'www.baidu.com'
page = rpa.app.chrome.create(url)
element = page.get_element_by_name('百度一下-chrome')

value= element.value()

option(text, type='match')

方法描述

通过文本下拉框选择

参数说明

text<str>选择内容

type<str>匹配类型

可选项：

• match : 模糊匹配

• full : 完全匹配

• regex : 正则匹配

调用样例- rpa.app.chrome.ChromeTab.ChromeElement.option-

# 注意事项：
# 1. 此方法需要确认已安装并启用Aliyun RPA对应的chrome扩展插件
# 2. 使用前需要确认已通过捕捉控件功能录制了页面元素
# 3. 需确认下拉框中存在对应的文本选项
# 代码调用样例如下：
url = 'https://kyfw.12306.cn/otn/leftTicket/init'
page = rpa.app.chrome.create(url)
element = page.get_element_by_name('下拉框-时刻表-chrome')

element.option('00:00--06:00')

option_by_index(item_index)

方法描述

通过索引设置下拉框选项

参数说明

item_index<int>选项索引，从1开始

调用样例- rpa.app.chrome.ChromeTab.ChromeElement.option_by_index-

# 注意事项：
# 1. 此方法需要确认已安装并启用Aliyun RPA对应的chrome扩展插件
# 2. 使用前需要确认已通过捕捉控件功能录制了页面元素
# 3. 需确认下拉框中选项个数，索引从1计算，不能超过选项最大个数
# 代码调用样例如下：
url = 'https://kyfw.12306.cn/otn/leftTicket/init'
page = rpa.app.chrome.create(url)
element = page.get_element_by_name('下拉框-时刻表-chrome')

element.option_by_index(2)

get_options(mode='selected')

方法描述

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

参数说明

mode<str>返回类型

可选项：

• selected : 选中项

• all : 所有项

返回值说明

返回选项集合<list>

调用样例- rpa.app.chrome.ChromeTab.ChromeElement.get_options-

# 注意事项：
# 1. 此方法需要确认已安装并启用Aliyun RPA对应的chrome扩展插件
# 2. 使用前需要确认已通过捕捉控件功能录制了页面元素
# 代码调用样例如下：
url = 'https://kyfw.12306.cn/otn/leftTicket/init'
page = rpa.app.chrome.create(url)
element = page.get_element_by_name('下拉框-时刻表-chrome')

options = element.get_options()

get_checked_state()

方法描述

获取勾选状态

返回值说明

返回勾选状态<bool>

调用样例- rpa.app.chrome.ChromeTab.ChromeElement.get_checked_state-

# 注意事项：
# 1. 此方法需要确认已安装并启用Aliyun RPA对应的chrome扩展插件
# 2. 使用前需要确认已通过捕捉控件功能录制了页面元素
# 代码调用样例如下：
url = 'https://kyfw.12306.cn/otn/leftTicket/init'
page = rpa.app.chrome.create(url)
element = page.get_element_by_name('复选框-动车-chrome')

check_state = element.get_checked_state()

set_checked_state(value=True)

方法描述

设置勾选状态

参数说明

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

调用样例- rpa.app.chrome.ChromeTab.ChromeElement.set_checked_state-

# 注意事项：
# 1. 此方法需要确认已安装并启用Aliyun RPA对应的chrome扩展插件
# 2. 使用前需要确认已通过捕捉控件功能录制了页面元素
# 代码调用样例如下：
url = 'https://kyfw.12306.cn/otn/leftTicket/init'
page = rpa.app.chrome.create(url)
element = page.get_element_by_name('复选框-动车-chrome')

element.set_checked_state(False)

attr(name)

方法描述

获取属性

参数说明

name<str>属性名

返回值说明

返回属性<str>

调用样例- rpa.app.chrome.ChromeTab.ChromeElement.attr-

# 注意事项：
# 1. 此方法需要确认已安装并启用Aliyun RPA对应的chrome扩展插件
# 2. 使用前需要确认已通过捕捉控件功能录制了页面元素
# 代码调用样例如下：
url = 'https://help.aliyun.com/document_detail/175379.html'
page = rpa.app.chrome.create(url)
element = page.get_element_by_name('登录按钮-chrome')

attribute = element.attr('class')

pos()

方法描述

获取控件坐标

调用样例- rpa.app.chrome.ChromeTab.ChromeElement.pos-

# 注意事项：
# 1. 此方法需要确认已安装并启用Aliyun RPA对应的chrome扩展插件
# 2. 使用前需要确认已通过捕捉控件功能录制了页面元素
# 代码调用样例如下：
url = 'https://help.aliyun.com/document_detail/175379.html'
page = rpa.app.chrome.create(url)
element = page.get_element_by_name('登录按钮-chrome')

pos_dict = element.pos()

screenshot(file)

方法描述

控件截图

参数说明

file<str>保存的截图路径

调用样例- rpa.app.chrome.ChromeTab.ChromeElement.screenshot-

# 注意事项：
# 1. 此方法需要确认已安装并启用Aliyun RPA对应的chrome扩展插件
# 2. 使用前需要确认已通过捕捉控件功能录制了页面元素
# 代码调用样例如下：
url = 'https://help.aliyun.com/document_detail/175379.html'
page = rpa.app.chrome.create(url)
element = page.get_element_by_name('登录按钮-chrome')
save_path = r'D:\阿里云登录按钮.jpg'

element .screenshot(save_path)

mouse_move()

方法描述

鼠标移入

调用样例- rpa.app.chrome.ChromeTab.ChromeElement.mouse_move-

# 注意事项：
# 1. 此方法需要确认已安装并启用Aliyun RPA对应的chrome扩展插件
# 2. 使用前需要确认已通过捕捉控件功能录制了页面元素
# 代码调用样例如下：
url = 'https://help.aliyun.com/document_detail/175379.html'
page = rpa.app.chrome.create(url)
element = page.get_element_by_name('登录按钮-chrome')

element .mouse_move()

isvisible()

方法描述

获取控件是否可见

返回值说明

返回控件是否可见<bool>

调用样例- rpa.app.chrome.ChromeTab.ChromeElement.isvisible-

# 注意事项：
# 1. 此方法需要确认已安装并启用Aliyun RPA对应的chrome扩展插件
# 2. 使用前需要确认已通过捕捉控件功能录制了页面元素
# 代码调用样例如下，本例中先使用js代码将元素设为不可见，然后再使用此方法：
url = 'https://help.aliyun.com/document_detail/175379.html'
page = rpa.app.chrome.create(url)
element = page.get_element_by_name('登录按钮-chrome')
js = """
var div1 = document.getElementById("su");
div1.style.display = "none";
"""
element.excute_js(js)

flag = element.isvisible()

drag(x=0, y=0,speed_mode='uniform')

方法描述

将元素拖拽到指定的位置

参数说明

x<int>x轴偏移量

y<int>y轴偏移量

speed_mode<str>拖拽的速度模式

• uniform：匀速拖拽

• fast-slow-pause：先加速拖动，然后减速拖动，最后停顿对准（模拟人拖动的速度模式）

调用样例- rpa.app.chrome.ChromeTab.ChromeElement.drag-

# 注意事项：
# 1. 此方法需要确认已安装并启用Aliyun RPA对应的chrome扩展插件
# 2. 使用前需要确认已通过捕捉控件功能录制了页面元素
# 代码调用样例如下：
url = 'https://help.aliyun.com/document_detail/175379.html'
page = rpa.app.chrome.create(url)
element = page.get_element_by_name('登录按钮-chrome')

element.drag(x=-500,y=100)

clear()

方法描述

清空输入框

调用样例- rpa.app.chrome.ChromeTab.ChromeElement.clear-

# 注意事项：
# 1. 此方法需要确认已安装并启用Aliyun RPA对应的chrome扩展插件
# 2. 使用前需要确认已通过捕捉控件功能录制了页面元素
# 代码调用样例如下：
url = 'www.baidu.com'
page = rpa.app.chrome.create(url)
element = page.get_element_by_name('百度输入框-chrome')

element.clear()