一、WebDriver API

一个简单自动化脚本的构成：

脚本解析

• # coding = utf-8
  from selenium import webdriver
  import time
  browser = webdriver.Firefox()
  time.sleep(3)
  browser.get("http://www.baidu.com")
  time.sleep(3)
  browser.find_element_by_id("kw").send_keys("selenium")
  time.sleep(3)
  browser.find_element_by_id("su").click()
  browser.quit()

• coding = utf-8

• from selenium import webdriver

• browser = webdriver.Firefox()

• browser.find_element_by_id("kw").send_keys("selenium")

• browser.find_element_by_id("su").click()

• browser.quit()

browser.close() 也可以关闭窗口。

两者的区别是：close 方法关闭当前的浏览器窗口，quit 方法不仅关闭窗口，还会彻底的退出 WebDriver，释放与 driver server 之间的连接。所以简单来说 quit 是更加彻底的 close，quit 会更好的释放资源。

1、元素的定位

对象的定位应该是自动化测试的核心，要想操作一个对象，首先应该识别这个对象。一个对象就是一个人一样，他会有各种的特征（属性），比如我们可以通过一个人的身份证号，姓名，或者他住在哪个街道、楼层、门牌找到这个人。那么一个对象也有类似的属性，我们可以通过这些属性找到这对象。

注意：不管用那种方式，必须保证页面上该属性的唯一性。

web 自动化测试的操作核心是能够找到页面对应的元素，然后才能对元素进行具体的操作。

WebDriver 提供了一系列的对象定位方法，常用的有以下几种：

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

我们可以看到，一个百度的输入框，可以用这么多种方式去定位。

（1）cssSelector（常用）

CSS（Cascading Style Sheets）是一种语言，它被用来描述 HTML 和 XML 文档的表现。

CSS 使用选择器来为页面元素绑定属性。这些选择器可以被 Selenium 用作另外的定位策略。

CSS 的比较灵活可以选择控件的任意属性，上面的例子中，find_element_by_css_selector("#kw") 通过 find_element_by_css_selector( ) 函数，选择取百度输入框的 id 属性来定义。

CSS 的获取可以用 Chrome 的 F12 开发者模式中 Element-右键-copy-copy selector 来获取。

css 选择语法：

• id 选择器：#id
• 类选择：class
• 标签选择：标签名
• 后代选择器：父级选择器、子级选择器

选择器的功能：选中页面中指定的标签元素。

选择器的种类分为基础选择器和复合选择器，常见的元素定位方式可以通过 id 选择器和子类选择器来进行定位。

定位百度首页的 “百度热搜” 元素，可以使用通过 id 选择器和子类选择器进行定位：#s-hotsearch-wrapper > div

A. id 定位

id 是页面元素的属性，我们最常用元素定位方式，但是不是所有的元素都有 id 的。如果一个元素有 id 属性，那么一般在整个页面是唯一的。所以我们一般可以用 id 来唯一的定位到这个元素。

通过前端工具，例如 Edge 浏览器的 F12，找到了百度输入框的属性信息，如下：

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

属性 id=”kw” 通过 find_element_by_id("kw") 函数就可以定位到百度输入框。

（4）XPath 定位（重点）（常用）

A. 什么是 XPath

Cover page | xpath | W3C standards and drafts | W3C

B. XPath 基础教程

W3Schools Online Web Tutorials

相对路径：/html/head/title（不常用）

绝对路径： 

• 相对路径+索引：//form/span[1]/input
• 相对路径+属性值：//input[@class="s_ipt"]
• 相对路径+通配符：//*[@*="su"]
• 相对路径+文本匹配：//a[text()="新闻"]

XPath 是一种在 XML 文档中定位元素的语言。因为 HTML 可以看做 XML 的一种实现，所以 Selenium 用户可是使用这种强大语言在 Web 应用中定位元素。

XPath 扩展了上面 id 和 name 定位方式，提供了很多种可能性。

XPATH 的获取可以用 Chrome 的 F12 开发者模式中 Element-右键-copy-copy xp。

//*[@id="kw"]

• 获取 HTML 页面所有的节点：//*

• ---

  获取 HTML 页面指定的节点：//[指定节点]

//ul：获取 HTML 页面所有的 ul 节点

//input：获取 HTML 页面所有的 input 节点

css 选择器和 xpath 选择器哪个更好？ 

css 选择器定位元素效率更高。

（5）link text 定位

有时候不是一个输入框也不是一个按钮，而是一个文字链接，我们可以通过链接内容，也就是 link text 来定位。

注意：链接内容必须这个页面唯一，否则会报错。

（6）Partial link text 定位

通过部分链接定位，这个有时候也会用到，我还没有想到很好的用处。拿上面的例子，我可以只用链接的一部分文字进行匹配：

二、操作测试对象

前面讲到了不少知识都是定位元素，定位只是第一步，定位之后需要对这个元素进行操作。是鼠标点击还是键盘输入，或者清除元素的内容，或者提交表单等。这个取决于定位元素需要进行的下一步操作。

Webdriver 中比较常用的操作对象的方法有下面几个：

• click 点击对象。
• send_keys 在对象上模拟按键输入。
• clear 清除对象输入的文本内容。
• submit 提交。
• text 用于获取元素的文本信息。
• get_attribute 获得属性值。

1、click 点击 / 提交对象

click() # 用于点击一个按钮

页面上任意元素都可以进行点击操作。

sendKeys("")
# send_keys("xx") 用于在一个输入框里输入 xx 内容

driver.find_element_by_id("su").submit()

getText()

getTitle()
​
getCurrentUrl()

import time
time.sleep() # 单位：秒
# 当调用该方法时，程序会直接阻塞，等待指定秒数后继续执行后面的代码

• 优点：使用简单，调试的时候比较有效。
• 缺点：影响运行效率，浪费大量的时间。 

2、隐式等待

隐式等待是⼀种智能等待，它可以规定在查找元素时，在指定时间内不断查找元素。如果找到则代码继续执行，直到超时没找到元素才会报错。

通过添加 implicitly_wait() 方法就可以方便的实现智能等待。implicitly_wait(30) 的用法比 time.sleep() 更智能，后者只能选择一个固定的时间的等待，而前者可以在一个时间范围内智能的等待。

隐式等待的生命周期：隐式等待作用域是整个脚本的所有元素。即只要 driver 对象没有被释放掉（driver.quit()），隐式等待就一直生效。

• 优点：智能等待，作用于全局。

# new WebDriverWait(driver, Duration.ofSeconds(3)).until($express)
# $press：涉及到selenium.support.ui.ExpectedConditions包下的ExpectedConditions类
# 返回值：boolean

# 示例：
from selenium.webdriver.support import expected_conditions as EC

wait = WebDriverWait(driver, 2)
wait.until(EC.invisibility_of_element((By.XPATH, '//*[@id="2"]/div/div/div[3]/div[1]/div[1]/div')))

driver.close(); # 退出一个窗口

driver.quit(); # 退出浏览器

Alert alert = driver.switchTo.alert();
# 确认
alert.accept()
# 取消
alert.dismiss()

# 注意：switch_to.alert() 只能处理原生的 alert

Alert alert = driver.switchTo.alert();
alert.sendKeys("xxxx");
alert.accept();
alert.dismiss();

3、浏览器导航

（1）打开网站

// 更⻓的⽅法
driver.navigate().to("https://selenium.dev");

// 简洁的⽅法
driver.get("https://selenium.dev");

（2）浏览器的前进、后退、刷新 

非页面元素，所以需要 selenium 提供的现成的方法：

driver.navigate().back();
driver.navigate().forward();
driver.navigate().refresh();

4、控制浏览器滚动条（重点）

浏览器滚动条的控制需要依靠 js 脚本。

5、浏览器参数设置

（1）设置无头模式

程序在后端运行，界面看不到页面的表现。

自动化打开浏览器默认情况下为有头模式。

（2）设置浏览器加载策略

  options.page_load_strategy = '加载方式';  

driver.get 默认情况下等待所有的资源加载完成之后才能继续往下执行，但是实际上主页面加载完成之后就可以继续执行自动化。若一直等待的话可能会造成页面超时、元素找不到等问题。

页面加载方式主要有三种类型：

1. normal：默认值，等待所有资源下载完成（主体框架、图片、视频等资源）
2. eager：DOM 访问已准备就绪，但诸如图像的其它资源可能仍在加载（推荐）
3. none：完全不会阻塞 WebDriver，直接继续往下执行脚本（不推荐）

#鼠标拖动事件
ActionChains(driver).move_to_element(element).perform()