Selenium 2.0 WebDriver 入门指南

Question

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");
}