selenium20中文帮助文档.docx

《selenium20中文帮助文档.docx》由会员分享，可在线阅读，更多相关《selenium20中文帮助文档.docx（22页珍藏版）》请在三一办公上搜索。

1、selenium20中文帮助文档Selenium2.0帮助文档 第1章 Webdirver基础 . 2 1.1 下载selenium2.0的lib包 . 2 1.2 用webdriver打开一个浏览器 . 2 1.3 打开测试页面 . 2 1.4 GettingStarted . 2 第2章 Webdirver对浏览器的支持 . 4 2.1 HtmlUnit Driver . 4 2.2 FireFox Driver . 4 2.3 InternetExplorer Driver . 4 第3章 使用操作 . 4 3.1 如何找到页面元素 . 4 3.1.1 By ID . 5 3.1.2 B

2、y Name . 5 3.1.3 By XPATH . 5 3.1.4 By Class Name . 5 3.1.5 By Link Text . 5 3.2 如何对页面元素进行操作 . 6 3.2.1 输入框 . 6 3.2.2 下拉选择框(Select) . 6 3.2.3 单选项(Radio Button) . 6 3.2.4 多选项(checkbox) . 7 3.2.5 按钮(button) . 7 3.2.6 左右选择框 . 7 3.2.7 弹出对话框(Popup dialogs) . 7 3.2.8 表单(Form) . 8 3.2.9 上传文件 (Upload File) .

3、 8 3.2.10 Windows 和 Frames之间的切换 . 8 3.2.11 拖拉(Drag andDrop) . 8 3.2.12 导航 (Navigationand History) . 8 3.3 高级使用 . 9 3.3.1 改变user agent . 9 3.3.2 读取Cookies . 9 3.3.3 调用Java Script . 9 3.3.4 Webdriver截图 . 10 3.3.5 页面等待 . 10 第4章 RemoteWebDriver . 10 4.1 使用RemoteWebDriver . 10 4.2 SeleniumServer . 11 4.3

4、 How to setFirefox profile using RemoteWebDriver . 11 第5章 封装与重用 . 12 第6章 在selenium2.0中使用selenium1.0的API . 14 第1章 Webdirver基础 1.1 下载selenium2.0的lib包 官方UserGuide：http:/seleniumhq.org/docs/ 1.2 用webdriver打开一个浏览器 我们常用的浏览器有firefox和IE两种，firefox是selenium支持得比较成熟的浏览器。但是做页面的测试，速度通常很慢，严重影响持续集成的速度，这个时候建议使用HtmlU

5、nit，不过HtmlUnitDirver运行时是看不到界面的，对调试就不方便了。使用哪种浏览器，可以做成配置项，根据需要灵活配置。 打开firefox浏览器： /Create a newinstance of the Firefox driver WebDriver driver = newFirefoxDriver; 打开IE浏览器 /Create a newinstance of the Internet Explorer driver WebDriver driver = newInternetExplorerDriver ; 打开HtmlUnit浏览器 /Createa new ins

6、tance of the Internet Explorer driver WebDriverdriver = new HtmlUnitDriver; 1.3 打开测试页面 对页面对测试，首先要打开被测试页面的地址,web driver 提供的get方法可以打开一个页面： / And now use thedriver to visit Google driver.get(); 1.4 GettingStarted package org.openqa.selenium.example; import org.openqa.selenium.By; import org.openqa.sele

7、nium.WebDriver; import org.openqa.selenium.WebElement; import org.openqa.selenium.firefox.FirefoxDriver; import org.openqa.selenium.support.ui.ExpectedCondition; import org.openqa.selenium.support.ui.WebDriverWait; public class Selenium2Example public static voidmain(String args) / Create a newinsta

8、nce of the Firefox driver / Notice that theremainder of the code relies on the interface, / not the implementation. WebDriver driver = newFirefoxDriver; / And now use this tovisit Google driver.get(); / Alternatively thesame thing can be done like this / driver.navigate.to(); / Find the text inputel

9、ement by its name WebElement element =driver.findElement(By.name(q); / Enter something tosearch for element.sendKeys(Cheese!); / Now submit the form.WebDriver will find the form for us from the element element.submit; / Check the title ofthe page System.out.println(Page title is: + driver.getTitle);

10、 / Googles search isrendered dynamically with JavaScript. / Wait for the pageto load, timeout after 10 seconds (newWebDriverWait(driver, 10).until(new ExpectedCondition public Booleanapply(WebDriver d) returnd.getTitle.toLowerCase.startsWith(cheese!); ); / Should see:cheese! - Google Search System.o

11、ut.println(Page title is: + driver.getTitle); /Close the browser driver.quit; 第2章 Webdirver对浏览器的支持 2.1 HtmlUnit Driver 优点：HtmlUnit Driver不会实际打开浏览器，运行速度很快。对于用FireFox等浏览器来做测试的自动化测试用例，运行速度通常很慢，HtmlUnit Driver无疑是可以很好地解决这个问题。 缺点：它对JavaScript的支持不够好，当页面上有复杂JavaScript时，经常会捕获不到页面元素。 使用： WebDriver driver = ne

12、w HtmlUnitDriver; 2.2 FireFox Driver 优点：FireFox Dirver对页面的自动化测试支持得比较好，很直观地模拟页面的操作，对JavaScript的支持也非常完善，基本上页面上做的所有操作FireFox Driver都可以模拟。 缺点：启动很慢，运行也比较慢，不过，启动之后Webdriver的操作速度虽然不快但还是可以接受的，建议不要频繁启停FireFox Driver。 使用： WebDriver driver = new FirefoxDriver; Firefox profile的属性值是可以改变的，比如我们平时使用得非常频繁的改变useragen

13、t的功能，可以这样修改： FirefoxProfile profile = new FirefoxProfile; profile.setPreference(general.useragent.override, some UAstring); WebDriver driver = new FirefoxDriver(profile); 2.3 InternetExplorer Driver 优点：直观地模拟用户的实际操作，对JavaScript提供完善的支持。 缺点：是所有浏览器中运行速度最慢的，并且只能在Windows下运行，对CSS以及XPATH的支持也不够好。 使用： WebDriv

14、er driver = new InternetExplorerDriver; 第3章 使用操作 3.1 如何找到页面元素 Webdriver的findElement方法可以用来找到页面的某个元素，最常用的方法是用id和name查找。下面介绍几种比较常用的方法。 3.1.1 By ID 假设页面写成这样： 那么可以这样找到页面的元素： 通过id查找： WebElement element = driver.findElement(By.id(passwd-id); 3.1.2 By Name 或通过name查找： WebElement element = driver.findElement(

15、By.name(passwd); 3.1.3 By XPATH 或通过xpath查找： WebElement element =driver.findElement(By.xpath(/inputid=passwd-id); 3.1.4 By Class Name 假设页面写成这样： CheddarGouda 可以通过这样查找页面元素： Listcheeses = driver.findElements(By.className(cheese); 3.1.5 By Link Text 假设页面元素写成这样： ahref= 那么可以通过这样查找： WebElement cheese =drive

16、r.findElement(By.linkText(cheese); 3.2 如何对页面元素进行操作 找到页面元素后，怎样对页面进行操作呢？我们可以根据不同的类型的元素来进行一一说明。 3.2.1 输入框 找到输入框元素： WebElement element = driver.findElement(By.id(passwd-id); 在输入框中输入内容： element.sendKeys(“test”); 将输入框清空： element.clear; 获取输入框的文本内容： element.getText; 3.2.2 下拉选择框(Select) 找到下拉选择框的元素： Select se

17、lect = new Select(driver.findElement(By.id(select); 选择对应的选择项： select.selectByVisibleText(“mediaAgencyA”); 或 select.selectByValue(“MA_ID_001”); 不选择对应的选择项： select.deselectAll; select.deselectByValue(“MA_ID_001”); select.deselectByVisibleText(“mediaAgencyA”); 或者获取选择项的值： select.getAllSelectedOptions; se

18、lect.getFirstSelectedOption; 3.2.3 单选项(Radio Button) 找到单选框元素： WebElement bookMode =driver.findElement(By.id(BookMode); 选择某个单选项： bookMode.click; 清空某个单选项： bookMode.clear; 判断某个单选项是否已经被选择： bookMode.isSelected; 3.2.4 多选项(checkbox) 多选项的操作和单选的差不多： WebElement checkbox =driver.findElement(By.id(myCheckbox.);

19、 checkbox.click; checkbox.clear; checkbox.isSelected; checkbox.isEnabled; 3.2.5 按钮(button) 找到按钮元素： WebElement saveButton = driver.findElement(By.id(save); 点击按钮： saveButton.click; 判断按钮是否enable: saveButton.isEnabled ; 3.2.6 左右选择框 也就是左边是可供选择项，选择后移动到右边的框中，反之亦然。例如： Select lang = new Select(driver.findEle

20、ment(By.id(languages); lang.selectByVisibleText(“English”); WebElement addLanguage =driver.findElement(By.id(addButton); addLanguage.click; 3.2.7 弹出对话框(Popup dialogs) Alert alert = driver.switchTo.alert; alert.accept; alert.dismiss; alert.getText; 3.2.8 表单(Form) Form中的元素的操作和其它的元素操作一样，对元素操作完成后对表单的提交可

21、以： WebElement approve = driver.findElement(By.id(approve); approve.click; 或 approve.submit;/只适合于表单的提交 3.2.9 上传文件 (Upload File) 上传文件的元素操作： WebElement adFileUpload = driver.findElement(By.id(WAP-upload); String filePath = C:testuploadfilemedia_adstest.jpg; adFileUpload.sendKeys(filePath); 3.2.10 Windo

22、ws 和 Frames之间的切换 一般来说，登录后建议是先： driver.switchTo.defaultContent; 切换到某个frame： driver.switchTo.frame(leftFrame); 从一个frame切换到另一个frame： driver.switchTo.frame(mainFrame); 切换到某个window： driver.switchTo.window(windowName); 3.2.11 拖拉(Drag andDrop) WebElement element =driver.findElement(By.name(source); WebElem

23、ent target = driver.findElement(By.name(target); (new Actions(driver).dragAndDrop(element, target).perform; 3.2.12 导航 (Navigationand History) 打开一个新的页面： driver.navigate.to(); 通过历史导航返回原页面： driver.navigate.forward; driver.navigate.back; 3.3 高级使用 3.3.1 改变user agent User Agent的设置是平时使用得比较多的操作： FirefoxProf

24、ile profile = new FirefoxProfile; profile.addAdditionalPreference(general.useragent.override,some UA string); WebDriver driver = new FirefoxDriver(profile); 3.3.2 读取Cookies 我们经常要对的值进行读取和设置。 增加cookie: / Now set the cookie. This ones valid for the entire domain Cookie cookie = new Cookie(key, value);

25、driver.manage.addCookie(cookie); 获取cookie的值： / And now output all the available cookies for the current URL Set allCookies = driver.manage.getCookies; for (Cookie loadedCookie : allCookies) System.out.println(String.format(%s - loadedCookie.getValue); 根据某个cookie的name获取cookie的值： driver.manage.getCook

26、ieNamed(mmsid); 删除cookie: / You can delete cookies in 3 ways / By name driver.manage.deleteCookieNamed(CookieName); / By Cookie driver.manage.deleteCookie(loadedCookie); / Or all of them driver.manage.deleteAllCookies; %s,loadedCookie.getName, 3.3.3 调用Java Script Web driver对Java Script的调用是通过Javascri

27、ptExecutor来实现的，例如： JavascriptExecutor js = (JavascriptExecutor) driver; js.executeScript(functioninventoryGridMgr.setTableFieldValue(+ inventoryId + , + fieldName + , + value + );); 3.3.4 Webdriver截图 如果用webdriver截图是： driver = webdriver.Firefox driver.save_screenshot(C:error.jpg) 3.3.5 页面等待 因为Load页面需

28、要一段时间，如果页面还没加载完就查找元素，必然是查找不到的。最好的方式，就是设置一个默认等待时间，在查找页面元素的时候如果找不到就等待一段时间再找，直到超时。 Webdriver提供两种方法，一种是显性等待，另一种是隐性等待。 显性等待： WebDriver driver =new FirefoxDriver; driver.get(http:/somedomain/url_that_delays_loading); WebElement myDynamicElement = (new WebDriverWait(driver, 10) .until(new ExpectedCondition

29、 Override public WebElement apply(WebDriver d) returnd.findElement(By.id(myDynamicElement); ); 隐性等待： WebDriver driver = new FirefoxDriver; driver.manage.timeouts.implicitlyWait(10, TimeUnit.SECONDS); driver.get(http:/somedomain/url_that_delays_loading); WebElement myDynamicElement =driver.findElemen

30、t(By.id(myDynamicElement); 第4章 RemoteWebDriver 当本机上没有浏览器，需要远程调用浏览器进行自动化测试时，需要用到RemoteWebDirver. 4.1 使用RemoteWebDriver import java.io.File; import .URL; import org.openqa.selenium.OutputType; import org.openqa.selenium.TakesScreenshot; import org.openqa.selenium.WebDriver; import org.openqa.selenium.

31、remote.Augmenter; import org.openqa.selenium.remote.DesiredCapabilities; import org.openqa.selenium.remote.RemoteWebDriver; public class Testing public void myTestthrows Exception WebDriver driver = newRemoteWebDriver( new URL(http:/localhost:4446/wd/hub), DesiredCapabilities.firefox); driver.get(); / RemoteWebDriverdoes not implement the Takes