1. 程式人生 > >selenium webdriver (python)大全

selenium webdriver (python)大全

... 窗口 修改 4.0 labels 下載安裝 update 移動 定位

webdriver的簡介


硒2.0的主要新功能是集成的webdriver的API。webdriver的設計除了解決一些seleniumr-RC API的一些限制,與webdriver 的整合,將提供一個更簡單,更簡潔的編程接口。selenium webdriver會更好地支持動態的網頁,頁面本身被重新加載頁面元素可能更改。webdriver的目標是提供一個設計良好的面向對象的API,提供了更好的支持現代先進的web-app測試。

WebDriver與Selenium-RC相比,是如何來驅動瀏覽器的?


selenium RC 的工作方式是為每一個支持的瀏覽器註入JavaScript函數,能過瀏覽器加載,然後在瀏覽器中使用javascripts來驅動AUT。

webdriver的不使用這種技術,它直接調用每個瀏覽器內置的自動化支持;對於不同瀏覽器的調用取決於瀏覽器本身,每個瀏覽器驅動的信息將會在後面的章節介紹。

webdriver 與selenium--server


你可能不需要selenium-server,這要看你怎麽用selenium-webdriver了;如果你只使用webdriver的API ,那麽是不需要selenium-server 的;如果你的測試和瀏覽器在同一臺機器上運行,並且只使用webdriver的API ,那麽也是不需要selenium-server的,webdriver 將直接運行瀏覽器。

但在有些情況下, Selenium-WebDriver是需要用到Selenium-Server 的:

· 您正在使用Selenium-Grid測試分發到多臺機器或虛擬機(VM)。

· 你連接到一臺遠程的計算機上,在一個特定有瀏覽器版本上運行

· 你不想用java(Python, C#, or Ruby)綁定,而想用HtmlUnit Driver

設置selenium webdriver項目


要安裝selenium 之後需要建立一個項目,這樣就可以使用selenium寫程序了你如何做到這一點取決於你的編程語言和開發環境。 (這裏只介紹python的環境配置)

Python


如果您正在使用Python測試自動化,那麽你可能已經熟悉在Python開發。那麽你可以使用下面的命令添加selenium到Python環境。

pip install selenium

selenium 是一個web的自動化測試工具,不少學習功能自動化的同學開始首選selenium ,相因為它相比QTP有諸多有點:

  • 免費,也不用再為破解QTP而大傷腦筋

  • 小巧,對於不同的語言它只是一個包而已,而QTP需要下載安裝1個多G 的程序。

  • 這也是最重要的一點,不管你以前更熟悉C、 java、ruby、python、或都是C# ,你都可以通過selenium完成自動化測試,而QTP只支持VBS

  • 支持多平臺:windows、linux、MAC ,支持多瀏覽器:ie、ff、safari、opera、chrome

  • 支持分布式測試用例的執行,可以把測試用例分布到不同的測試機器的執行,相當於分發機的功能。

關於更具體的環境配置可以參考我這篇文檔:

http://www.cnblogs.com/fnng/archive/2013/05/29/3106515.html

關於python開發的學習超出了本文的範圍,你可以通過python資源(官方文檔及其它相關資料、書籍)來快速的幫助你使用python進行自動化。

selenium webdriver的API介紹


註:這裏只貼python語言的代碼

webdriver的是一個Web應用程序測試自動化工具,用來驗證程序是否如預期的那樣執行。它的目的是提供一個友好的API,比selenium RC(1.0)API更容易使用,這將有助於使你的測試腳本更容易閱讀和維護。它不依賴於任何特定的測試框架,所以它可以用戶單元測試或者一個老式的“main”方法中。本節介紹webdriver的API,下面讓我們來幫助你熟悉它。

如果你已經設置了項目,你就會發現,webdriver的作用跟其它庫一樣:它是完全獨立的,你通常在使用之前不需要啟動任何額外的進程,或者運行任何安裝程序,如果使用Selenium-RC則要到代理服務器。

註:需要額外的驅動來使腳本在不同環境下運行:Chrome Driver, Opera Driver, Android Driver andiPhone Driver

現在我們來寫一些代碼。打開瀏覽器,輸入谷歌網頁,並在搜索框內輸入“Cheese” 點擊搜索,最後關閉瀏覽器。

from selenium import webdriver
from selenium.common.exceptions import TimeoutException
from selenium.webdriver.support.ui import WebDriverWait # available since 2.4.0
from selenium.webdriver.support import expected_conditions as EC # available since 2.26.0

# Create a new instance of the Firefox driver
driver = webdriver.Firefox()

# go to the google home page
driver.get("http://www.google.com")

# find the element that‘s name attribute is q (the google search box)
inputElement = driver.find_element_by_name("q")

# type in the search
inputElement.send_keys("Cheese!")

# submit the form (although google automatically searches now without submitting)
inputElement.submit()

# the page is ajaxy so the title is originally this:
print driver.title

try:
    # we have to wait for the page to refresh, the last thing that seems to be updated is the title
    WebDriverWait(driver, 10).until(EC.title_contains("cheese!"))

    # You should see "cheese! - Google Search"
    print driver.title

finally:
    driver.quit()

在下面的章節中,您將了解更多有關如何使用webdriver的東西,如如何使用瀏覽器的前進和後退功能(這在selenium 1.0中不能被很好的支持);以及如何使用框架和窗口測試網站。我們將會提供了更深入的討論和範例。

Selenium webdriver的API命令和操作


取回頁面

你可能使用webdriver想要做的第一件事是導航到一個頁面,通過“get”可以輕松的做到之一點

driver.get("http://www.google.com")

webdriver的運行依賴於幾個因素:包括操作系統/瀏覽器的組合,有時可能需要等待頁面加載。webdriver的在某些情況下,可能需要控制返回頁面的開始與加載時間。為了確保腳本的穩定性,需要等待的元素(S)在頁面中存在的 顯性和隱性的等待。

定位UI元素(WebElements)


參考:

http://www.cnblogs.com/fnng/archive/2012/01/12/2321117.html

自動化要想模擬用戶(人)的行為操作,首先需要識別並定位UI上的元素,每個元素都有特定屬性,webdriver就是通過識別元素的屬性來定位元素。

我們可以通過下面的一些屬性或方法來定定位元素:

ID


這是最有效和最優選的方式來定位一個元素。常見的陷阱,開發人員可以為元素設置非唯一的ID ,或通過自動生成ID ,應該避免這種情況。

如何通過ID的方式定位一個元素,看下面這樣的例子:

<div id="coolestWidgetEvah">...</div>

element = driver.find_element_by_id("coolestWidgetEvah")

or

from selenium.webdriver.common.by import By
element = driver.find_element(by=By.ID, value="coolestWidgetEvah")

By class name


“class ”是指DOM元素的屬性。但在實際使用中有很多相同類名的DOM元素,在發現多個相同類名的元素時,程序會默認選擇最先找到的第一個元素。

如何通過類名找到一個元素,看下面的例子:

<div class="cheese">
<span>Cheddar</span>
</div>
<div class="cheese">
<span>Gouda</span>
</div>

cheeses = driver.find_elements_by_class_name("cheese")

or

from selenium.webdriver.common.by import By
cheeses = driver.find_elements(By.CLASS_NAME, "cheese")

By tag name


DOM標簽名稱的元素。

具體方式如下面的例子:

<iframe src="..."></iframe>
frame = driver.find_element_by_tag_name("iframe")

or

from selenium.webdriver.common.by import By
frame = driver.find_element(By.TAG_NAME, "iframe")

By name

查找並匹配元素的name屬性


具體方式如下面的例子:

<input name="cheese" type="text"/>

cheese = driver.find_element_by_name("cheese")

or

from selenium.webdriver.common.by import By

cheese = driver.find_element(By.NAME, "cheese")


By link text

通過鏈接文本找到元素匹配


例子如下:

<a href="http://www.google.com/search?q=cheese">cheese</a>>
cheese = driver.find_element_by_link_text("cheese")

or
 
from selenium.webdriver.common.by import By
cheese = driver.find_element(By.LINK_TEXT, "cheese")

By Partial Link Text

通過查找部分鏈接文件匹配元素


例子如下:

<a href="http://www.google.com/search?q=cheese">search for cheese</a>>
cheese = driver.find_element_by_partial_link_text("cheese")

or

from selenium.webdriver.common.by import By
cheese = driver.find_element(By.PARTIAL_LINK_TEXT, "cheese")

By CSS


通過CSS的定位策略。默認情況下本機瀏覽器支持CSS定位,所以,請參考W3C CSS選擇器

http://www.w3.org/TR/CSS/#selectors 顯示一般可用的CSS選擇器的列表。如果瀏覽器沒有原生支持CSS查詢,可以使用Sizzle(Sizzle是一個純javascript CSS選擇器引擎)。目前,IE 6,7和FF3.0使用Sizzle的CSS查詢引擎。

註意:不是所有瀏覽器對CSS的支持都是一樣的,可能在一個瀏覽器中運行良好,切換到另一個瀏覽器則不然。

具體用法如下:

<div id="food">

<span class="dairy">milk</span>

<span class="dairy aged">cheese</span>

</div>



cheese = driver.find_element_by_css_selector("#food span.dairy.aged")


or

from selenium.webdriver.common.by import By
cheese = driver.find_element(By.CSS_SELECTOR, "#food span.dairy.aged")


By XPATH 

在高的級別上,盡可能的使用一個瀏覽器原生的webdriver XPath 的功能。在一些沒有本地的XPath支持的瀏覽器,我們已經提供了我們自己的實現。這可能會導致一些意想不到的行為,除非你知道各種XPath引擎的差異。

驅動標簽和屬性名稱屬性值本地的XPath支持
HtmlUnit Driver 小寫 當他們出現在HTML
Internet Explorer Driver 小寫 當他們出現在HTML 沒有
Firefox Driver 不區分大小寫 當他們出現在HTML

這點抽象,對於下面這段HTML 代碼來說:

<input type="text" name="example" />
<INPUT type="text" name="other" />
inputs = driver.find_elements_by_xpath("//input")

or

from selenium.webdriver.common.by import By
inputs = driver.find_elements(By.XPATH, "//input")

不同驅動對大小寫的支持:

XPath expressionHtmlUnit DriverFirefox DriverInternet Explorer Driver
//input 1 (“example”) 2 2
//INPUT 0 2 0

HTML元素有時並不需要顯式地聲明,因為他們默認為已知值的屬性。例如,“input”的標簽並不需要的“type”屬性,因為它默認為“text”。webdriver使用XPath時,你不應該期望能夠對這些隱含的屬性相匹配。

使用JavaScript


你可以執行任意javascript來找到一個元素,只要你返回一個DOM元素,它將自動轉換為一個WebElement對象。

簡單的例子,在頁面上加載了jQuery:

element = driver.execute_script("return $(‘.cheese‘)[0]")

在頁面上的每一個標簽查找所有輸入元素:

labels = driver.find_elements_by_tag_name("label")

inputs = driver.execute_script(

    "var labels = arguments[0], inputs = []; for (var i=0; i < labels.length; i++){" +

    "inputs.push(document.getElementById(labels[i].getAttribute(‘for‘))); } return inputs;", labels)

用戶輸入-填寫表單


我們已經看到了如何將文字輸入到一個文本或文本字段,但其他元素?您可以“切換”復選框的狀態,你可以使用“點擊”設置類似選擇的選項標記。處理SELECT標簽是不是太糟糕:

select = driver.find_element_by_tag_name("select")

allOptions = select.find_elements_by_tag_name("option")

for option in allOptions:

    print "Value is: " + option.get_attribute("value")

    option.click()

找到頁面上第一個“select”的元素,並通過每個選項依次循環,打印出它們的值。你會發現,這不是最有效處理SELECT元素的方式。在webdriver的支持類中,有一個名為“select”,它提供了一些有用的方法,來處理這些交互。

# available since 2.12

from selenium.webdriver.support.ui import Select

select = Select(driver.find_element_by_tag_name("select"))

select.deselect_all()

select.select_by_visible_text("Edam")

從頁面上第一個選擇開始取消所有選項,從第一個選擇頁面上的所有選項,然後選擇顯示的文本與“Edam” 的選項。

當你完成填寫表格,你可能要提交。我們需要找到“提交”按鈕,然後單擊它:

driver.find_element_by_id("submit").click()

另外,有方便的方法可以在webdriver的每個元素上的“提交”。如果調用此表單內的元素,webdriver通過的DOM按順序找到封閉的形式,然後調用該提交。如果該元素不是一種形式,那麽會拋出NoSuchElementException異常:

element.submit()

移動Windows和框架(Frames)


一些web應用程序有許多框架或多個窗口。通過webdriver的“switchTo”方法可以對他們呢進行移動操作。

driver.switch_to_window("windowName")

調用驅動程序現在解釋為被定向到特定的窗口。但是如何知道窗口的名字?以JavaScript或鏈接的方式打開它看看:

<a href="somewhere.html" target="windowName">Click here to open a new window</a>

另外,你也可以通過“window handle”的“switchTo().window()”方法。認識到這一點,那麽就可以遍歷所有打開的窗口,像這樣:

for handle in driver.window_handles:

    driver.switch_to_window(handle)

還可以切換從frames到frames(或到iframe中):

driver.switch_to_frame("frameName")

訪問子frames由一個圓點分隔的路徑,並且可以通過其索引指定frames。是:

driver.switch_to_frame("frameName.0.child")

would go to the frame named “child” of the first subframe of the frame called “frameName”.All frames are evaluated as if from top. -----實在不知道這個怎麽翻譯

彈出對話框


Selenium 2.0測試版一開始,內置有處理彈出對話框支持。當你觸發一個動作,打開一個彈出框,您將得到以下提醒:

alert = driver.switch_to_alert()

# usage: alert.dismiss(), etc.

這將返回當前打開的警報對象。有了這個對象,你現在可以接受,拒絕,讀取其內容,甚至類型會得到一個提示。這個接口同樣適用警告,確認和提示。參考到的JavaDoc 或RubyDocs的的更多信息。

導航:歷史和位置


此前,我們介紹了webdriver的導航使用“get”命令

(driver.get(“http://www.example.com”)),我們在有些情況下是要用到導航欄前進和頭退功能:

driver.get("http://www.example.com")  # python doesn‘t have driver.navigate

重申:“navigate().to()” 和 “get()” 的效果是一樣的。一個只是很多比其他更容易輸入!

你可以隨意的使用瀏覽器歷史記錄中後退和前進功能:

driver.forward()

driver.back()

請註意,此功能完全依賴於底層瀏覽器。當你調用這些方法時,在不同的瀏覽器下可能會發生意想不到的事情

Cookies


你可能會非常感興趣了解如何使用Cookie。首先,你需要知道cookie有效期。如果您想先預設的cookie,然後再開始與網站進行交互,你的主頁很大/且需要一段時間來加載,一個辦法是找到一個更小的網頁來代替,通常404頁小(http://example.com/some404page)

#轉到正確的域

driver.get("http://www.example.com")

#現在在這裏的整個域設置的cookie,

#這裏的cookie的名稱是‘key‘,它的值是‘value‘的

driver.add_cookie({‘name‘:‘key‘, ‘value‘:‘value‘, ‘path‘:‘/‘})

# additional keys that can be passed in are:

# ‘domain‘ -> String,

# ‘secure‘ -> Boolean,

# ‘expiry‘ -> Milliseconds since the Epoch it should expire.


# 現在的輸出當前URL的所有可用的cookies

for cookie in driver.get_cookies():

    print "%s -> %s" % (cookie[‘name‘], cookie[‘value‘])


# You can delete cookies in 2 ways
# By name

driver.delete_cookie("CookieName")

# Or all of them

driver.delete_all_cookies()

更改用戶代理


這是很容易與Firefox的驅動程序:

拖放


下面是一個例子使用執行拖放動作類。本地事件事件需要被激活。

from selenium.webdriver.common.action_chains import ActionChains
element = driver.find_element_by_name("source")
target =  driver.find_element_by_name("target")

ActionChains(driver).drag_and_drop(element, target).perform()

驅動程序的細節和權衡

Selenium webdriver的驅動程序


參考:

http://www.cnblogs.com/fnng/archive/2012/02/10/2345187.html

webdriver的對於不同瀏覽器通過不同的接口實現;下面介紹這幾種實現方式:

HtmlUnit的驅動程序


這是目前最快,最輕量級的實施webdriver測試。正如它的名字所暗示的,這是基於HtmlUnit的。HtmlUnit是一個java實現基於web瀏覽器,沒有圖形用戶界面。對於任何語言綁定(Java以外)Selenium服務器需要使用此驅動程序。

用法

driver = webdriver.Remote("http://localhost:4444/wd/hub", webdriver.DesiredCapabilities.HTMLUNIT))

優點

· 在Webdriver執行自動化最快的方式

· 一個純Java的解決方案,因此它是獨立於平臺的。

· 支持JavaScript的

缺點

· 模擬其他瀏覽器的JavaScript行為(見下文)

HtmlUnit驅動器JavaScript


沒有流行的瀏覽器使用JavaScript引擎,使用HtmlUnit(Rhino)。

如果你使用HtmlUnit測試JavaScript ,相比其他瀏覽 結果可能會不一樣。

當我們說“JavaScript”,其實我們說的是“JavaScript和DOM”。雖然DOM是由W3C定義的,每個瀏覽器都有自己特點和差異,HtmlUnit 有一套完整的實現DOM的方案,能很好的支持JavaScript ,但有別與其他瀏覽器,和W3C標準的主流瀏覽器的DOM的實現存在差異,盡管其模仿其有他瀏覽器的能力。

在webdriver ,我們選擇使用HtmlUnit來測試Javascript ,不過這樣存在問題和風險,但有越來越多的網站依賴於JavaScript ,我們采取了保守的做法,HtmlUnit默認情況下禁用JavaScript 。在webdriver的HtmlUnit的每個版本,我們重新評估這一決定:我們希望在一些點上HtmlUnit的默認情況下啟用JavaScript。

啟用JavaScript


啟用JavaScript的支持是很容易的:

driver = webdriver.Remote("http://localhost:4444/wd/hub", webdriver.DesiredCapabilities.HTMLUNITWITHJS)

這將導致HtmlUnit的驅動程序默認情況下,模擬火狐3.6的JavaScript進行處理。

Firefox Driver


用Firefox的插件來控制火狐瀏覽器,firefox 配置文件使用selenium.xpi(插件)。默認情況下,需要修改一些設置(see the source to see which ones),火狐驅動是能夠運行在Windows,Mac,Linux上進行測試。目前在版本3.6,10(這個版本早過時了)

用法

driver = webdriver.Firefox()

優點

· 在一個真正的瀏覽器上運行,並支持JavaScript的

· 速度比Internet Explorer的驅動程序快

缺點

· 比HtmlUnit的驅動程序慢

修改火狐簡介

假設你想要修改的用戶代理字符串(如上述),但你已經有了一個欺騙Firefox的配置文件,它包含許多有用的擴展。有兩種方式獲得此配置文件。假設使用Firefox的配置文件管理器(火狐 ProfileManager),已創建配置:

另外,如果配置文件尚未在Firefox註冊:

當我們正在開發firefox 啟動的特性,我們能夠正常使用。

正如我們在Firefox Driver,開發功能,我們能夠使用。例如,直到我們感覺本機事件為Linux上的Firefox是穩定的,他們是默認情況下禁用。要啟用它們:

profile = webdriver.FirefoxProfile()

profile.native_events_enabled = True

driver = webdriver.Firefox(profile)

信息

請參閱火狐部分維基頁面的最新最先進的信息。

Internet Explorer Driver


該驅動程序控制.dll,因而只適用於Windows操作系統。每個selenium釋放它的核心功能在xp下測試IE版本6,7和8,在Windows7下測試IE 9。

用法

driver = webdriver.Ie()

優點

· 運行在一個真正的瀏覽器支持JavaScript與最終用戶看到的所有的行為一致

缺點

· 顯然,Internet Explorer Driver只能在Windows上工作!

· 相對緩慢(盡管仍然是相當快速的)

· 本身不支持XPath的大多數版本。自動註入,這是明顯慢於其他瀏覽器和進行比較時,在同一瀏覽器的CSS選擇器變慢。

· 本身不支持CSS版本6和7。

· CSS選擇器在IE 8和9是本地的,但這些瀏覽器不完全支持CSS3

信息

維基頁面的最先進的最新信息,請參閱Internet Explorer的部分。請特別註意所需的配置部分。

Chrome驅動


Chrome驅動程序維護/支持Chrome 項目本身。webdriver的工作與Chrome通過的chromedriver二進制(Chrome項目的下載頁面上找到)。你需要有兩個chromedriver和安裝一個版本的Chrome瀏覽器。為了webdriver的自動找到,chromedriver需要要放在系統的路徑上。Chrome瀏覽器本身由chromedriver在默認安裝路徑找到。這些都可以通過環境變量覆蓋。 有關更多信息,請參閱維基。

用法

driver = webdriver.Chrome()

優點

· 在一個真正的瀏覽器上運行,並支持JavaScript的

· 因為Chrome是基於Webkit的瀏覽器,Chrome Driver會允許您驗證您的網站在Safari的測試效果。需要註意的是,因為瀏覽器使用其自己的V8 JavaScript引擎,而不是Safari瀏覽器的Nitro引擎,JavaScript的執行可能會有所不同。

缺點

· 比HtmlUnit的驅動程序慢

·

信息

最先進的最新信息,請參閱我們的wiki。更多信息,也可以找到下載頁面

獲取與Chrome驅動程序運行

鉻驅動程序可執行文件下載 ,並按照其他的wiki頁面上的說明

Opera Driver

見歌劇院驅動器在上使用Opera驅動程序的信息的selenium維基wiki文章。

iPhone Driver

查看iPhone的驅動selenium維基上使用Mac的iOS驅動程序的信息,wiki文章。

Android Driver

查看Android的驅動程序 硒selenium維基采用了Android驅動程序的信息,wiki文章。

混合使用webdriver和RC技術


Webdriver替換selenium RC

webdriver的Java版本的selenium RC API提供了一種實現。這意味著,你可以使用Selenium-RC API和使用底層webdriver的技術。這主要是用於向後兼容。它允許那些使用selenium RC API的用戶使用webdriver覆蓋現有的測試套件。它提供幫助緩解遷移到selenium webdriver。此外,允許一個人使用這兩個API,在相同的測試代碼。

Selenium webdriver的使用是這樣的:

優點

· webdriver的和selenium的API允許並排存在

· webdriver的遷移管理機制提供了一個簡單的Selenium RC API

· 不需要獨立的Selenium RC服務器的運行

缺點

· 不能支持每一個方法

· 更多先進的selenium使用(using “browserbot” or other built-in JavaScript methods from Selenium Core)可能無法正常工作

· 由於底層實現差異,有些方法可能會比較慢

備份webdriver與selenium

webdriver的盡可能多兼容selenium RC對瀏覽器的支持,同時仍然提供支持使用webdriver的API,所以為了您可以利用SeleneseCommandExecutor

Safari是支持這種方式,用下面的代碼(確保禁用彈出窗口攔截功能):

這種方法目前有一些主要限制,尤其是findElements並不如預期般運作。此外,繁重的驅動瀏覽器,因為我們使用的是selenium 的核心,你的JavaScript沙箱限制。

運行獨立Selenium服務器使用RemoteDrivers

從selenium 的下載頁下載服務器獨立<version>.jar和可選的IEDriverServer。如果您打算使用Chrome,從Google Code上下載。

拆開IEDriverServer和(或)chromedriver,並把它們在$ PATH /%PATH% - Selenium服務器上的一個目錄,這是應該能夠IE / Chrome的處理請求,而無需額外的修改。

啟動服務器的命令行

java -jar <path_to>/selenium-server-standalone-<version>.jar

如果你想使用原生的事件功能,表明在命令行上的選項

Dwebdriver.enable.native.events = 1

對於其他命令行選項,執行

java -jar <path_to>/selenium-server-standalone-<version>.jar -help

為了正常工作,應該允許以下端口傳入的TCP連接:??4444,7054-5(or twice as many ports as the number of concurrent instances you plan to run)。在Windows下,你可能需要以及疏通各種應用。

selenium webdriver (python)大全