現(xiàn)在越來越多的 web app 使用 AJAX 技術(shù)鹏往。當(dāng)一個頁面加載到瀏覽器后模她,這個頁面的很多元素加載的時間可能不一致左医。這就使得元素定位比較尷尬了,如果某個要定位的元素還沒有加載出來鸭栖,在定位的時候,就會拋出異常: ElementNotVisibleException握巢。這個時候晕鹊,合理使用 wait ,我們就能很好的緩解這個尷尬。Selenium Webdriver 提供了兩種類型的等待方法:隱式等待(implicit) 和 顯示等待(explicit)溅话。 顯示等待情況下晓锻,只有特定條件觸發(fā)后,WebDriver 才會繼續(xù)執(zhí)行后續(xù)操作飞几。隱式等待情況下砚哆,WebDriver 等待一定時間,該時間段內(nèi)屑墨,如果特定元素沒加載成功躁锁,則拋出異常。
1. Explicit Waits(顯示等待)
顯示等待的代碼定義了等待條件卵史,只有該條件觸發(fā)灿里,才執(zhí)行后續(xù)代碼。最垃圾的顯示等待就是使用 time.sleep()程腹,這種情況是指定了固定的等待時長匣吊。 存在一些特別方便的方法,可以使你的代碼只等待需要的時常寸潦,而不是固定的時常色鸳。WebDriverWait 和 ExpectedCondition 組合使用,就是一種有效的解決手段见转。
from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
driver = webdriver.Firefox()driver.get("http://somedomain/url_that_delays_loading")
try:
element = WebDriverWait(driver, 10).until(
EC.presence_of_element_located((By.ID, "myDynamicElement")))
finally:
driver.quit()
上面的代碼最多等待 10 秒观腊,超時后就拋出 TimeoutException,假設(shè)在第3秒就找到了這個元素撑螺,那么也就不會多等剩下的7秒使時間蝇恶,而是繼續(xù)執(zhí)行后續(xù)代碼。WebDriverWait 默認(rèn)每 500 毫秒調(diào)用一次 ExpectedCondition 中的方法乘客,直到它返回成功信號狐血,如果成功,則返回相應(yīng)的內(nèi)容易核,否則返回布爾類型的 False匈织。
from selenium.webdriver.support import expected_conditions as EC
wait_result = WebDriverWait(driver=self.driver, timeout=300, poll_frequency=0.5, ignored_exceptions=None).until(
EC.text_to_be_present_in_element((By.XPATH, '//*[@id="VolumeTable"]/tbody/tr[1]/td[4]/label'), u'可用'))
driver:瀏覽器驅(qū)動
timeout:最長超時等待時間
poll_frequency:檢測的時間間隔,默認(rèn)為500ms
ignore_exception:超時后拋出的異常信息牡直,默認(rèn)情況下拋 NoSuchElementException 異常
配合使用的 until() 或者 until_not() 方法說明:
- until(method, message='')
調(diào)用該方法體提供的回調(diào)函數(shù)作為一個參數(shù)缀匕,直到返回值為True - until_not(method, message='')
調(diào)用該方法體提供的回調(diào)函數(shù)作為一個參數(shù),直到返回值為False
模塊包含一套預(yù)定義的條件集合碰逸。大大方便了 WebDriverWait 的使用乡小。
Expected Conditions 類提供的預(yù)期條件判斷方法
在進(jìn)行瀏覽器自動化的時候,有一些條件是經(jīng)常出現(xiàn)的饵史,下面列出的是每個條件的實現(xiàn)满钟。Selenium Python binding provides some convienence 提供了很多實用的方法掸哑,因此,你無須再去編寫 expected_condition class 或是創(chuàng)建你自己的工具包來實現(xiàn)這個工作零远。
- title_is:判斷當(dāng)前頁面的title是否等于預(yù)期
- title_contains:判斷當(dāng)前頁面的title是否包含預(yù)期字符串
- presence_of_element_located:判斷某個元素是否被加到了dom樹里苗分,并不代表該元素一定可見
- visibility_of_element_located:判斷某個元素是否可見. 可見代表元素非隱藏,并且元素的寬和高都不等于0
- visibility_of:跟上面的方法做一樣的事情牵辣,只是上面的方法要傳入locator摔癣,這個方法直接傳定位到的element就好了
- presence_of_all_elements_located:判斷是否至少有1個元素存在于dom樹中。舉個例子纬向,如果頁面上有n個元素的class都是'column-md-3'择浊,那么只要有1個元素存在,這個方法就返回True
- text_to_be_present_in_element:判斷某個元素中的text是否 包含 了預(yù)期的字符串
- text_to_be_present_in_element_value:判斷某個元素中的value屬性是否包含了預(yù)期的字符串
- frame_to_be_available_and_switch_to_it:判斷該frame是否可以switch進(jìn)去逾条,如果可以的話琢岩,返回True并且switch進(jìn)去,否則返回False
- invisibility_of_element_located:判斷某個元素中是否不存在于dom樹或不可見
- element_to_be_clickable - it is Displayed and Enabled:判斷某個元素中是否可見并且是enable的师脂,這樣的話才叫clickable
- staleness_of:等某個元素從dom樹中移除担孔,注意,這個方法也是返回True或False
- element_to_be_selected:判斷某個元素是否被選中了,一般用在下拉列表
- element_located_to_be_selected
- element_selection_state_to_be:判斷某個元素的選中狀態(tài)是否符合預(yù)期
- element_located_selection_state_to_be:跟上面的方法作用一樣吃警,只是上面的方法傳入定位到的element糕篇,而這個方法傳入locator
- alert_is_present:判斷頁面上是否存在alert
2. Implicit Waits(隱式等待)
隱式等待是在嘗試發(fā)現(xiàn)某個元素的時候,如果沒能立刻發(fā)現(xiàn)酌心,就等待固定長度的時間拌消。默認(rèn)設(shè)置是0秒。一旦設(shè)置了隱式等待時間安券,它的作用范圍就是Webdriver對象實例的整個生命周期墩崩。
from selenium import webdriver
driver = webdriver.Firefox()
driver.implicitly_wait(10) # seconds
driver.get("http://somedomain/url_that_delays_loading")
myDynamicElement = driver.find_element_by_id("myDynamicElement")