Selenium常用API详解介绍

Posted workey

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了Selenium常用API详解介绍相关的知识，希望对你有一定的参考价值。


转至元数据结尾

 

转至元数据起始

 

 

 

一、selenium元素定位

1.selenium定位方法


Selenium提供了8种定位方式。

  • id
  • name
  • class name
  • tag name
  • link text
  • partial link text
  • xpath
  • css selector


这8种定位方式在Python selenium中所对应的方法为：

  • findElement(By.id())
  • findElement(By.name())
  • findElement(By.className())
  • findElement(By.tagName())
  • findElement(By.linkText())
  • findElement(By.partialLinkText())
  • findElement(By.xpath())
  • findElement(By.cssSelector())

2.定位方法的用法

假如我们有一个Web页面，通过前端工具（如，Firebug）查看到一个元素的属性是这样的。

  1. <html>

  2. <head>

  3. <body link="#0000cc">

  4. <a id="result_logo" href="/" onmousedown="return c({‘fm‘:‘tab‘,‘tab‘:‘logo‘})">

  5. <form id="form" class="fm" name="f" action="/s">

  6. <span class="soutu-btn"></span>

  7. <input id="kw" class="s_ipt" name="wd" value="" maxlength="255" autocomplete="off">

我们的目的是要定位input标签的输入框。

  • 通过id定位： 
    driver.findElement(By.id("kw"))
  • 通过name定位： 
    driver.findElement(By.name("wd"))
  • 通过class name定位： 
    driver.findElement(By.className("s_ipt"))
  • 通过tag name定位： 
    driver.findElement(By.tagName("input"))
  • 通过xpath定位，xpath定位有N种写法，这里列几个常用写法：

    1. driver.findElement(By.xpath("//*[@id=‘kw‘]"))

    2. driver.findElement(By.xpath("//*[@name=‘wd‘]"))

    3. driver.findElement(By.xpath("//input[@class=‘s_ipt‘]"))

    4. driver.findElement(By.xpath("/html/body/form/span/input"))

    5. driver.findElement(By.xpath("//span[@class=‘soutu-btn‘]/input"))

    6. driver.findElement(By.xpath("//form[@id=‘form‘]/span/input"))

    7. driver.findElement(By.xpath("//input[@id=‘kw‘ and @name=‘wd‘]"))

  • 通过css定位，css定位有N种写法，这里列几个常用写法：

    1. driver.findElement(By.cssSelector("#kw")

    2. driver.findElement(By.cssSelector("[name=wd]")

    3. driver.findElement(By.cssSelector(".s_ipt")

    4. driver.findElement(By.cssSelector("html > body > form > span > input")

    5. driver.findElement(By.cssSelector("span.soutu-btn> input#kw")

    6. driver.findElement(By.cssSelector("form#form > span > input")

接下来，我们的页面上有一组文本链接。

  1. <a class="mnav" href="http://news.baidu.com" name="tj_trnews">新闻</a>

  2. <a class="mnav" href="http://www.hao123.com" name="tj_trhao123">hao123</a>

  • 通过link text定位：

    1. driver.findElement(By.linkText("新闻")

    2. driver.findElement(By.linkText("hao123")

  • 通过partialLink text定位：

    1. driver.findElement(By.partialLinkText("新")

    2. driver.findElement(By.partialLinkText("hao")

    3. driver.findElement(By.partialLinkText("123")


关于xpaht和css的定位比较复杂，请参考： xpath语法、css选择器

二、控制浏览器操作

1.控制浏览器窗口大小


有时候我们希望能以某种浏览器尺寸找开，访问的页面在这种尺寸下运行。例如可以将浏览器设置成移动端大小(480* 800)，然后访问移动站点，对其样式进行评估；WebDriver 提供了 manage().window().setSize()方法来设置浏览器的大小。

  • maximize() 设置浏览器最大化
  • setSize() 设置浏览器宽高
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
import org.openqa.selenium.Dimension;
 
import org.openqa.selenium.WebDriver;
 
import org.openqa.selenium.chrome.ChromeDriver;
public class Browser {
public static void main(String[] args) throws InterruptedException {
    WebDriver driver= new ChromeDriver();
    driver.get("https://www.baidu.cn");
    driver.manage().window().maximize();
    Thread.sleep(2000);
    driver.get("https://m.baidu.cn");
 
    driver.manage().window().setSize(new Dimension(480, 800));
 
    Thread.sleep(2000);
    driver.quit();
    }
}

在 PC 端执行自动化测试脚本大多的情况下是希望浏览器在全屏幕模式下执行， 那么可以使用 maximize()方法使打开的浏览器全屏显示， 其用法与 setSize()相同， 但它不需要任何参数。

2.控制浏览器后退、前进


在使用浏览器浏览网页时，浏览器提供了后退和前进按钮，可以方便地在浏览过的网页之间切换，WebDriver也提供了对应的back()和forward()方法来模拟后退和前进按钮。下面通过例子来演示这两个方法的使用。

  • back() 模拟浏览器后退按钮
  • forward() 模拟浏览器前进按钮
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
import org.openqa.selenium.WebDriver;
 
import org.openqa.selenium.chrome.ChromeDriver;
 
import org.openqa.selenium.By;
public class BrowserGo {
    public static void main(String[] args) throws InterruptedException {
        WebDriver driver = new ChromeDriver();
        //get 到百度首页
        driver.get("https://www.baidu.com/");
        System.out.printf("now accesss %s ", driver.getCurrentUrl());
        Thread.sleep(2000);
 
        //点击“新闻” 链接
        driver.findElement(By.linkText("新闻")).click();
        System.out.printf("now accesss %s ", driver.getCurrentUrl());
        Thread.sleep(2000);
        //执行浏览器后退
        driver.navigate().back();
        System.out.printf("back to %s ", driver.getCurrentUrl());
        Thread.sleep(2000);
        //执行浏览器前面
        driver.navigate().forward();
        System.out.printf("forward to %s ", driver.getCurrentUrl());
        Thread.sleep(2000);
        driver.quit();
    }
}

 

为了看清脚本的执行过程，下面每操作一步都通过printf()方法来打印当前的URL地址。

3.刷新页面


有时候需要手动刷新（F5） 页面。

  • refresh() 刷新页面（F5）

  1. ……

  2. //刷新页面

  3. driver.navigate().refresh();

  4. ……

三、WebDriver常用方法


前面我们已经学习了定位元素， 定位只是第一步， 定位之后需要对这个元素进行操作， 或单击（按钮） 或 输入（输入框） ， 下面就来认识这些最常用的方法。 

1.WebDriver 常用方法


下面先来认识 WebDriver 中最常用的几个方法：

  • clear() 清除文本。
  • sendKeys(*value) 模拟按键输入。
  • click() 单击元素
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.chrome.ChromeDriver;
public class BaiduDemo {
    public static void main(String[] args) {
        WebDriver driver = new ChromeDriver();
        driver.get("https://www.baidu.com/");
        WebElement search_text = driver.findElement(By.id("kw"));
        WebElement search_button = driver.findElement(By.id("su"));
 
        search_text.sendKeys("Java");
        search_text.clear();
        search_text.sendKeys("Selenium");
        search_button.click();
        driver.quit();
    }
}

 

clear()方法用于清除文本输入框中的内容。
sendKeys()方法模拟键盘向输入框里输入内容。 但是它的作用不仅于此， 我们还可以用它发送键盘按键， 甚至用它来指定上传的文件。
click()方法可以用来单击一个元素，前提是它是可以被单击的对象，它与 sendKeys()方法是Web页面操作中最常用到的两个方法。 其实click()方法不仅仅用于单击一个按钮，它还可以单击任何可以单击的文字/图片链接、复选框、单选框、下拉框等。

2.其它常用方法

 

  • submit()

submit()方法用于提交表单。 例如，在搜索框输入关键字之后的“回车” 操作， 就可以通过 submit()方法模拟.

  1. ……

  2. WebElement search_text = driver.findElement(By.id("kw"));

  3. search_text.sendKeys("Selenium");

  4. search_text.submit();

  5. ……

  • getSize() 返回元素的尺寸。
  • getText() 获取元素的文本。
  • getAttribute(name) 获得属性值。
  • isDisplayed() 设置该元素是否用户可见。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.chrome.ChromeDriver;
 
public class BaiduDemo {
    public static void main(String[] args) {
        WebDriver driver = new ChromeDriver();
        driver.get("https://www.baidu.com/");
        //获得百度输入框的尺寸
        WebElement size = driver.findElement(By.id("kw"));
        System.out.println(size.getSize());
 
        //返回百度页面底部备案信息
        WebElement text = driver.findElement(By.id("cp"));
        System.out.println(text.getText());
 
        //返回元素的属性值， 可以是 id、 name、 type 或元素拥有的其它任意属性
        WebElement ty = driver.findElement(By.id("kw"));
        System.out.println(ty.getAttribute("type"));
 
        //返回元素的结果是否可见， 返回结果为 True 或 False
        WebElement display = driver.findElement(By.id("kw"));
        System.out.println(display.isDisplayed());
        driver.quit();
    }
}

 

打印结果：

  1. (500, 22)

  2. ©2017 Baidu 使用百度前必读 意见反馈 京 ICP 证 030173 号 京公网安备 11000002000001 号

  3. text

  4. true

四、模拟鼠标操作


通过前面例子了解到，可以使用click()来模拟鼠标的单击操作，现在的Web产品中提供了更丰富的鼠标交互方式， 例如鼠标右击、双击、悬停、甚至是鼠标拖动等功能。在WebDriver中，将这些关于鼠标操作的方法封装在ActionChains类提供。
Actions 类提供了鼠标操作的常用方法：

  • contextClick() 右击
  • clickAndHold() 鼠标点击并控制
  • doubleClick() 双击
  • dragAndDrop() 拖动
  • release() 释放鼠标
  • perform() 执行所有Actions中存储的行为


百度首页设置悬停下拉菜单。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
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.interactions.Actions;
 
public class MouseDemo {
    public static void main(String[] args) {
        WebDriver driver = new ChromeDriver();
        driver.get("https://www.baidu.com/");
        WebElement search_setting = driver.findElement(By.linkText("设置"));
        Actions action = new Actions(driver);
        action.clickAndHold(search_setting).perform();
        driver.quit();
    }
}


导入提供鼠标操作的 ActionChains 类

  • Actions(driver) 调用Actions()类，将浏览器驱动driver作为参数传入。
  • clickAndHold() 方法用于模拟鼠标悬停操作， 在调用时需要指定元素定位。
  • perform() 执行所有ActionChains中存储的行为， 可以理解成是对整个操作的提交动作。

1.关于鼠标操作的其它方法

import org.openqa.selenium.interactions.Actions;
……
Actions action = new Actions(driver);
// 鼠标右键点击指定的元素
action.contextClick(driver.findElement(By.id("element"))).perform();
// 鼠标右键点击指定的元素
 
action.doubleClick(driver.findElement(By.id("element"))).perform();
 
// 鼠标拖拽动作， 将 source 元素拖放到 target 元素的位置。
WebElement source = driver.findElement(By.name("element"));
WebElement target = driver.findElement(By.name("element"));
action.dragAndDrop(source,target).perform();
 
// 释放鼠标
action.release().perform();

五、模拟键盘操作

Keys()类提供了键盘上几乎所有按键的方法。 前面了解到， sendKeys()方法可以用来模拟键盘输入， 除此之 外， 我们还可以用它来输入键盘上的按键， 甚至是组合键， 如 Ctrl+A、 Ctrl+C 等。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
import org.openqa.selenium.WebElement;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.chrome.ChromeDriver;
import org.openqa.selenium.By;
import org.openqa.selenium.Keys;
 
public class Keyboard {
    public static void main(String[] args)throws InterruptedException {
        WebDriver driver = new ChromeDriver();
        driver.get("https://www.baidu.com");
        WebElement input = driver.findElement(By.id("kw"));
        //输入框输入内容
        input.sendKeys("seleniumm");
        Thread.sleep(2000);
 
        //删除多输入的一个 m
        input.sendKeys(Keys.BACK_SPACE);
        Thread.sleep(2000);
 
        //输入空格键+“教程”
        input.sendKeys(Keys.SPACE);
        input.sendKeys("教程");
        Thread.sleep(2000);
 
        //ctrl+a 全选输入框内容
        input.sendKeys(Keys.CONTROL,"a");
        Thread.sleep(2000);
 
        //ctrl+x 剪切输入框内容
        input.sendKeys(Keys.CONTROL,"x");
        Thread.sleep(2000);
 
        //ctrl+v 粘贴内容到输入框
        input.sendKeys(Keys.CONTROL,"v");
        Thread.sleep(2000);
 
        //通过回车键盘来代替点击操作
        input.sendKeys(Keys.ENTER);
        Thread.sleep(2000);
        driver.quit();
    }
}

需要说明的是，上面的脚本没有什么实际意义，但向我们展示了模拟键盘各种按键与组合键的用法。

  • import org.openqa.selenium.Keys;


在使用键盘按键方法前需要先导入 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

六、获取断言信息


不管是在做功能测试还是自动化测试，最后一步需要拿实际结果与预期进行比较。这个比较的称之为断言。
我们通常可以通过获取title 、URL和text等信息进行断言。text方法在前面已经讲过，它用于获取标签对之间的文本信息。

  • getTitle()： 用于获得当前页面的title。
  • getCurrentUrl() ： 用户获得当前页面的URL。
  • getText() 获取页面文本信息。

下面同样以百度为例，介绍如何获取这些信息。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
import org.openqa.selenium.By;
import org.openqa.selenium.Keys;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.chrome.ChromeDriver;
 
public class AssertDemo {
    public static void main(String[] args) throws InterruptedException {
        WebDriver driver = new ChromeDriver();
        driver.get("https://www.baidu.com");
        System.out.println("Search before================");
 
        //获取当前的 title 和 url
        System.out.printf("title of current page is %s ", driver.getTitle());
        System.out.printf("url of current page is %s ", driver.getCurrentUrl());
 
        //百度搜索
        WebElement search = driver.findElement(By.id("kw"));
        search.sendKeys("Selenium");
        search.sendKeys(Keys.ENTER);
        Thread.sleep(2000);
        System.out.println("Search after================");
 
        //获取当前的 title 和 url
        System.out.printf("title of current page is %s ", driver.getTitle());
        System.out.printf("url of current page is %s ", driver.getCurrentUrl());
 
        //获取第一条搜索结果的标题
        WebElement result = driver.findElement(By.xpath("//div[@id=‘content_left‘]/div/h3/a"));
        System.out.println(result.getText());
        driver.quit();
    }
}

打印结果：

  1. Search before================

  2. title of current page is 百度一下， 你就知道

  3. url of current page is https://www.baidu.com/

  4.  

  5. Search after================

  6. title of current page is Selenium_百度搜索

  7. url of current page is

  8. https://www.baidu.com/s?ie=utf-8&f=8&rsv_bp=0&rsv_idx=1&tn=baidu&wd=Selenium&rsv_pq=9be

  9. 4680700a485c1&rsv_t=e925U%2F%2B9SBTqmRI%2BuARg0%2BTCzrrZWn4jOBJkb1OS2vUjMrZsq5VblQ7toD8

  10. &rqlang=cn&rsv_enter=1&rsv_sug3=8&rsv_sug2=0&inputT=155&rsv_sug4=155

  11. Selenium - Web Browser Automation

七、设置元素等待

WebDriver提供了两种类型的等待：显式等待和隐式等待。

1.显示等待

WebDriver提供了显式等待方法，专门针对某个元素进行等待判断。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
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.WebDriverWait;
import org.openqa.selenium.support.ui.ExpectedCondition;
 
 
public class TimeOut01 {
    public static void main(String[]args) throws InterruptedException {
        WebDriver driver = new ChromeDriver();
        driver.get("https://www.baidu.com");
 
        //显式等待， 针对某个元素等待
        WebDriverWait wait = new WebDriverWait(driver,10,1);
        wait.until(new ExpectedCondition<WebElement>(){
            @Override
            public WebElement apply(WebDriver text) {
                return text.findElement(By.id("kw"));
            }
        }).sendKeys("selenium");
 
        driver.findElement(By.id("su")).click();
        Thread.sleep(2000);
        driver.quit();
    }
}

WebDriverWait类是由WebDirver提供的等待方法。在设置时间内，默认每隔一段时间检测一次当前页面元素是否存在，如果超过设置时间检测不到则抛出异常。具体格式如下：
WebDriverWait(driver, 10, 1)
driver： 浏览器驱动。 10： 最长超时时间， 默认以秒为单位。 1： 检测的的间隔（步长） 时间， 默认为 0.5s。

2.隐式等待

WebDriver 提供了几种方法来等待元素。

  • implicitlyWait。识别对象时的超时时间。过了这个时间如果对象还没找到的话就会抛出NoSuchElement异常。
  • setScriptTimeout。异步脚本的超时时间。WebDriver可以异步执行脚本，这个是设置异步执行脚本脚本返回结果的超时时间。
  • pageLoadTimeout。页面加载时的超时时间。因为WebDriver会等页面加载完毕再进行后面的操作，所以如果页面超过设置时间依然没有加载完成，那么WebDriver就会抛出异常。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
import org.openqa.selenium.chrome.ChromeDriver;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.By;
import java.util.concurrent.TimeUnit;
 
public class TimeOut02 {
    public static void main(String[] args){
        WebDriver driver = new ChromeDriver();
        //页面加载超时时间设置为 5s
        driver.manage().timeouts().pageLoadTimeout(5, TimeUnit.SECONDS);
        driver.get("https://www.baidu.com/");
 
        //定位对象时给 10s 的时间, 如果 10s 内还定位不到则抛出异常
        driver.manage().timeouts().implicitlyWait(10, TimeUnit.SECONDS);
        driver.findElement(By.id("kw")).sendKeys("selenium");
 
        //异步脚本的超时时间设置成 3s
        driver.manage().timeouts().setScriptTimeout(3, TimeUnit.SECONDS);
        driver.quit();
    }
}

 

八、定位一组元素

在第（五）节我们已经学习了8种定位方法， 那8种定位方法是针对单个元素定位的， WebDriver还提供了另外8种用于定位一组元素的方法。

  1. import org.openqa.selenium.By;

  2. ......

  3. findElements(By.id())

  4. findElements(By.name())

  5. findElements(By.className())

  6. findElements(By.tagName())

  7. findElements(By.linkText())

  8. findElements(By.partialLinkText())

  9. findElements(By.xpath())

  10. findElements(By.cssSelector())

定位一组元素的方法与定位单个元素的方法类似，唯一的区别是在单词 findElement 后面多了一个 s 表示复数。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.chrome.ChromeDriver;
import java.util.List;
 
public class ElementsDemo {
    public static void main(String[] args) throws InterruptedException {
        WebDriver driver = new ChromeDriver();
        driver.get("https://www.baidu.com/");
        WebElement search_text = driver.findElement(By.id("kw"));
        search_text.sendKeys("selenium");
        search_text.submit();
        Thread.sleep(2000);
 
        //匹配第一页搜索结果的标题， 循环打印
        List<WebElement> search_result = driver.findElements(By.xpath("//div/div/h3"));
 
        //打印元素的个数
        System.out.println(search_result.size());
 
        // 循环打印搜索结果的标题
        for(WebElement result : search_result){
            System.out.println(result.getText());
        }
        System.out.println("-------我是分割线---------");
 
        //打印第n结果的标题
        WebElement text = search_result.get(search_result.size() - 10);
        System.out.println(text.getText());
        driver.quit();
    }
}

打印结果：

  1. 15

  2. selenium java 教程-90 天从入门到高薪「学习必看」

  3. python selenium 视频-90 天从入门到高薪「学习必看」

  4. Selenium - Web Browser Automation

  5. 功能自动化测试工具——Selenium 篇

  6. Selenium Documentation — Selenium Documentation

  7. selenium + python 自动化测试环境搭建 - 虫师 - 博客园

  8. selenium_百度翻译

  9. Selenium_百度百科

  10. 怎样开始用 selenium 进行自动化测试(个人总结)_百度经验

  11. Selenium 官网教程_selenium 自动化测试实践_Selenium_领测软件测试网

  12. Selenium - 开源中国社区

  13. selenium 是什么?_百度知道

  14. selenium-0 基础入学， 先就业后付款!

  15. selenium， 亚马逊官网， 正品低价， 货到付款!

  16. selenium java 教程-90 天从入门到高薪「学习必看」

  17. -------我是分割线---------

  18. selenium + python 自动化测试环境搭建 - 虫师 - 博客园

九、多表单切换

在 Web 应用中经常会遇到 frame/iframe 表单嵌套页面的应用， WebDriver 只能在一个页面上对元素识别与 定位， 对于 frame/iframe 表单内嵌页面上的元素无法直接定位。 这时就需要通过 switchTo().frame()方法将当前定 位的主体切换为 frame/iframe 表单的内嵌页面中。

  1. <html>

  2. <body>

  3. ...

  4. <iframe id="x-URS-iframe" ...>

  5. <html>

  6. <body>

  7. ...

  8. <input name="email" >

126邮箱登录框的结构大概是这样子的，想要操作登录框必须要先切换到iframe表单。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.chrome.ChromeDriver;
 
public class MailLogin {
    public static void main(String[] args){
        WebDriver driver = new ChromeDriver();
        driver.get("http://www.126.com");
        WebElement xf = driver.findElement(By.xpath("//*[@id=‘loginDiv‘]/iframe"));
        driver.switchTo().frame(xf);
        driver.findElement(By.name("email")).clear();
        driver.findElement(By.name("email")).sendKeys("username");
        driver.findElement(By.name("password")).clear();
        driver.findElement(By.name("password")).sendKeys("password");
        driver.findElement(By.id("dologin")).click();
        driver.switchTo().defaultContent();
        //……
    }
}

如果完成了在当前表单上的操作，则可以通过switchTo().defaultContent()方法跳出表单。

十、多窗口切换


在页面操作过程中有时候点击某个链接会弹出新的窗口， 这时就需要主机切换到新打开的窗口上进行操作。WebDriver提供了switchTo().window()方法可以实现在不同的窗口之间切换。
以百度首页和百度注册页为例，在两个窗口之间的切换如下图。

实现窗口切换的代码如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
import java.util.Set;
import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.chrome.ChromeDriver;
 
public class MoreWindows {
    public static void main(String[] arge) throws InterruptedException{
        WebDriver driver = new ChromeDriver();
        driver.get("https://www.baidu.com");
 
        //获得当前窗口句柄
        String search_handle = driver.getWindowHandle();
 
        //打开百度注册窗口
        driver.findElement(By.linkText("登录")).click();
        Thread.sleep(3000);
        driver.findElement(By.linkText("立即注册")).click();
 
        //获得所有窗口句柄
        Set<String> handles = driver.getWindowHandles();
 
        //判断是否为注册窗口， 并操作注册窗口上的元素
        for(String handle : handles){
            if (handle.equals(search_handle)==false){
                //切换到注册页面
                driver.switchTo().window(handle);
                System.out.println("now register window!");
                Thread.sleep(2000);
                driver.findElement(By.name("userName")).clear();
                driver.findElement(By.name("userName")).sendKeys("user name");
                driver.findElement(By.name("phone")).clear();
                driver.findElement(By.name("phone")).sendKeys("phone number");
                //......
                Thread.sleep(2000);
                //关闭当前窗口
                driver.close();
            }
        }
        Thread.sleep(2000);
        driver.quit();
    }
}

在本例中所涉及的新方法如下：

  • getWindowHandle()： 获得当前窗口句柄。
  • getWindowHandles()： 返回的所有窗口的句柄到当前会话。
  • switchTo().window()： 用于切换到相应的窗口，与上一节的switchTo().frame()类似，前者用于不同窗口的切换， 后者用于不同表单之间的切换。

十一、下拉框选择

有时我们会碰到下拉框，WebDriver提供了Select类来处理下接框。
如百度搜索设置的下拉框，如下图：

搜索下拉框实现代码如下：

  1. <select id="nr" name="NR">

  2. <option value="10" selected>每页显示 10 条</option>

  3. <option value="20">每页显示 20 条</option>

  4. <option value="50">每页显示 50 条</option>

  5. <select>

操作下接框代码如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
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;
 
public class SelectDemo {
    public static void main(String[] args) throws InterruptedException {
        WebDriver driver = new ChromeDriver();
        driver.get("https://www.baidu.com");
        driver.findElement(By.linkText("设置")).click();
        driver.findElement(By.linkText("搜索设置")).click();
        Thread.sleep(2000);
 
        //<select>标签的下拉框选择
        WebElement el = driver.findElement(By.xpath("//select"));
        Select sel = new Select(el);
        sel.selectByValue("20");
        Thread.sleep(2000);
        driver.quit();
    }
}

 

Select类用于定位select标签。 selectByValue()方法符用于选取<option>标签的value值。

十二、警告框处理


在 WebDriver中处理javascript所生成的alert、confirm以及prompt十分简单，具体做法是使用switch_to_alert()方法定位到alert/confirm/prompt，然后使用text/accept/dismiss/sendKeys等方法进行操作。

  • getText()： 返回 alert/confirm/prompt 中的文字信息。
  • accept()： 接受现有警告框。
  • dismiss()： 解散现有警告框。
  • sendKeys(keysToSend)： 发送文本至警告框。
  • keysToSend： 将文本发送至警告框。

如下图，百度搜索设置弹出的窗口是不能通过前端工具对其进行定位的，这个时候就可以通过switchTo().alert()方法接受这个弹窗。

接受一个警告框的代码如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.chrome.ChromeDriver;
 
public class AlertDemo {
    public static void main(String[] args) throws InterruptedException {
        WebDriver driver = new ChromeDriver();
        driver.get("https://www.baidu.com");
        driver.findElement(By.linkText("设置")).click();
        driver.findElement(By.linkText("搜索设置")).click();
        Thread.sleep(2000);
 
        //保存设置
        driver.findElement(By.className("prefpanelgo")).click();
 
        //接收弹窗
        driver.switchTo().alert().accept();
        Thread.sleep(2000);
        driver.quit();
    }
}

 

十三、文件上传

对于通过input标签实现的上传功能，可以将其看作是一个输入框，即通过sendKeys()指定本地文件路径的方式实现文件上传。
创建upfile.html文件，代码如下：

  1. <html>

  2. <head>

  3. <meta http-equiv="content-type" content="text/html;charset=utf-8" />

  4. <title>upload_file</title>

  5. <link href="http://cdn.bootcss.com/bootstrap/3.3.0/css/bootstrap.min.css" rel="stylesheet" />

  6. </head>

  7. <body>

  8. <div class="row-fluid">

  9. <div class="span6 well">

  10. <h3>upload_file</h3>

  11. <input type="file" name="file" />

  12. </div>

  13. </div>

  14. </body>

  15. <script src="http://cdn.bootcss.com/bootstrap/3.3.0/css/bootstrap.min.js"></scrip>

  16. </html>

通过浏览器打开upfile.html文件，功能如下图。

接下来通过sendKeys()方法来实现文件上传。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
import java.io.File;
import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.chrome.ChromeDriver;
 
 
public class UpFileDemo {
    public static void main(String[] args) throws InterruptedException {
        WebDriver driver = new ChromeDriver();
        File file = new File("./HTMLFile/upfile.html");
        String filePath = file.getAbsolutePath();
        driver.get(filePath);
 
        //定位上传按钮， 添加本地文件
        driver.findElement(By.name("file")).sendKeys("D:\upload_file.txt");
        Thread.sleep(5000);
        driver.quit();
    }
}

 

十四、浏览器cookie操作

有时候我们需要验证浏览器中Cookie是否正确， 因为基于真实Cookie的测试是无法通过白盒测试和集成测试进行的。WebDriver提供了操作Cookie的相关方法可以读取、 添加和删除Cookie信息。
WebDriver 操作Cookie的方法：

  • getCookies() 获得所有 cookie 信息。
  • getCookieNamed(String name) 返回字典的key为“name”的Cookie信息。
  • addCookie(cookie dict) 添加Cookie。“cookie_dict”指字典对象，必须有 name和value值。
  • deleteCookieNamed(String name) 删除Cookie 信息。 “name”是要删除的 cookie的名称； “optionsString” 是该Cookie的选项，目前支持的选项包括“路径” ， “域” 。
  • deleteAllCookies() 删除所有 cookie 信息。

下面通过 geCookies()来获取当前浏览器的 cookie 信息。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
import java.util.Set;
import org.openqa.selenium.chrome.ChromeDriver;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.Cookie;
 
public class CookieDemo {
    public static void main(String[] args){
        WebDriver driver = new ChromeDriver();
        driver.get("https://www.baidu.com");
        Cookie c1 = new Cookie("name", "key-aaaaaaa");
        Cookie c2 = new Cookie("value", "value-bbbbbb");
        driver.manage().addCookie(c1);
        driver.manage().addCookie(c2);
 
        //获得 cookie
        Set<Cookie> coo = driver.manage().getCookies();
        System.out.println(coo);
 
        //删除所有 cookie
        //driver.manage().deleteAllCookies();
        driver.quit();
    }
}

 

打印结果：

[BIDUPSID=82803D3E2DAD0F5342D22C8F96B9E088; expires=星期六, 24 二月 208512:40:10 CST; path=/; domain=.baidu.com, name=key-aaaaaaa; path=/;domain=www.baidu.com, PSTM=1486301167; expires=星期六, 24 二月 2085 12:40:10 CST;path=/; domain=.baidu.com,H_PS_PSSID=1437_21094_21943_22023; path=/;domain=.baidu.com, BD_UPN=12314753; expires=星期三, 15 二月 2017 09:26:04 CST;path=/; domain=www.baidu.com, value=value-bbbbbb; path=/;domain=www.baidu.com,BAIDUID=82803D3E2DAD0F5342D22C8F96B9E088:FG=1; expires=星期六, 24 二月 208512:40:10 CST; path=/; domain=.baidu.com, BD_HOME=0; path=/;domain=www.baidu.com, __bsi=16852840641557463410_00_0_I_R_1_0303_C02F_N_I_I_0;expires=星期日, 05 二月 2017 09:26:10 CST; path=/; domain=.www.baidu.com]

十五、调用JavaScript代码

虽然WebDriver提供了操作浏览器的前进和后退方法，但对于浏览器滚动条并没有提供相应的操作方法。在这种情况下，就可以借助JavaScript来控制浏览器的滚动条。WebDriver提供了executeScript()方法来执行JavaScript代码。
用于调整浏览器滚动条位置的JavaScript代码如下：

  1. <!-- window.scrollTo(左边距,上边距); -->

  2. window.scrollTo(0,450);

window.scrollTo()方法用于设置浏览器窗口滚动条的水平和垂直位置。方法的第一个参数表示水平的左间距，第二个参数表示垂直的上边距。其代码如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.Dimension;
import org.openqa.selenium.chrome.ChromeDriver;
import org.openqa.selenium.JavascriptExecutor;
 
public class JSDemo {
    public static void main(String[] args) throws InterruptedException{
        WebDriver driver = new ChromeDriver();
 
        //设置浏览器窗口大小
        driver.manage().window().setSize(new Dimension(700, 600));
        driver.get("https://www.baidu.com");
 
        //进行百度搜索
        driver.findElement(By.id("kw")).sendKeys("webdriver api");
        driver.findElement(By.id("su")).click();
        Thread.sleep(2000);
 
        //将页面滚动条拖到底部
        ((JavascriptExecutor)driver).executeScript("window.scrollTo(100,450);");
        Thread.sleep(3000);
        driver.quit();
    }
}

 

通过浏览器打开百度进行搜索，并且提前通过window().setSize()方法将浏览器窗口设置为固定宽高显示，目的是让窗口出现水平和垂直滚动条。然后通过executeScript()方法执行JavaScripts代码来移动滚动条的位置。
（二十）获取窗口截图
自动化用例是由程序去执行，因此有时候打印的错误信息并不十分明确。如果在脚本执行出错的时候能对当前窗口截图保存，那么通过图片就可以非常直观地看出出错的原因。 WebDriver提供了截图函数getScreenshotAs()来截取当前窗口。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
import java.io.File;
import java.io.IOException;
import org.apache.commons.io.FileUtils;
import org.openqa.selenium.OutputType;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.chrome.ChromeDriver;
import org.openqa.selenium.TakesScreenshot;
 
public class GetImg {
    public static void main(String[] arge){
        WebDriver driver = new ChromeDriver();
        driver.get("https://www.baidu.com");
        File srcFile = ((TakesScreenshot)driver).getScreenshotAs(OutputType.FILE);
        try {
            FileUtils.copyFile(srcFile,new File("d:\screenshot.png"));
        } catch (IOException e) {
            e.printStackTrace();
        }
        driver.quit();
    }
}

 

脚本运行完成后打开D盘，就可以找到screenshot.png图片文件了

以上是关于Selenium常用API详解介绍的主要内容，如果未能解决你的问题，请参考以下文章

python+selenium——详解介绍Selenium常用API的使用--python语言（完整版）

Selenium JavascriptExecutor 详解

Selenium JavascriptExecutor 详解

『心善渊』Selenium3.0基础 — 4Selenium基础元素定位详解

胡楠宇推荐Selenium Webdriver元素定位的八种常用方式详解

python+selenium自动测试之WebDriver的常用API（基础篇一）