API实例详解
一、访问网页地址：get(url)
Java代码
String url="http://www.baidu.com"; driver.get(url);
二、刷新当前网页：navigate().refresh()
java代码
String url="http://www.baidu.com";
driver.get(url);
driver.findElement(By.id("kw")).sendKeys("123123123");
Thread.sleep(2000);
//刷新浏览器当前网页
driver.navigate().refresh();
三、获取页面title属性：getTitle()
java代码
String url="http://www.baidu.com";
driver.get(url);
//获取页面的title属性
String title=driver.getTitle();
System.out.println(title);
//断言页面上的title值是不是 百度一下，你就知道
Assert.assertEquals("百度一下，你就知道",title);
四、获取页面源代码：getPageSource()
java代码
String url="http://www.baidu.com";
driver.get(url);
//获取页面源代码
String pagesource=driver.getPageSource();
System.out.println(pagesource);
//断言源代码中是否包含“百度一下，你就知道”
Assert.assertTrue(pagesource.contains("百度一下，你就知道"));
五、获取当前页面的URL地址：getCurrentUrl()
Java代码
String url="http://www.baidu.com/";
driver.get(url);
//获取URL地址
String getUrl=driver.getCurrentUrl();
//断言
Assert.assertEquals("https://www.baidu.com/", getUrl);
六、清空文本框：clear()
java代码
WebElement baiduKw=driver.findElement(By.id("kw"));
baiduKw.sendkeys("selenium");
baiduKw.clear();
七、文本框输入文本：sendkeys()
java代码
WebElement baiduKw=driver.findElement(By.id("kw"));
baiduKw.sendKeys("selenium");
八、单击元素:click()
java代码
WebElement baiduKW=driver.findElement(By.cssSelector("#su"));
baiduKW.click();
九、双击元素
HTML源码
<input id='inputBox' type="button" style="width:100px;height:50px;" ondblclick="javascript:this.style.background='red'">请双击按钮</>
Java代码
WebElement inputB=driver.findElement(By.xpath("//input[@id='inputBox']"));
//声明Action对象
Actions ac=new Actions(driver);
//使用doubleClick方法在定位的元素中进行鼠标的双击操作
ac.doubleClick(inputB).build().perform();
十、获取文本：getText()
java代码
//定位百度首页右上角的 新闻
WebElement XW=driver.findElement(By.xpath("//*[@name='tj_trnews']"));
//获取文本
String Text1=XW.getText();
//校验文本内容
Assert.assertEquals(Text1,"新闻");
十一、判断元素是否展示：isDisplayed()
java代码
WebElement baiduSu=driver.findElement(By.xpath("//*[@id='su']"));
//获取 百度一下 按钮是否显示
boolean Su=baiduSu.isDisplayed();
//校验结果
Assert.assertTrue(Su);
十二、判断元素是否激活：isEnabled()
HTML源码：
<td>Button按钮</td>
<td class="SubButton">
<div id='button'>
<input name="buttonSub" type='button' class='button' value='Submit' disabled="disabled"/>
</div>
</td>
Java代码：
//定位元素，判断是否激活
boolean submit=driver.findElement(By.xpath("//*[@name='buttonhtml']")).isEnabled();
//校验结果
Assert.assertTrue(submit);
十三、判断选择框是否被选中：isSelected()
HTML源码：
<td>RadioBox单选框</td> <td class="widgetStyle"> <div id='radio'> <input type='radio' name="identity" class='a'/><label>a</label></br> <input type='radio' name="identity" class='b'/><label>b</label></br> <input type='radio' name="identity" class='c'/><label>c</label></br> <input type='radio' name="identity" class='d'/><label>d</label> </div> </td>
java代码：
//定位a单选框
WebElement a=driver.findElement(By.xpath("//*[@id='radio']/input[1]"));
//点击单选框
a.click();
//获取单选框是否被选中
boolean b1=a.isSelected();
//校验结果
Assert.assertTrue(b1);
十四、select下拉框处理
1. selectByIndex() 根据索引来选取，从0开始
2. selectByValue() 根据属性value的属性值来选取
3. selectByVisibleText()根据标签之间的Text值，也就是页面显示的
注意：导入的包要正确不然会报错。 import org.openqa.selenium.support.ui.Select;
单选下拉列表：
HTML源码
<tr>
<td>Select下拉列表</td>
<div id='select'>
<select id="selected">
<option value ="a">huawei</option>
<option value ="b">oppo</option>
<option value="c">vivo</option>
<option value="d">xiaomi</option>
<option value="e">hongmi</option>
<option value="f">meizu</option>
</select>
</div>
</tr>
Java代码
package cn.WebDriverAPI;
//单选下拉框
import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.chrome.ChromeDriver;
import org.openqa.selenium.support.ui.Select;
import org.testng.Assert;
import org.testng.annotations.AfterMethod;
import org.testng.annotations.Test;
public class downList {
public WebDriver driver;
@Test
public void test(){
System.setProperty("webdriver.chrome.driver", "E://chromedriver.exe");
driver=new ChromeDriver();
driver.get("file:///C:/Users/Administrator.USER-20180602NR/Desktop/selenium.html");
WebElement s=driver.findElement(By.xpath("//select[@id='selected']"));
Select select=new Select(s);
//isMultiple表示此下拉框列表是否允许多选，返回结果应为false
Assert.assertFalse(select.isMultiple());
//输出isMultiple方法返回的值
Boolean b=select.isMultiple();
System.out.println("b:"+b);
//通过选项的文字进行选中
select.selectByVisibleText("oppo");
//获取当前被选中的下拉列表选项文本并赋给text1
String text1=select.getFirstSelectedOption().getText();
//断言
Assert.assertEquals("oppo", text1);
System.out.println("文本"+text1);
//使用下拉列表选项的value属性值进行选中操作
select.selectByValue("c");
//获取当前被选中的下拉列表选项文本并赋给text2
String text2=select.getFirstSelectedOption().getText();
//断言
Assert.assertEquals("vivo",text2);
//通过索引选择，从0开始
select.selectByIndex(3);
String text3=select.getFirstSelectedOption().getText();
Assert.assertEquals("xiaomi",text3);
}
@AfterMethod
public void afterMethod(){
try {
Thread.sleep(2000);
} catch (InterruptedException e) {
e.printStackTrace();
}
driver.quit();
}
}
十五、多选的下拉列表：
HTML源码
<select id="selects" multiple="multiple">
<option value="java">java</option>
<option value="c">c</option>
<option value="c++">c++</option>
<option value="VB">VB</option>
<option value="php">php</option>
<option value="python">python</option>
<option value="ruby">ruby</option>
</select>
java代码
WebElement mus=driver.findElement(By.id("selects"));
Select select=new Select(mus);
//断言下拉列表是否支持多选，支持多选isMultiple方法则返回True
Assert.assertTrue(select.isMultiple());
//通过索引选择
select.selectByIndex(0);
//获取当前被选中选项的文字
String text=select.getFirstSelectedOption().getText();
//断言获取到的文字是否符合实际
Assert.assertEquals("java",text);
//通过value值选择
select.selectByValue("c");
//通过选项文字选择
select.selectByVisibleText("VB");
try {
Thread.sleep(2000);
} catch (InterruptedException e) {
e.printStackTrace();
}
//取消所有选项的选中状态
select.deselectAll();
十六、操作radio单选框
HTML源码
<div id='radio'>
<input type='radio' name="fruit" class='yi'/><label>yi</label></br>
<input type='radio' name="fruit" class='er'/><label>er</label></br>
<input type='radio' name="fruit" class='san'/><label>san</label></br>
<input type='radio' name="fruit" class='si'/><label>si</label></br>
<input type='radio' name="fruit" class='wu'/><label>wu</label>
</div>
java代码
//查找class属性为yi的按钮
WebElement yi=driver.findElement(By.className("yi"));
//判断此按钮是否为选中状态，如果不是则调用click方法进行点击
if(!yi.isSelected())
yi.click();
//断言class属性值为yi的按钮处于被选中状态。此时isSelected方法返回值应为True
Assert.assertTrue(yi.isSelected());
//输出isSelected方法返回值
Boolean b=yi.isSelected();
System.out.println("b："+b);
十七、操作CheckBox复选框
HTML源码
<div id='checkboxs'>
<input type="checkbox" name="checkbox2"/><label>liu</label></br>
<input type="checkbox" name="checkbox3"/><label>qi</label></br>
<input type="checkbox" name="checkbox4"/><label>ba</label></br>
<input type="checkbox" name="checkbox5"/><label>jiu</label></br>
<input type="checkbox" name="checkbox6"/><label>shi</label>
</div>
java代码
//查找name值为checkbox2的复选框
WebElement liu=driver.findElement(By.xpath("//input[@name='checkbox2']"));
//判断如果此复选框还未被选中，则调用click方法单击选中
if(!liu.isSelected())
liu.click();
//断言此复选框被成功选中
Assert.assertTrue(liu.isSelected());
//停2秒看效果
Thread.sleep(2000);
//判断如果此复选框处于被选中状态则再次调用click方法进行单击取消复选框的选中状态
if(liu.isSelected())
liu.click();
//断言此复选框处于非选中状态
Assert.assertFalse(liu.isSelected());
Thread.sleep(2000);
//再次选中name值为checkbox2的复选框
liu.click();
Thread.sleep(2000);
//查找所有type属性值为 checkBox的复选框，并存在list容器内
List<WebElement> checkboxs= driver.findElements(By.xpath("//input[@type='checkbox']"));
//遍历容器中所有元素，判断每个复选框处于非选中状态，非选中状态的则调用click方法单击
//因为name值为checkbox2的复选框在上一步时已被选中所有在for循环中不会再被点击
for(WebElement checkbox:checkboxs){
System.out.println(checkbox.isSelected());
Thread.sleep(1000);
if(!checkbox.isSelected())
checkbox.click();
}
十八、检查页面元素文本是否符合预期
Java代码
driver.get("http://www.baidu.com");
//获取网页title文字
String text=driver.getTitle();
Assert.assertEquals("百度一下，你就知道",text);
//判断title文字内容是否包含 百度一下
Assert.assertTrue(text.contains("百度一下"));
//判断title文字内容开始文字是不是 百度
Assert.assertTrue(text.startsWith("百度"));
//判断title文字内容的末尾文字是不是 知道
Assert.assertTrue(text.endsWith("知道"));
十九、判断页面元素是否存在
Java代码
package cn.WebDriverAPI;
//判断页面元素是否存在
import org.openqa.selenium.By;
import org.openqa.selenium.NoSuchElementException;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.chrome.ChromeDriver;
import org.testng.annotations.AfterMethod;
import org.testng.annotations.Test;
import junit.framework.Assert;
public class ElementPresent {
WebDriver driver;
//写一个判断页面元素是否存在的方法 IsElementPresent
private boolean IsElementPresent(By by){
try{
//如果使用传入的参数by能找到页面元素，则函数返回true，表示成功地找到页面元素
driver.findElement(by);
return true;
}catch(NoSuchElementException e){
//如果使用传入的参数by 没有找到页面元素,返回false
return false;
}
}
@Test
public void test(){
System.setProperty("webdriver.chrome.driver","E://chromedriver.exe");
driver=new ChromeDriver();
driver.get("http://www.baidu.com");
//调用写的IsElementPresent方法查找元素
if(IsElementPresent(By.xpath("//input[@name='wd']"))==true){
//如果成功定位到页面元素，则把页面元素对象存储到element变量中
WebElement element=driver.findElement(By.xpath("//input[@name='wd']"));
//判断element变量对象是否处于可能状态。如果可用则输入“selenium”关键字
if(element.isEnabled()==true){
element.sendKeys("selenium");
}
}else{
//如果页面元素没找到，则将此用例设置为失败，并打印原因
Assert.fail("页面元素没找到");
}
}
@AfterMethod
public void aftermethod() throws InterruptedException{
Thread.sleep(2000);
driver.quit();
}
}
二十、通过句柄来识别和操作新弹出的浏览器窗口
HTML源码
<html>
<head>
<title>Selenium</title>
</head>
<body>
<td>Input输入框</td>
<div id='ifra' >
<input type="text" id="input" name='ips'/>
</div>
</br>
<div id='open'>
<a href="http://www.baidu.com" class='open' target='bank'>Open new window打开百度</a><br>
</div>
<br>
</body>
</html>
java代码
//定位点击元素，打开新的窗口
driver.findElement(By.className("open")).click();
//获取当前页面句柄
String handle=driver.getWindowHandle();
//获取所有页面句柄，并循环判断不是当前的句柄就做选取switchTo()
for(String handles:driver.getWindowHandles()){
if(handles.equals(handle))
continue;//跳过本次循环，不执行下面的命令直接进行下一次循环
//break; //结束全部for循环
driver.switchTo().window(handles);
}
//在新打开的页面中进行操作
driver.findElement(By.id("input")).sendKeys("新页面");
//关闭新页面
driver.close();
//选择原来的句柄，切到原来的界面
driver.switchTo().window(handle);
//在原来的界面进行操作
driver.findElement(By.id("input")).sendKeys("旧页面");
二十一、使用Title属性识别和操作新淡出的浏览器窗口
HTML源码
<html>
<head>
<title>SeleniumElement</title>
</head>
<body>
<td>Input输入框</td>
<div id='ifra' >
<input type="text" id="input" name='ips'/>
</div>
</br>
<div id='open'>
<a href="http://www.baidu.com" class='open' target='bank'>Open new window打开百度</a><br>
</div>
<br>
</body>
</html>
Java代码
//定位点击连接元素，打开新窗口
driver.findElement(By.xpath("//a[text()='Open new window打开百度']")).click();
//获取当前页面句柄
String handle=driver.getWindowHandle();
//获取所有页面句柄
Set<String> allHandle=driver.getWindowHandles();
//如果容器存储的对象不为空，则遍历allHandle中所有句柄
if(!allHandle.isEmpty()){
for(String windowhandle:allHandle){
try{
//调用driver.switchTo().window(windowhandle).getTitle()方法
//获取浏览器的Title属性，并判断是否是“百度一下，你就知道”
if(driver.switchTo().window(windowhandle).getTitle().equals("百度一下，你就知道"))
//判断正确则说明是百度首页，则在输入框中输入 javaselenium
driver.findElement(By.xpath("//input[@id='kw']")).sendKeys("javaselenium");
}catch(NoSuchWindowException e){
//如果没有，抛出NoSuchWindowException，打印异常的堆栈信息
e.printStackTrace();
}
}
}
//返回最开始打开的浏览器页面
driver.switchTo().window(handle);
//断言浏览器页面的Title属性值是否是 SeleniumElement
Assert.assertEquals(driver.getTitle(),"SeleniumElement");
driver.findElement(By.xpath("//input[@id='input']")).sendKeys("123456");
二十二、使用页面文字内容识别和处理新弹出的浏览器窗口
HTML源码（同二十一）
java代码
//打开新窗口 百度页面
driver.findElement(By.xpath("//a[text()='Open new window打开百度']")).click();
//获取当前页面的句柄
String OldHandle=driver.getWindowHandle();
//获取所有句柄
Set<String> AllHandle=driver.getWindowHandles();
//判断如果AllHandle不为空则进行遍历AllHandle
if(!AllHandle.isEmpty()){
try{
for(String Handle:AllHandle){
//调用driver.switchTo().window(Handle).getPageSource().contains()方法
//逐个获取页面的源码，判断是否包含“百度一下，你就知道”
if(driver.switchTo().window(Handle).getPageSource().contains("百度一下，你就知道"))
//如果判断成立，则说明当前页面为百度首页，并在输入框中输入 java
driver.findElement(By.xpath("//input[@id='kw']")).sendKeys("java");
}
}catch(NoSuchWindowException e){
e.printStackTrace();
}
//调用driver.switchTo().window()方法切到原页面，在输入框中输入old页面
driver.switchTo().window(OldHandle).findElement(By.xpath("//input[@id='input']")).sendKeys("old页面");
//断言页面源码包含 SeleniumElement
Assert.assertTrue(driver.getPageSource().contains("SeleniumElement"));
二十三、alert弹窗
HTML源码：
<input id='test' type='button' onclick="alert('这是一个alert弹框');" value='单击此按钮，弹出alert弹窗'>
java代码：
//定位Alert弹窗
WebElement At=driver.findElement(By.id("test"));
//点击alert按钮
At.click();
//选择alert弹窗
Alert alert=driver.switchTo().alert();
//获取alert弹窗中的文本内容
String text=alert.getText();
//校验alert弹窗中的文本
Assert.assertEquals(text,"这是一个alert弹框");
//点击alert弹窗中的确定按钮
alert.accept();
二十四、Confirm弹窗
HTML源码：
<input id='testcf' type='button' onclick="confirm('这是一个confirm弹框');" value='单击此按钮，弹出confirm弹窗'></input>
java代码：
//定位confirm按钮
WebElement Cf=driver.findElement(By.xpath("//*[@id='testcf']"));
Cf.click();
//选取alert弹窗
Alert confirm=driver.switchTo().alert();
//点击confirm弹窗上的确定按钮
confirm.accept();
//点击confirm弹窗上面的取消按钮
//confirm.dismiss();
二十五、prompt弹窗
HTML源码
<input id='testpt' type='button' onclick="prompt('这是一个prompt弹框');" value='单击此按钮，弹出prompt弹窗'></input>
Java代码
//定位prompt按钮
WebElement Cf=driver.findElement(By.xpath("//*[@id='testpt']"));
Cf.click();
//选取alert弹窗
Alert prompt=driver.switchTo().alert();
//在prompt弹窗的输入框中输入文字
prompt.sendKeys("在prompt弹窗中的输入框中输入123za。。。");
Thread.sleep(3000);
//点击prompt弹窗中的确定按钮
prompt.accept();
//点击Prompt弹窗中的取消按钮
//prompt.dismiss();
二十六、Frame(iFrame)中元素的定位和操作
frame标签有frameset、frame、iframe三种，frameset在selenium中跟其他普通标签没有区别，不需要层层切换，不影响正常的定位。而frame与iframe需要层层切，他俩对selenium定位而言是一样的，selenium有一组方法对frame(iFrame)进行操作。具体方法有如下几种（java代码中都有用到）：
① 使用iframe标签的id或name属性值定位到iframe
② 使用WebElement方法定位到iframe
③ 使用index方法定位到iframe
④ 使用iframe中的HTML源码定位到iframe
HTML源码
<html>
<head>
<title>Frame</title>
<meta http-equiv=Content-Type content="text/html;charset=utf-8">
<meta http-equiv=X-UA-Compatible content="IE=edge,chrome=1">
<meta content=always name=referrer>
</head>
<body>
<td>Input输入框</td>
<div id='put' >
<input type="text" id="input" name='ips'/>
</div>
<br>
<div id='iFrame'>
<td>Iframe1</td><br>
<iframe width=700 height=153 id=iFrameId frameborder=0 src="Xpath.html"></iframe>
<br>
<br>
<td>Iframe2</td><br>
<iframe width=700 height=150 name=iFrameName frameborder=0 src="Xpath.html"></iframe>
</div>
</body>
</html>
java代码
//通过iframe标签的id属性值定位到Iframe1中的iframe，并将控制权交给它
driver.switchTo().frame("iFrameId");
//定位iframe框架1中的输入框并输入 iFreme1
WebElement iF1=driver.findElement(By.xpath("//input[@id='input']"));
iF1.sendKeys("iFreme1");
//等2秒看效果
Thread.sleep(2000);
//清除文本
iF1.clear();
//控制权交回原来的界面
driver.switchTo().defaultContent();
//在外面的输入框中输入 defaultContend
WebElement in=driver.findElement(By.xpath("//input[@id='input']"));
in.sendKeys("defaultContend");
Thread.sleep(2000);
in.clear();
Thread.sleep(2000);
//通过iframe的name属性值定位Iframe2中的iframe，并将控制权交给它
driver.switchTo().frame("iFrameName");
//在Iframe框架2中的输入框中输入iFrame2
WebElement iF2=driver.findElement(By.xpath("//input[@id='input']"));
iF2.sendKeys("iFreme2");
Thread.sleep(2000);
iF2.clear();
//控制权交回原来的界面
driver.switchTo().defaultContent();
Thread.sleep(2000);
//通过WebElement方法定位到iFrame。
//通过iframe标签的height属性值定位iframe1
WebElement ifr1=driver.findElement(By.xpath("//iframe[@height='153']"));
//控制权交给iframe1
driver.switchTo().frame(ifr1);
//定位里面的输入框
WebElement iFrame1input=driver.findElement(By.id("input"));
//输入 WebElement
iFrame1input.sendKeys("WebElement");
Thread.sleep(2000);
//清除文本
iFrame1input.clear();
//控制权交给原来的界面
driver.switchTo().defaultContent();
//使用index方法进入指定iframe，索引号从 0 开始
//控制权交给iframe2。如果是0的话切到iframe1中
driver.switchTo().frame(1);
//定位里面的输入框
WebElement iFrame2input=driver.findElement(By.id("input"));
//输入 WebElement
iFrame2input.sendKeys("index");
//清除文本
Thread.sleep(2000);
iFrame2input.clear();
//控制权交给原来的界面
driver.switchTo().defaultContent();
Thread.sleep(2000);
//使用iframe中的HTML源码内容来定位操作iframe
//找到页面中所有iframe，并存储到iframes容器里
List<WebElement> iframes= driver.findElements(By.tagName("iframe"));
//遍历iframes中所有iframe页面，查找包含 iFrameId 的iframe页面
for(WebElement iframe:iframes){
//将控制权交给iframe
driver.switchTo().frame(iframe);
//逐个iframe页面进行判断是否包含 iFrameId 关键字
if(driver.getPageSource().contains("iFrameId")){
//判断成立说明找到指定iframe页面，则在当前iframe页面中的输入框中输入 PageSourceIFrameID
WebElement pg=driver.findElement(By.id("input"));
pg.sendKeys("PageSourceIFrameID");
//找到指定iframe后退出for循环
break;
}else{
//如果没有找到指定iframe，则退出当前iframe页面。for循环继续进入下一轮循环
driver.switchTo().defaultContent();
}
}
//找到指定iframe页面并执行完后面语句后退出当前iframe页面
driver.switchTo().defaultContent();
//在输入框中输入 控制权回到原点
driver.findElement(By.id("input")).sendKeys("控制权回到原点");
二十七、操作浏览器的Cookie
可以在浏览器开发者工具页面查看效果，查看cookies路径：APPlication->Cookies
java代码
import org.openqa.selenium.Cookie;
driver.get("http://www.baidu.com");
//获取cookies
Set<Cookie> data = driver.manage().getCookies();
System.out.println(data);
//获得cookies个数
System.out.println(driver.manage().getCookies().size());
//删除所有cookies
driver.manage().deleteAllCookies();
//获得cookies个数,此时cookies的个数为0
System.out.println(driver.manage().getCookies().size());
//设置cookies
Cookie c1 = new Cookie("addCookies", "123456789");
driver.manage().addCookie(c1);
//新增了一条，此时cookie个数为1
System.out.println(driver.manage().getCookies().size());
二十八、查看输入框输入的字符
java代码
driver.get("http://www.baidu.com");
WebElement input=driver.findElement(By.id("kw"));
input.sendKeys("Selenium");
//调用getAttribute方法获取到输入框中的文本内容，并赋给text
String text=input.getAttribute("value");
//断言
Assert.assertEquals("Selenium",text);
System.out.println(text);
浙公网安备 33010602011771号