ChromeElement
scroll_into_view
scroll_into_view()
方法描述
將元素調(diào)整到可視區(qū)域
調(diào)用樣例- rpa.app.chrome.ChromeTab.ChromeElement.scroll_into_view-
# 注意事項:
# 1. 此方法需要確認(rèn)已安裝并啟用Aliyun RPA對應(yīng)的chrome擴展插件
# 2. 使用前需要確認(rèn)已通過捕捉控件功能錄制了頁面元素
# 代碼調(diào)用樣例如下:
url = 'http://bestwisewords.com/document_detail/175379.html'
page = rpa.app.chrome.create(url)
element = page.get_element_by_name('網(wǎng)頁底部-售前咨詢-chrome')
element.scroll_into_view()
click
click(simulate=True, button='left', offset_x=0, offset_y=0)
方法描述
點擊
參數(shù)說明
simulate<bool>是否模擬點擊
button<str>鼠標(biāo)鍵位
可選項:
left : 左鍵
right : 右鍵
offset_x<int>橫向偏移
offset_y<int>縱向偏移
調(diào)用樣例- rpa.app.chrome.ChromeTab.ChromeElement.click-
# 注意事項:
# 1. 此方法需要確認(rèn)已安裝并啟用Aliyun RPA對應(yīng)的chrome擴展插件
# 2. 使用前需要確認(rèn)已通過捕捉控件功能錄制了頁面元素
# 代碼調(diào)用樣例如下:
url = 'http://bestwisewords.com/document_detail/175379.html'
page = rpa.app.chrome.create(url)
element = page.get_element_by_name('登錄按鈕-chrome')
element.click()
double_click
double_click(simulate=True, offset_x=0, offset_y=0)
方法描述
雙擊
參數(shù)說明
simulate<bool>是否模擬點擊
offset_x<int>橫向偏移
offset_y<int>縱向偏移
調(diào)用樣例- rpa.app.chrome.ChromeTab.ChromeElement.double_click-
# 注意事項:
# 1. 此方法需要確認(rèn)已安裝并啟用Aliyun RPA對應(yīng)的chrome擴展插件
# 2. 使用前需要確認(rèn)已通過捕捉控件功能錄制了頁面元素
# 代碼調(diào)用樣例如下:
url = 'http://bestwisewords.com/document_detail/175379.html'
page = rpa.app.chrome.create(url)
element = page.get_element_by_name('queryClientViews-chrome')
element.double_click()
input_text
input_text(value, simulate=True, replace=True, sent_raw=False, wait_mili_seconds=20)
方法描述
輸入文本
參數(shù)說明
value<str>輸入的內(nèi)容
simulate<bool>是否模擬輸入
replace<bool>是否清空之前的內(nèi)容
sent_raw<bool>是否發(fā)送原始按鍵,僅非模擬模式有效
wait_mili_seconds<int>字符間輸入間隔(毫秒),僅在模擬輸入下有效,默認(rèn)值為20,最大值100,該值設(shè)置過大可能會引起超時
調(diào)用樣例- rpa.app.chrome.ChromeTab.ChromeElement.input_text-
# 注意事項:
# 1. 此方法需要確認(rèn)已安裝并啟用Aliyun RPA對應(yīng)的chrome擴展插件
# 2. 使用前需要確認(rèn)已通過捕捉控件功能錄制了頁面元素
# 代碼調(diào)用樣例如下:
url = 'www.baidu.com'
page = rpa.app.chrome.create(url)
element = page.get_element_by_name('百度輸入框-chrome')
element.input_text('阿里云RPA')
input_hotkeys
input_hotkeys(value)
方法描述
輸入快捷鍵
參數(shù)說明
value<str>輸入的內(nèi)容
調(diào)用樣例- rpa.app.chrome.ChromeTab.ChromeElement.input_hotkeys-
# 注意事項:
# 1. 此方法需要確認(rèn)已安裝并啟用Aliyun RPA對應(yīng)的chrome擴展插件
# 2. 使用前需要確認(rèn)已通過捕捉控件功能錄制了頁面元素
# 3. 虛擬鍵碼表請參考:https://www.yuque.com/aliyun_rpa/quzm63/vk
# 代碼調(diào)用樣例如下:
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
download(path, suffix=None, prepare_timeout=10, complete_timeout=120)
方法描述
點擊控件開始下載,并等待下載結(jié)束
參數(shù)說明
path<str>下載結(jié)果存放的完整文件路徑
suffix<str>文件名后綴格式
可選項:
datetime: 日期時間 (年月日時分)
date: 日期(年月日)
prepare_timeout<int>等待進(jìn)入下載的超時時間
complete_timeout<int>等待下載完成的超時時間
返回值說明
返回是否下載成功<bool>
調(diào)用樣例- rpa.app.chrome.ChromeTab.ChromeElement.download-
# 注意事項:
# 1. 此方法需要確認(rèn)已安裝并啟用Aliyun RPA對應(yīng)的chrome擴展插件
# 2. 使用前需要確認(rèn)已通過捕捉控件功能錄制了頁面元素
# 代碼調(diào)用樣例如下:
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
upload(file)
方法描述
點擊控件開始上傳,并等待上傳結(jié)束
參數(shù)說明
file<str>上傳文件完整路徑
調(diào)用樣例- rpa.app.chrome.ChromeTab.ChromeElement.upload-
# 注意事項:
# 1. 此方法需要確認(rèn)已安裝并啟用Aliyun RPA對應(yīng)的chrome擴展插件
# 2. 使用前需要確認(rèn)已通過捕捉控件功能錄制了頁面元素
# 代碼調(diào)用樣例如下:
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
execute_js(code)
方法描述
執(zhí)行js代碼
參數(shù)說明
code<str>js代碼
返回值說明
返回執(zhí)行結(jié)果(JSON字符串形式)<str>
調(diào)用樣例- rpa.app.chrome.ChromeTab.ChromeElement.execute_js-
# 注意事項:
# 1. 此方法需要確認(rèn)已安裝并啟用Aliyun RPA對應(yīng)的chrome擴展插件
# 2. 使用前需要確認(rèn)已通過捕捉控件功能錄制了頁面元素
# 代碼調(diào)用樣例如下:
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
text()
方法描述
獲取元素內(nèi)容文本
返回值說明
返回元素內(nèi)容文本<str>
調(diào)用樣例- rpa.app.chrome.ChromeTab.ChromeElement.text-
# 注意事項:
# 1. 此方法需要確認(rèn)已安裝并啟用Aliyun RPA對應(yīng)的chrome擴展插件
# 2. 使用前需要確認(rèn)已通過捕捉控件功能錄制了頁面元素
# 代碼調(diào)用樣例如下:
url = 'www.baidu.com'
page = rpa.app.chrome.create(url)
element = page.get_element_by_name('百度一下-chrome')
text = element.text()
html
html()
方法描述
獲取元素HTML源代碼
返回值說明
返回元素內(nèi)容文本<str>
調(diào)用樣例- rpa.app.chrome.ChromeTab.ChromeElement.html-
# 注意事項:
# 1. 此方法需要確認(rèn)已安裝并啟用Aliyun RPA對應(yīng)的chrome擴展插件
# 2. 使用前需要確認(rèn)已通過捕捉控件功能錄制了頁面元素
# 代碼調(diào)用樣例如下:
url = 'www.baidu.com'
page = rpa.app.chrome.create(url)
element = page.get_element_by_name('百度一下-chrome')
html= element.html()
value
value()
方法描述
獲取元素值
返回值說明
返回元素值<str>
調(diào)用樣例- rpa.app.chrome.ChromeTab.ChromeElement.value-
# 注意事項:
# 1. 此方法需要確認(rèn)已安裝并啟用Aliyun RPA對應(yīng)的chrome擴展插件
# 2. 使用前需要確認(rèn)已通過捕捉控件功能錄制了頁面元素
# 3. 此方法獲取的是對應(yīng)元素的html標(biāo)簽中value屬性的值
# 代碼調(diào)用樣例如下:
url = 'www.baidu.com'
page = rpa.app.chrome.create(url)
element = page.get_element_by_name('百度一下-chrome')
value= element.value()
option
option(text, type='match')
方法描述
通過文本下拉框選擇
參數(shù)說明
text<str>選擇內(nèi)容
type<str>匹配類型
可選項:
match : 模糊匹配
full : 完全匹配
regex : 正則匹配
調(diào)用樣例- rpa.app.chrome.ChromeTab.ChromeElement.option-
# 注意事項:
# 1. 此方法需要確認(rèn)已安裝并啟用Aliyun RPA對應(yīng)的chrome擴展插件
# 2. 使用前需要確認(rèn)已通過捕捉控件功能錄制了頁面元素
# 3. 需確認(rèn)下拉框中存在對應(yīng)的文本選項
# 代碼調(diào)用樣例如下:
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
option_by_index(item_index)
方法描述
通過索引設(shè)置下拉框選項
參數(shù)說明
item_index<int>選項索引,從1開始
調(diào)用樣例- rpa.app.chrome.ChromeTab.ChromeElement.option_by_index-
# 注意事項:
# 1. 此方法需要確認(rèn)已安裝并啟用Aliyun RPA對應(yīng)的chrome擴展插件
# 2. 使用前需要確認(rèn)已通過捕捉控件功能錄制了頁面元素
# 3. 需確認(rèn)下拉框中選項個數(shù),索引從1計算,不能超過選項最大個數(shù)
# 代碼調(diào)用樣例如下:
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
get_options(mode='selected')
方法描述
返回下拉框選中的值/所有的選項
參數(shù)說明
mode<str>返回類型
可選項:
selected : 選中項
all : 所有項
返回值說明
返回選項集合<list>
調(diào)用樣例- rpa.app.chrome.ChromeTab.ChromeElement.get_options-
# 注意事項:
# 1. 此方法需要確認(rèn)已安裝并啟用Aliyun RPA對應(yīng)的chrome擴展插件
# 2. 使用前需要確認(rèn)已通過捕捉控件功能錄制了頁面元素
# 代碼調(diào)用樣例如下:
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
get_checked_state()
方法描述
獲取勾選狀態(tài)
返回值說明
返回勾選狀態(tài)<bool>
調(diào)用樣例- rpa.app.chrome.ChromeTab.ChromeElement.get_checked_state-
# 注意事項:
# 1. 此方法需要確認(rèn)已安裝并啟用Aliyun RPA對應(yīng)的chrome擴展插件
# 2. 使用前需要確認(rèn)已通過捕捉控件功能錄制了頁面元素
# 代碼調(diào)用樣例如下:
url = 'https://kyfw.12306.cn/otn/leftTicket/init'
page = rpa.app.chrome.create(url)
element = page.get_element_by_name('復(fù)選框-動車-chrome')
check_state = element.get_checked_state()
set_checked_state
set_checked_state(value=True)
方法描述
設(shè)置勾選狀態(tài)
參數(shù)說明
value<bool>傳入True則勾選,傳入False取消勾選
調(diào)用樣例- rpa.app.chrome.ChromeTab.ChromeElement.set_checked_state-
# 注意事項:
# 1. 此方法需要確認(rèn)已安裝并啟用Aliyun RPA對應(yīng)的chrome擴展插件
# 2. 使用前需要確認(rèn)已通過捕捉控件功能錄制了頁面元素
# 代碼調(diào)用樣例如下:
url = 'https://kyfw.12306.cn/otn/leftTicket/init'
page = rpa.app.chrome.create(url)
element = page.get_element_by_name('復(fù)選框-動車-chrome')
element.set_checked_state(False)
attr
attr(name)
方法描述
獲取屬性
參數(shù)說明
name<str>屬性名
返回值說明
返回屬性<str>
調(diào)用樣例- rpa.app.chrome.ChromeTab.ChromeElement.attr-
# 注意事項:
# 1. 此方法需要確認(rèn)已安裝并啟用Aliyun RPA對應(yīng)的chrome擴展插件
# 2. 使用前需要確認(rèn)已通過捕捉控件功能錄制了頁面元素
# 代碼調(diào)用樣例如下:
url = 'http://bestwisewords.com/document_detail/175379.html'
page = rpa.app.chrome.create(url)
element = page.get_element_by_name('登錄按鈕-chrome')
attribute = element.attr('class')
pos
pos()
方法描述
獲取控件坐標(biāo)
調(diào)用樣例- rpa.app.chrome.ChromeTab.ChromeElement.pos-
# 注意事項:
# 1. 此方法需要確認(rèn)已安裝并啟用Aliyun RPA對應(yīng)的chrome擴展插件
# 2. 使用前需要確認(rèn)已通過捕捉控件功能錄制了頁面元素
# 代碼調(diào)用樣例如下:
url = 'http://bestwisewords.com/document_detail/175379.html'
page = rpa.app.chrome.create(url)
element = page.get_element_by_name('登錄按鈕-chrome')
pos_dict = element.pos()
screenshot
screenshot(file)
方法描述
控件截圖
參數(shù)說明
file<str>保存的截圖路徑
調(diào)用樣例- rpa.app.chrome.ChromeTab.ChromeElement.screenshot-
# 注意事項:
# 1. 此方法需要確認(rèn)已安裝并啟用Aliyun RPA對應(yīng)的chrome擴展插件
# 2. 使用前需要確認(rèn)已通過捕捉控件功能錄制了頁面元素
# 代碼調(diào)用樣例如下:
url = 'http://bestwisewords.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
mouse_move()
方法描述
鼠標(biāo)移入
調(diào)用樣例- rpa.app.chrome.ChromeTab.ChromeElement.mouse_move-
# 注意事項:
# 1. 此方法需要確認(rèn)已安裝并啟用Aliyun RPA對應(yīng)的chrome擴展插件
# 2. 使用前需要確認(rèn)已通過捕捉控件功能錄制了頁面元素
# 代碼調(diào)用樣例如下:
url = 'http://bestwisewords.com/document_detail/175379.html'
page = rpa.app.chrome.create(url)
element = page.get_element_by_name('登錄按鈕-chrome')
element .mouse_move()
isvisible
isvisible()
方法描述
獲取控件是否可見
返回值說明
返回控件是否可見<bool>
調(diào)用樣例- rpa.app.chrome.ChromeTab.ChromeElement.isvisible-
# 注意事項:
# 1. 此方法需要確認(rèn)已安裝并啟用Aliyun RPA對應(yīng)的chrome擴展插件
# 2. 使用前需要確認(rèn)已通過捕捉控件功能錄制了頁面元素
# 代碼調(diào)用樣例如下,本例中先使用js代碼將元素設(shè)為不可見,然后再使用此方法:
url = 'http://bestwisewords.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
drag(x=0, y=0,speed_mode='uniform')
方法描述
將元素拖拽到指定的位置
參數(shù)說明
x<int>x軸偏移量
y<int>y軸偏移量
speed_mode<str>拖拽的速度模式
uniform:勻速拖拽
fast-slow-pause:先加速拖動,然后減速拖動,最后停頓對準(zhǔn)(模擬人拖動的速度模式)
調(diào)用樣例- rpa.app.chrome.ChromeTab.ChromeElement.drag-
# 注意事項:
# 1. 此方法需要確認(rèn)已安裝并啟用Aliyun RPA對應(yīng)的chrome擴展插件
# 2. 使用前需要確認(rèn)已通過捕捉控件功能錄制了頁面元素
# 代碼調(diào)用樣例如下:
url = 'http://bestwisewords.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
clear()
方法描述
清空輸入框
調(diào)用樣例- rpa.app.chrome.ChromeTab.ChromeElement.clear-
# 注意事項:
# 1. 此方法需要確認(rèn)已安裝并啟用Aliyun RPA對應(yīng)的chrome擴展插件
# 2. 使用前需要確認(rèn)已通過捕捉控件功能錄制了頁面元素
# 代碼調(diào)用樣例如下:
url = 'www.baidu.com'
page = rpa.app.chrome.create(url)
element = page.get_element_by_name('百度輸入框-chrome')
element.clear()