Selenium之動作鏈（ActionChains）

用selenium做自動化，有時候會遇到需要模擬鼠標操作才能進行的情況，比如單擊、雙擊、點擊鼠標右鍵、拖拽等等。而selenium給我們提供了一個類來處理這類事件——ActionChains

 

selenium.webdriver.common.action_chains.ActionChains(driver)

 

 

這個類基本能夠滿足我們所有對鼠標操作的需求。

1.ActionChains基本用法

首先需要了解ActionChains的執行原理，當你調用ActionChains的方法時，不會立即執行，而是會將所有的操作按順序存放在一個隊列里，當你調用perform()方法時，隊列中的時間會依次執行。

這種情況下我們可以有兩種調用方法：

鏈式寫法

menu = driver.find_element_by_css_selector(".nav")
hidden_submenu = driver.find_element_by_css_selector(".nav #submenu1")
ActionChains(driver).move_to_element(menu).click(hidden_submenu).perform()

 

分步寫法

menu = driver.find_element_by_css_selector(".nav")
hidden_submenu = driver.find_element_by_css_selector(".nav #submenu1")
actions = ActionChains(driver)
actions.move_to_element(menu)
actions.click(hidden_submenu)
actions.perform()

 

 

兩種寫法本質是一樣的，ActionChains都會按照順序執行所有的操作。

 

2.ActionChains方法列表

click(on_element=None) ——單擊鼠標左鍵
click_and_hold(on_element=None) ——點擊鼠標左鍵，不松開
context_click(on_element=None) ——點擊鼠標右鍵
double_click(on_element=None) ——雙擊鼠標左鍵
drag_and_drop(source, target) ——拖拽到某個元素然后松開
drag_and_drop_by_offset(source, xoffset, yoffset) ——拖拽到某個坐標然后松開
key_down(value, element=None) ——按下某個鍵盤上的鍵
key_up(value, element=None) ——松開某個鍵
move_by_offset(xoffset, yoffset) ——鼠標從當前位置移動到某個坐標
move_to_element(to_element) ——鼠標移動到某個元素
move_to_element_with_offset(to_element, xoffset, yoffset) ——移動到距某個元素（左上角坐標）多少距離的位置
perform() ——執行鏈中的所有動作
release(on_element=None) ——在某個元素位置松開鼠標左鍵
send_keys(*keys_to_send) ——發送某個鍵到當前焦點的元素
send_keys_to_element(element, *keys_to_send) ——發送某個鍵到指定元素

 

 

 

接下來用示例來詳細說明和演示每一個方法的用法：

3.代碼示例

1. 點擊操作

示例網址http://sahitest.com/demo/clicks.htm

代碼：

 

# -*- coding: utf-8 -*-
from selenium import webdriver
from selenium.webdriver.common.action_chains import ActionChains
from time import sleep
driver = webdriver.Firefox()
driver.implicitly_wait(10)
driver.maximize_window()
driver.get('http://sahitest.com/demo/clicks.htm')
click_btn = driver.find_element_by_xpath('//input[@value="click me"]')  # 單擊按鈕
doubleclick_btn = driver.find_element_by_xpath('//input[@value="dbl click me"]')  # 雙擊按鈕
rightclick_btn = driver.find_element_by_xpath('//input[@value="right click me"]')  # 右鍵單擊按鈕
ActionChains(driver).click(click_btn).double_click(doubleclick_btn).context_click(rightclick_btn).perform()  # 鏈式用法
print driver.find_element_by_name('t2').get_attribute('value')
sleep(2)
driver.quit() 

 

2.鼠標移動

 

示例網址http://sahitest.com/demo/mouseover.htm

示例代碼：

# -*- coding: utf-8 -*-​
from selenium import webdriver
from selenium.webdriver.common.action_chains import ActionChains
from time import sleep
​
driver = webdriver.Firefox()
driver.implicitly_wait(10)
driver.maximize_window()
driver.get('http://sahitest.com/demo/mouseover.htm')
​
write = driver.find_element_by_xpath('//input[@value="Write on hover"]')  # 鼠標移動到此元素，在下面的input框中會顯示“Mouse moved”
blank = driver.find_element_by_xpath('//input[@value="Blank on hover"]')  # 鼠標移動到此元素，會清空下面input框中的內容
​
result = driver.find_element_by_name('t1')
​
action = ActionChains(driver)
action.move_to_element(write).perform()  # 移動到write，顯示“Mouse moved”
print result.get_attribute('value')
​
# action.move_to_element(blank).perform()
action.move_by_offset(10, 50).perform()  # 移動到距離當前位置(10,50)的點，與上句效果相同，移動到blank上，清空
print result.get_attribute('value')
​
action.move_to_element_with_offset(blank, 10, -40).perform()  # 移動到距離blank元素(10,-40)的點，可移動到write上
print result.get_attribute('value')
​
sleep(2)
driver.quit()

 

 

 

一般很少用位置關系來移動鼠標，如果需要，可參考下面的鏈接來測量元素位置

http://jingyan.baidu.com/article/eb9f7b6d87e2ae869264e847.html

3.拖拽

示例網址:http://sahitest.com/demo/dragDropMooTools.htm

代碼：

# -*- coding: utf-8 -*-
​
from selenium import webdriver
from selenium.webdriver.common.action_chains import ActionChains
from time import sleep
​
driver = webdriver.Firefox()
driver.implicitly_wait(10)
driver.maximize_window()
driver.get('http://sahitest.com/demo/dragDropMooTools.htm')
​
dragger = driver.find_element_by_id('dragger')  # 被拖拽元素
item1 = driver.find_element_by_xpath('//div[text()="Item 1"]')  # 目標元素1
item2 = driver.find_element_by_xpath('//div[text()="Item 2"]')  # 目標2
item3 = driver.find_element_by_xpath('//div[text()="Item 3"]')  # 目標3
item4 = driver.find_element_by_xpath('//div[text()="Item 4"]')  # 目標4
​
action = ActionChains(driver)
action.drag_and_drop(dragger, item1).perform()  # 1.移動dragger到目標1
sleep(2)
action.click_and_hold(dragger).release(item2).perform()  # 2.效果與上句相同，也能起到移動效果
sleep(2)
action.click_and_hold(dragger).move_to_element(item3).release().perform()  # 3.效果與上兩句相同，也能起到移動的效果
sleep(2)
# action.drag_and_drop_by_offset(dragger, 400, 150).perform()  # 4.移動到指定坐標
action.click_and_hold(dragger).move_by_offset(400, 150).release().perform()  # 5.與上一句相同，移動到指定坐標
sleep(2)
driver.quit()

 

 

 

一般用坐標定位很少，用上例中的方法1足夠了，如果看源碼，會發現方法2其實就是方法1中的drag_and_drop()的實現。注意：拖拽使用時注意加等待時間，有時會因為速度太快而失敗。

4.按鍵

模擬按鍵有多種方法，能用win32api來實現，能用SendKeys來實現，也可以用selenium的WebElement對象的send_keys()方法來實現，這里ActionChains類也提供了幾個模擬按鍵的方法。

示例網址http://sahitest.com/demo/keypress.htm

代碼1：

# -*- coding: utf-8 -*-
​
from selenium import webdriver
from selenium.webdriver.common.action_chains import ActionChains
from time import sleep
​
driver = webdriver.Firefox()
driver.implicitly_wait(10)
driver.maximize_window()
driver.get('http://sahitest.com/demo/keypress.htm')
​
key_up_radio = driver.find_element_by_id('r1')  # 監測按鍵升起
key_down_radio = driver.find_element_by_id('r2')  # 監測按鍵按下
key_press_radio = driver.find_element_by_id('r3')  # 監測按鍵按下升起
​
enter = driver.find_elements_by_xpath('//form[@name="f1"]/input')[1]  # 輸入框
result = driver.find_elements_by_xpath('//form[@name="f1"]/input')[0]  # 監測結果
​
# 監測key_down
key_down_radio.click()
ActionChains(driver).key_down(Keys.CONTROL, enter).key_up(Keys.CONTROL).perform()
print result.get_attribute('value')
​
# 監測key_up
key_up_radio.click()
enter.click()
ActionChains(driver).key_down(Keys.SHIFT).key_up(Keys.SHIFT).perform()
print result.get_attribute('value')
​
# 監測key_press
key_press_radio.click()
enter.click()
ActionChains(driver).send_keys('a').perform()
print result.get_attribute('value')
driver.quit()

 示例網址http://sahitest.com/demo/label.htm

 

代碼：

# -*- coding: utf-8 -*-
​
from selenium import webdriver
from selenium.webdriver.common.action_chains import ActionChains
from selenium.webdriver.common.keys import Keys
from time import sleep
​
driver = webdriver.Firefox()
driver.implicitly_wait(10)
driver.maximize_window()
​
driver.get('http://sahitest.com/demo/label.htm')
​
input1 = driver.find_elements_by_tag_name('input')[3]
input2 = driver.find_elements_by_tag_name('input')[4]
​
action = ActionChains(driver)
input1.click()
action.send_keys('Test Keys').perform()
action.key_down(Keys.CONTROL).send_keys('a').key_up(Keys.CONTROL).perform()  # ctrl+a
action.key_down(Keys.CONTROL).send_keys('c').key_up(Keys.CONTROL).perform()  # ctrl+c
​
action.key_down(Keys.CONTROL, input2).send_keys('v').key_up(Keys.CONTROL).perform()  # ctrl+v
​
print input1.get_attribute('value')
print input2.get_attribute('value')
driver.quit()

  

復制粘貼用WebElement< input >.send_keys()也能實現，大家可以試一下，也可以用更底層的方法，同時也是os彈框的處理辦法之一的win32api，有興趣也可以試試SendKeys、keybd_event

 

3.ActionChains處理滾動條

selenium並不是萬能的，有時候頁面上操作無法實現的，這時候就需要借助JS來完成了。

　　當頁面上的元素超過一屏后，想操作屏幕下方的元素，是不能直接定位到，會報元素不可見的。這時候需要借助滾動條來拖動屏幕，使被操作的元素顯示在當前的屏幕上。滾動條是無法直接用定位工具來定位的。selenium里面也沒有直接的方法去控制滾動條，這時候只能借助Js代碼了，還好selenium提供了一個操作js的方法:execute_script()，可以直接執行js的腳本。

 

 

一、控制滾動條高度

 

　　1.滾動條回到頂部：

 

js="var q=document.getElementById('id').scrollTop=0"
browers.execute_script(js）

　　2.滾動條拉到底部

 

self.browser.execute_script('window.scrollTo(0, document.body.scrollHeight)')

 

　　二、橫向滾動條
　　　　1.有時候瀏覽器頁面需要左右滾動（一般屏幕最大化后，左右滾動的情況已經很少見了）。
　　　　2.通過左邊控制橫向和縱向滾動條scrollTo(x, y）js = "window.scrollTo(100,400);"

　　　　driver.execute_script(js)

　　三、元素聚焦

　　　　雖然用上面的方法可以解決拖動滾動條的位置問題，但是有時候無法確定我需要操作的元素在什么位置，有可能每次打開的頁面不一樣，元素所在的位置也不一樣，怎么辦呢？這個時候我們可以先讓頁面直接跳到元素出現的位置，然后就可以操作了。

　　　　同樣需要借助JS去實現。 具體如下：

　　　　target = driver.find_element_by_xxxx()
　　　　driver.execute_script("arguments[0].scrollIntoView();", target)

　　四、參考代碼

　　

　　例如定位id =J_ItemList的元素