JavaSelenium 页面常用基本操作语法
-
元素定位
findElement() 方法返回一个元素, 如果没有找到,会抛出一个异常 NoElementFindException()
findElements()方法返回多个元素, 如果没有找到,会返回空数组, 不会抛出异常。
语法:WebElement element = driver.findElement(By.XXXX("XXXX"));
以下为定位方式:by.后面的
id,name,className,tagName,linkText("链接的全部文字"),partialLinkText("链接的部分文字"),cssSelector(“css表达式”),xpath("//input[@id='XXXX']") |
xpath地址常见语法(详细内容见另笔记)://XXXX[@XX='XXXX'] 或 //XXXX[contains,(@XXXX,'XXXX')] 或 //*[@id='list']/li[1]/div[2]/span[1]
|
-
页面操作
driver.navigate().back(); //回到上一页
driver.navigate().forward(); //跳转下一页
driver.getTitle(); // 获取当前页面的标题
driver.getCurrentUrl(); // 获取当前页面的url
-
元素常规操作
WebElement.click();
WebElement.clear(); //清空
WebElement.sendKeys("掘金网"); //输入文本
WebElement.sendKeys("c:\shao.png");
WebElement.getText();
-
判断相关方法
WebElement.isEnabled() //是否可点击
WebElement.isSelected(); //是否选中
WebElement.isDisplayed() //是否显示
-
鼠标操作
需要先实例化一个Actions,且每次点击都必须添加perform(翻译:执行)
Actions action = new Actions(driver);
action.click().perform(); //鼠标左击
action.contextClick().perform(); //鼠标右击
action.doubleClick().perform(); //鼠标双击
action.moveToElement(WebElement XX).perform(); //鼠标悬停
// 鼠标拖动实现
driver.findElement(By.xpath("//*[@id='tbPic']")).click();
WebElement begin = driver.findElement(By.xpath("//*[@id='list']/li[1]/div[2]/span[1]"));
WebElement end = driver.findElement(By.xpath("//*[@id='list']/li[2]/div[2]/span[1]"));
action .dragAndDrop(begin, end).perform();
action .dragAndDropBy(WebElement element, int x, int y).perform(); //将element元素水平拖动x,垂直拖动y像素
-
点选框及下拉列表框操作
//单选框
WebElement radio=driver.findElement(By.id("XXXXX"));
radio.isSelected(); //判断某个单选项是否被选中
radio.click(); //选择某个选项
radio.clear(); //清空选项
//复选框
WebElement checkbox = driver.findElement(By.id("XXXXX"));
checkbox.isSelected();//是否选中
checkbox.click();
//下拉框选择
Select select = new Select(driver.findElement(By.id("frequency")));
select.selectByValue("1");
driver.findElement(By.id("validDays")).click();
-
弹框警告处理
Alert alert = driver.switchTo().alert();
alert.accept(); //确定
alert.dismiss(); //取消
-
iframe中元素定位方法:先定位iframe,用switchTo().frame(XXXXX)切换再定位其他元素
WebElement iframeElement = driver.findElement(By.xpath("//iframe[contains(@id,'x-URS-iframe')]"));
driver.switchTo().frame(iframeElement);
//要操作原页面元素,需要切回
driver.switchTo().defaultContent(); //回到默认的页面
driver.switchTo().parentFrame(); //切回父级框
-
弹出页面切换操作(如多个页面间切换)
getWindowHandle(); 与 getWindowHandles();
//举例说明
public void windowshandle() {
windowsHandle = driver.getWindowHandle(); //获取当前页面handle
Set<String> handles = driver.getWindowHandles(); //获取浏览器所有页面handle
for(String s : handles) { //JDK1.5 for循环新写法,简洁效率
if(s.equals(windowsHandle)) {
continue; //遍历,如果handles中的一个handle等于当前页面handle,说明没切换页面,跳出本次循环,继续下次循环
}
System.out.println(s);
driver.switchTo().window(s);
}
driver.findElement(By.linkText("案例")).click();
}
-
元素等待
//分3种等待:
-
强制等待,休眠线程(死等):Thread.sleep(2000); //等待2s
-
隐式等待: 如果在规定的时间,找到了元素就继续操作,否则就报错(#条件满足,还是会继续等待完时间)* 语法: driver.manage().timeouts().implicitlyWait(timeout, TimeUnit.SECONDS);* (第一个参数将接受时间作为整数值,例如10(共等待10s),第二个参数将接受时间测量)* 应用场景:全局,例如所有元素在10s没出现都抛出异常
-
显示等待:如果在规定的时间内,满足条件就继续操作,否则就报错(#条件满足就操作,不继续等待)* 使用前先实例化: WebDriverWait wait = new WebDriverWait(driver,timeout);* (第一个参数为WebDriver对象,第二个参数为整数时间,例如10(共等10s))* 语法:(ExpectedConditions类中方法)wait.until(ExpectedConditions.XXXX);
ExpectedConditions方法:
.elementSelectionStateToBe()
例如://判断某个元素的选中状态是否符合预期
ExpectedConditions.elementSelectionStateToBe(By.xpath("//*[@id='kw']"), true);
//判断某个元素(已定位)的选中状态是否符合预期
ExpectedConditions.elementSelectionStateToBe(driver.findElement(By.xpath("//*[@id='kw']")), false);
.elementToBeSelected()
例如://判断某个元素是否被选中,一般用在下拉列表
ExpectedConditions.elementToBeSelected(By.xpath("//*[@id='kw']"));
.frameToBeAvaliableAndSwitchToIt()
例如://判断该表单是否可以切过去,可以就切过去并返回true,否则放回false
ExpectedConditions.frameToBeAvailableAndSwitchToIt(By.id("**"));
.invisibilityOfTheElementLocated()
例如://判断某个元素是否不存在于DOM或不可见
ExpectedConditions.invisibilityOfElementLocated(By.xpath("//*[@id='kw']"));
.invisibilityOfElementWithText()
.presenceOfAllElementsLocatedBy()
例如://只要存在一个就是true
ExpectedConditions.presenceOfAllElementsLocatedBy(By.xpath("//*[@id='kw']"));
.textToBePresentInElement()
.textToBePresentInElementLocated()
例如://元素中的text是否包含语气的字符串
ExpectedConditions.textToBePresentInElementLocated(By.xpath("//*[@id='kw']"), "百度一下");
.visibilityOfAllElements()//判断所有元素是否可见
.textToBePresentInElementValue()
例如://元素的value属性中是否包含XXXX的字符串
ExpectedConditions.textToBePresentInElementValue(By.xpath("//*[@id='kw']"), "XXXX");
.titleIs() //标题是不是XXXX
.titleContains() //标题是否包含XXXX
.visibilityOf()
例如://判断元素(定位后)是否可见
ExpectedConditions.visibilityOf(driver.findElement(By.xpath("//*[@id='kw']")));
.alertIsPresent()//判断页面中是否存在alert
.visibilityOfAllElementsLocatedBy()
.visibilityOfElementLocated()
例如://判断元素是否可见(非隐藏,并且元素的宽和高都不等以0)
ExpectedConditions.visibilityOfElementLocated(By.xpath("//*[@id='kw']"));
.presenceOfElementLocated(By.id("XXX"))
例如://判断该元素是否被加载在DOM中,并不代表该元素一定可见
ExpectedConditions.presenceOfElementLocated(By.xpath("//*[@id='kw']"));
.elementToBeClickable(By.id("XXX"))
例如://判断元素是否可以点击
ExpectedConditions.elementToBeClickable(By.xpath("//*[@id='kw']"));