第4章 Selenium2-java WebDriver API (一)
4.1 从定位元素开始
WebDriver提供了八种元素定位方: 在Java语言中对应的定位方法:
·id findElement(By.id())
·name findElement(By.name())
·class name findElement(By.className())
·tag name findElement(By.tagName())
·link text findElement(By.linkText())
·partial link text findElement(By.partialLinkText())
·xpath findElement(By.xpath())
·css selector findElement(By.cssSeletor())
id定位:name定位,class定位都是通过他们的属性值来的。
link定位:专门用来定位文本链接。eg:<a class="mnav" name="tj_trnews" href="http://news.baidu.com">新闻</a> 对应的link定位 findElement(By.linkText("新闻"))。
partial link定位:parial link定位是对link定位的一种补充,有些文本链接会比较长,这个时候我们可以取文本链接的一部分定位,只要这一部分信息可以唯一地标识这个链接。eg:<a class="mnav" name="tj_trnews" href="http://news.baidu.com">这是一个很长很长的文本链接</a> 对应的partial link定位 findElement(By.partialLinkText("一个很长的")) 或 findElement(By.partialLinkText("文本链接"))。
xpath定位:最简单的找到元素的位置的方法就是打开FireBug。
CSS定位:<span class="sp">
<input id="abc" name="def" class="ghi" type="text" maxlength='100' />
</span>
通过class属性定位:findElement(By.cssSelector(".ghi"));
通过id属性定位:findElement(By.cssSelector("#abc"));
通过标签名定位:findElement(By.cssSelector("input"));
通过父子关系定位: findElement(By.cssSelector("span > input"));
通过属性定位:findElement(By.cssSelector("input[maxlength='100']"));
XPath与CSS的类似功能的简单对例如下表所示
package com.cy.selenium; import org.openqa.selenium.By; import org.openqa.selenium.Keys; import org.openqa.selenium.WebDriver; import org.openqa.selenium.WebElement; import org.openqa.selenium.firefox.FirefoxDriver; import org.openqa.selenium.interactions.Actions; import bsh.commands.dir; public class Test01 { public static void main(String[] args) { System.out.println("start selenium"); WebDriver driver=new FirefoxDriver();// 用WebDriver new Firefox浏览器的驱动给变量driver,相当于driver拿到了Firefox浏览器的控制权。 driver.manage().window().maximize(); driver.get("http://www.awbeci.com/"); driver.findElement(By.xpath(".//*[@id='navbar-collapse-01']/ul[2]/li[2]/button")).click(); driver.findElement(By.id("username")).sendKeys("SmileCy"); driver.findElement(By.id("password")).sendKeys("1314520"); driver.findElement(By.linkText("登录")).click(); driver.findElement(By.xpath(".//*[@id='main-container']/div[1]/div[2]/div/div[2]/div/a[3]/span")).click(); // 回车键查询 driver.findElement(By.cssSelector(".form-control")).sendKeys("软件测试学"); new Actions(driver).sendKeys(Keys.ENTER).perform();// 按回车键 // 后退 driver.navigate().back(); // 刷新 driver.navigate().refresh(); // 关闭浏览器 driver.close(); } }
4.2 控制浏览器
4.2.1 控制浏览器窗口大小
driver.manage().window().setSize(new Dimension(400, 500));
4.2.2 控制浏览器后退、前进
WebDriver也提供了对应的back()和forward()方法来模拟后退和前进按钮
// 后退 driver.navigate().back(); // 刷新 driver.navigate().refresh();
4.2.3 模拟浏览器刷新
driver.navigate().refresh();
4.3 简单元素操作
·clear() 清除文本。 ·sendKeys(*value) 模拟按键输入。 ·click() 单击元素。
4.3.2 WebElement接口常用方法
submit() submit()方法用于提交表单
getSize() 返回元素的尺寸。
getText() 获取元素的文本。
getAttribute(name) 获得属性值。
isDisplayed() 设置该元素是否用户可见。
4.4 鼠标事件
Actions 类提供了鼠标操作的常用方法:
· contextClick() 右击
· clickAndHold() 鼠标点击并控制
· doubleClick() 双击
· dragAndDrop() 拖动
· release() 释放鼠标
· perform() 执行所有Actions中存储的行为
鼠标右击操作。
导入提供鼠标操作的ActionChains 类
Actions(driver)
调用Actions()类,将浏览器驱动driver作为参数传入。
contexClick(xxx)
contextClick()方法用于模拟鼠标右键操作,在调用时需要指定元素定位。
perform() 执行所有ActionChains中存储的行为,可以理解成是对整个操作的提交动作。
action.contextClick(driver.findElement(By.className("cnisdisd"))).perform();
鼠标悬停。clickAndHold();
action1.clickAndHold(driver.findElement(By.linkText("设置"))).perform();
鼠标双击操作。
doubleClick()方法用于模拟鼠标双击操作。
action1.doubleClick(driver.findElement(By.className(""))).perform();
鼠标拖放操作。
drag_and_drop(source, target)在源元素上按下鼠标左键,然后移动到目标元素上释放。
·source:鼠标拖动的源元素。
·target:鼠标释放的目标元素。
WebElement source=driver.findElement(By.className("element")); WebElement target=driver.findElement(By.className("element")); action1.dragAndDrop(source, target).perform();
释放鼠标
release()方法用于释放鼠标事件。
action1.release().perform();
4.5 键盘事件
使用键盘按键方法前需要先导入keys类。
以下为常用的键盘操作:
sendKeys(Keys.BACK_SPACE) 删除键(BackSpace)
sendKeys(Keys.SPACE) 空格键(Space)
sendKeys(Keys.TAB) 制表键(Tab)
sendKeys(Keys.ESCAPE) 回退键(Esc)
sendKeys(Keys.ENTER) 回车键(Enter)
sendKeys(Keys.CONTROL,'a') 全选(Ctrl+A)
sendKeys(Keys.CONTROL,'c') 复制(Ctrl+C)
sendKeys(Keys.CONTROL,'x') 剪切(Ctrl+X)
sendKeys(Keys.CONTROL,'v') 粘贴(Ctrl+V)
sendKeys(Keys.F1) 键盘F1
……
sendKeys(Keys.F12) 键盘F12
package com.cy.selenium; import org.openqa.selenium.By; import org.openqa.selenium.Keys; import org.openqa.selenium.WebDriver; import org.openqa.selenium.WebElement; import org.openqa.selenium.firefox.FirefoxDriver; public class Test02 { public static void main(String[] args) { WebDriver driver=new FirefoxDriver(); driver.manage().window().maximize(); driver.get("http://www.baidu.com/"); WebElement input =driver.findElement(By.id("kw")); // 输入内容 input.sendKeys("seleniumm"); // 删除多余的m input.sendKeys(Keys.BACK_SPACE); // 输入空格+教程 input.sendKeys(Keys.SPACE); input.sendKeys("教程"); // ctrl+a input.sendKeys(Keys.CONTROL,"a"); // ctrl+x input.sendKeys(Keys.CONTROL,"x"); // ctrl+v input.sendKeys(Keys.CONTROL,"v"); // 通过回车键 查询 input.sendKeys(Keys.ENTER); driver.close(); } }
4.6 获得验证信息
getTitle():用于获得当前页面的title。
getCurrentUrl() :用户获得当前页面的URL。
4.7 设置元素等待
4.7.1 timeouts方法
WebDriver提供了几种方法来等待元素。
·implicitlyWait。识别对象时的超时时间。过了这个时间如果对象还没找到的话就会抛出NoSuchElement异常。
·setScriptTimeout。异步脚本的超时时间。WebDriver可以异步执行脚本,这个是设置异步执行脚本脚本返回结果的超时时间。
·pageLoadTimeout。页面加载时的超时时间。因为WebDriver会等页面加载完毕再进行后面的操作,所以如果页面超过设置时间依然没有加载完成,那么WebDriver就会抛出异常
4.7.2 sleep休眠方法
Thread.sleep()方法
当执行到sleep()方法时会固定的休眠所设置的时长(这里以毫秒为单位);然后再继续执行。
注意,这里的Thread.sleep()方法不能直接使用,必须加上异常的处理。
throws关键字通常被应用在声明方法时,用来指定可能抛出的异常。
package com.cy.selenium; import java.util.concurrent.TimeUnit; import org.openqa.selenium.By; import org.openqa.selenium.WebDriver; import org.openqa.selenium.firefox.FirefoxDriver; public class Wait { public static void main(String[] args) { WebDriver driver=new FirefoxDriver(); driver.manage().window().maximize(); //页面加载超时时间为5s driver.manage().timeouts().pageLoadTimeout(5, TimeUnit.SECONDS); driver.get("http://www.baidu.com/"); //定位对象时间5s,还没订到位置报异常 driver.manage().timeouts().implicitlyWait(5, TimeUnit.SECONDS); driver.findElement(By.id("kww")).sendKeys("selenium"); // Exception in thread "main" org.openqa.selenium.NoSuchElementException: Unable to locate element: {"method":"id","selector":"kww"} //异步脚本的超时时间为5s driver.manage().timeouts().setScriptTimeout(5, TimeUnit.SECONDS); // Thread.sleep 需要异常处理 try { Thread.sleep(2000); } catch (InterruptedException e) { e.printStackTrace(); } driver.close(); } }