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运行时是看不到界面的，对调试就不方便了。使用哪种浏览器，可以做成配置项，根据需要灵活配置。

 

1. 打开firefox浏览器：

        //Create a newinstance of the Firefox driver

        WebDriver driver = newFirefoxDriver();

 

2. 打开IE浏览器

        //Create a newinstance of the Internet Explorer driver

        WebDriver driver = newInternetExplorerDriver ();

 

3. 打开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");

}

 

     

      Written by smilingsin GuangZhou , June22^th, 2011