Selenium2.0 WebDriver入门指南

1.1 下载selenium2.0的lib包

http://code.google.com/p/selenium/downloads/list

官方User Guide：http://seleniumhq.org/docs/

1.2 用webdriver打开一个浏览器

我们常用的浏览器有firefox和IE两种，firefox是selenium支持得比较成熟的浏览器。但是做页面的测试，速度通常很慢，严重影响持续集成的速度，这个时候建议使用HtmlUnit，不过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 instance of the Internet Explorer driver

WebDriverdriver = new HtmlUnitDriver();

1.3 打开测试页面

对页面对测试，首先要打开被测试页面的地址（如：http://www.google.com）,web driver 提供的get方法可以打开一个页面：

// And now use thedriver to visit Google

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

1.4 如何找到页面元素

Webdriver的findElement方法可以用来找到页面的某个元素，最常用的方法是用id和name查找。

假设页面写成这样：

<input type="text" name="passwd"id="passwd-id" />

那么可以这样找到页面的元素：

通过id查找：

WebElement element = driver.findElement(By.id("passwd-id"));

或通过name查找：

WebElement element = driver.findElement(By.name("passwd"));

或通过xpath查找：

WebElement element =driver.findElement(By.xpath("//input[@id='passwd-id']"));

但页面的元素经常在找的时候因为出现得慢而找不到，建议是在查找的时候等一个时间间隔。

1.5 如何对页面元素进行操作

找到页面元素后，怎样对页面进行操作呢？我们可以根据不同的类型的元素来进行一一说明。

1.5.1 输入框（text field or textarea）

找到输入框元素：

WebElement element = driver.findElement(By.id("passwd-id"));

在输入框中输入内容：

element.sendKeys(“test”);

将输入框清空：

element.clear();

获取输入框的文本内容：

element.getText();

1.5.2下拉选择框(Select)

找到下拉选择框的元素：

Select select = 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();

select.getFirstSelectedOption();

1.5.3单选项(Radio Button)

找到单选框元素：

WebElement bookMode =driver.findElement(By.id("BookMode"));

选择某个单选项：

bookMode.click();

清空某个单选项：

bookMode.clear();

判断某个单选项是否已经被选择：

bookMode.isSelected();

1.5.4多选项(checkbox)

多选项的操作和单选的差不多：

WebElement checkbox = driver.findElement(By.id("myCheckbox."));

checkbox.click();

checkbox.clear();

checkbox.isSelected();

checkbox.isEnabled();

1.5.5按钮(button)

找到按钮元素：

WebElement saveButton = driver.findElement(By.id("save"));

点击按钮：

saveButton.click();

判断按钮是否enable:



saveButton.isEnabled ();

1.5.6左右选择框

也就是左边是可供选择项，选择后移动到右边的框中，反之亦然。例如：

Select lang = new Select(driver.findElement(By.id("languages")));

lang.selectByVisibleText(“English”);

WebElement addLanguage =driver.findElement(By.id("addButton"));

addLanguage.click();

1.5.7弹出对话框(Popup dialogs)

Alert alert = driver.switchTo().alert();

alert.accept();

alert.dismiss();

alert.getText();

1.5.8表单(Form)

Form中的元素的操作和其它的元素操作一样，对元素操作完成后对表单的提交可以：

WebElement approve = driver.findElement(By.id("approve"));

approve.click();

或

approve.submit();//只适合于表单的提交

1.5.9上传文件

上传文件的元素操作：

WebElement adFileUpload =driver.findElement(By.id("WAP-upload"));

String filePath = "C:\test\\uploadfile\\media_ads\\test.jpg";

adFileUpload.sendKeys(filePath);

1.6 Windows 和 Frames之间的切换

一般来说，登录后建议是先：

driver.switchTo().defaultContent();

切换到某个frame：

driver.switchTo().frame("leftFrame");

从一个frame切换到另一个frame：

driver.switchTo().frame("mainFrame");

切换到某个window：

driver.switchTo().window("windowName");

1.7 调用Java Script

Web driver对Java Script的调用是通过JavascriptExecutor来实现的，例如：

JavascriptExecutor js = (JavascriptExecutor) driver;

js.executeScript("(function(){inventoryGridMgr.setTableFieldValue('"+ inventoryId + "','" + fieldName + "','"

+ value + "');})()");

1.8 页面等待

页面的操作比较慢，通常需要等待一段时间，页面元素才出现，但webdriver没有提供现成的方法，需要自己写。

等一段时间再对页面元素进行操作：

public void waitForPageToLoad(longtime) {

try {

Thread.sleep(time);

} catch (Exceptione) {

}

}

在找WebElement的时候等待：

public WebElementwaitFindElement(By by) {

returnwaitFindElement(by, Long.parseLong(CommonConstant.GUI_FIND_ELEMENT_TIMEOUT),Long

.parseLong(CommonConstant.GUI_FIND_ELEMENT_INTERVAL));

}



public WebElementwaitFindElement(By by, long timeout, long interval) {

long start = System.currentTimeMillis();

while (true) {

try {

return driver.findElement(by);

} catch(NoSuchElementException nse) {

if (System.currentTimeMillis()- start >= timeout) {

throw newError("Timeout reached and element[" + by + "]not found");

} else {

try {

synchronized(this) {

wait(interval);

}

} catch(InterruptedException e) {

e.printStackTrace();

}

}

}

}

}

1.9 在selenium2.0中使用selenium1.0的API

Selenium2.0中使用WeDriver API对页面进行操作，它最大的优点是不需要安装一个selenium server就可以运行，但是对页面进行操作不如selenium1.0的Selenium RC API那么方便。Selenium2.0提供了使用Selenium RC API的方法：

// You may use any WebDriver implementation. Firefox is used hereas an example

WebDriver driver = new FirefoxDriver();



// A "base url", used by selenium to resolve relativeURLs

String baseUrl ="http://www.google.com";



// Create the Selenium implementation

Selenium selenium = new WebDriverBackedSelenium(driver, baseUrl);



// Perform actions with selenium

selenium.open("http://www.google.com");

selenium.type("name=q", "cheese");

selenium.click("name=btnG");



// Get the underlying WebDriver implementation back. This willrefer to the

// same WebDriver instance as the "driver" variableabove.

WebDriver driverInstance = ((WebDriverBackedSelenium)selenium).getUnderlyingWebDriver();



//Finally, close thebrowser. Call stop on the WebDriverBackedSelenium instance

//instead of callingdriver.quit(). Otherwise, the JVM will continue running after

//the browser has beenclosed.

selenium.stop();



我分别使用WebDriver API和SeleniumRC API写了一个Login的脚本，很明显，后者的操作更加简单明了。

WebDriver API写的Login脚本：

public void login() {

driver.switchTo().defaultContent();

driver.switchTo().frame("mainFrame");



WebElement eUsername= waitFindElement(By.id("username"));

eUsername.sendKeys(manager@ericsson.com);



WebElement ePassword= waitFindElement(By.id("password"));

ePassword.sendKeys(manager);



WebElementeLoginButton = waitFindElement(By.id("loginButton"));

eLoginButton.click();



}



SeleniumRC API写的Login脚本：

public void login() {

selenium.selectFrame("relative=top");

selenium.selectFrame("mainFrame");

selenium.type("username","manager@ericsson.com");

selenium.type("password","manager");

selenium.click("loginButton");

}

最后附上转载连接：点击打开链接