Webdriver API （一）

（转载）

1.1  下载selenium2.0的包

1. 官方download包地址：http://code.google.com/p/selenium/downloads/list
2. 官方User Guide：　　 http://seleniumhq.org/docs/
3. 官方API:　　　　　　  http://selenium.googlecode.com/git/docs/api/java/index.html

1.2.1  用webdriver打开一个浏览器

• 打开firefox浏览器：

        　　　　WebDriver driver = new FirefoxDriver(); 

　　　　　　　　如果firefox不是默认安装路径，需要指定它的路径再启动:

　　　　　　　　System.setProperty("webdriver.firefox.bin", "C:\Program Files\Mozilla Firefox\firefox.exe");  

　　　　　　　　WebDriver webDriver = new FirefoxDriver();

• 打开IE浏览器

　　　　　　　　WebDriver driver = new InternetExplorerDriver ();

　　　　　　　　也可以指定准确的IE路径，然后启动它：

　　　　　　　　System.setProperty("webdriver.ie.driver",
                    "C:/Program Files (x86)/Internet Explorer/iexplore.exe");
              WebDriver driver = new InternetExplorerDriver();　 　　

• 打开HtmlUnit浏览器

        　　　　WebDriverdriver = new HtmlUnitDriver(); 

• 打开chrome浏览器

　　　　　　　WebDriverdriver = new ChromeDriver();

1.2.2  最大化浏览器　　

　　WebDriver driver = new FirefoxDriver();
　　driver.manage().window().maximize();

1.2.3 关闭浏览器　

WebDriver driver = new FirefoxDriver();

• 　　driver.close();
• 　　driver.quit();

Driver.Quit() Quit this dirver, closing every associated windows;

Driver.Close() Close the current window, quiting the browser if it is the last window currently open.

1.3  打开测试页面

• driver.get("http://www.google.com");
• driver.navigate().to("http://www.baidu.com/"); 

　　　　　　P.S.navigate方法会产生1个Navigator对象，其封装了与导航相关的一些方法，比如前进后退等

　　　　　　navigate()进行页面跳转时不会进行页面数据的校验（比如当前页面有必填项但是实际上没填，navigate也会跳到to页面），相反get（）则可以进行这些校验，更真实的模拟实际情况

1.4  页面元素定位

Webdriver提供下面两种方法来定位页面元素，参数是By对像，最常用是By.id和By.name查找。

• findElement　　 定位某个元素，如果没有找到元素会抛出异常:NoSuchElementException
• findElements     定位一组元素

 例如需要定位如下元素：

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

• By.id：

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

• By.name：

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

• By.xpath：

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

• By.className

　　　　　　WebElement element = driver.findElement(By.className("input_class"));

• By.cssSelector

　　　　　　WebElement element = driver.findElement(By.cssSelector(".input_class"));

• By.linkText:

　　　　　　//通俗点就是精确查询

　　　　　　WebDriver driver = new FirefoxDriver();
　　　　　　driver.get("http://www.baidu.com/");
　　　　　　WebElement element = driver.findElement(By.linkText("百科"));

• By.partialLinkText：

　　　　　　//这个方法就是模糊查询
　　　　　　WebDriver driver = new FirefoxDriver();
　　　　　　driver.get("http://www.baidu.com/");
　　　　　　WebElement element = driver.findElement(By.partialLinkText("hao"));

• By.tagName:

　　　　　　WebDriver driver = new FirefoxDriver();
　　　　　　driver.get("http://www.baidu.com/");
　　　　　　String test= driver.findElement(By.tagName("form")).getAttribute("name");
　　　　　　System.out.println(test); 

小技巧：当使用某一属性识别元素时如果返回了多个，可通过先找到唯一的父元素，然后再找他的子元素，如下，

WebElement web=driver.findElement(By.id("form")).findElement(By.id("kw"));

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(“A”);
• select.selectByValue(“1”); 
• select.deselectAll();
• select.deselectByValue(“1”);
• select.deselectByVisibleText(“A”);
• select.getAllSelectedOptions();
• select.getFirstSelectedOption(); 

1.5.3单选项(Radio Button)

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

• radio.click();　　　　   //选择某个单选项
• radio.clear();　　　　  //清空某个单选项
• radio.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 btn= driver.findElement(By.id("save"));

• btn.click();　　　　　 //点击按钮
• btn.isEnabled ();　　//判断按钮是否enable

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: est\uploadfile\media_ads\test.jpg";

　　adFileUpload.sendKeys(filePath);

1.6  Windows 和 Frames之间的切换

• driver.switchTo().defaultContent();　　　　　//返回到最顶层的frame/iframe
• driver.switchTo().frame("leftFrame");　　　　//切换到某个frame：
• driver.switchTo().window("windowName");　//切换到某个window 

1.7  调用Java Script

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

JavascriptExecutor js = (JavascriptExecutor) driver;

        js.executeScript("JS脚本");

1.8  超时设置 

WebDriver driver = new FirefoxDriver();

• driver.manage().timeouts().implicitlyWait(10, TimeUnit.SECONDS);　　　　  //识别元素时的超时时间，影响范围：全局。（慎用）
• driver.manage().timeouts().pageLoadTimeout(10, TimeUnit.SECONDS);　　//页面加载时的超时时间
• driver.manage().timeouts().setScriptTimeout(10, TimeUnit.SECONDS);　　//异步脚本的超时时间