WebDriver基础
欢迎阅读WebDriver基础讲义。本篇讲义将会重点介绍Selenium WebDriver的环境搭建和基本使用方法。
WebDriver环境搭建
Selenium WebDriver 又称为 Selenium2。
Selenium 1 + WebDriver = Selenium 2
WebDriver是主流Web应用自动化测试框架，具有清晰面向对象 API，能以最佳的方式与浏览器进行交互。
支持的浏览器：
Mozilla Firefox
Google Chrome
Microsoft Internet Explorer
Opera
Safari
Apple iPhone
Android browsers
环境搭建步骤
在上一篇中，我们已经确认使用Python来进行WebDriver的编码和操作。事实上Python+Selenium WebDriver环境的搭建分为两个部分：
安装python
安装Selenium
标准的安装步骤
选择Python的版本。
Python主流的有两个大的版本，2.7和3.5（请注意，从Python的3.5版本开始，不再支持Windows XP操作系统，Windows XP用户请安装3.4版本）。我们的例子将会选用面向未来的3.5版本。
安装Python。
在Python的官网下载最新的安装包，进行界面安装。https://www.python.org/
安装的时候，推荐选择“Add exe to path”，将会自动添加Python的程序到环境变量中。然后可以在命令行输入python -V检测安装的Python版本。
当前的版本安装中将会默认已经安装了setuptools和pip这两个Python的基本工具。如果使用了比较旧的Python版本的话，需要自行安装这两个工具。
setuptools：Python的基础工具包，用来构建、安装卸载Python程序
pip：Python软件包的安装和管理工具。通过pip可以简单的安装Python的任意类库
安装Selenium2.0版本。
在Windows安装Selenium2.0，有两种途径。使用pip命令行或者源码安装。以下两种方法，使用任何一个均可。推荐pip的方式。
方法一：pip命令行安装，运行 | cmd，打开命令行，-U其实就是--upgrade，升级安装。
pip install -U selenium
方法二：源码解压安装，前往https://pypi.python.org/pypi/selenium下载最新版的PyPI版本的Selenium，解压后执行
python setup.py install
Ubuntu下的环境搭建
在Ubuntu下的Python的解释器一般情况下已经存在了。我们需要打开终端，输入python -V命令进行验证。如果没有安装Python，那么需要去Python官网上下载指定版本的源文件，进行源码安装。安装完了以后并进行环境变量的设置。
安装Selenium WebDriver的方法与上述在Windows环境下安装部署的方法一致。依旧推荐使用pip命令行进行安装。
使用IDE编写Python
在上述环境搭建好以后，我们便可使用Python来编写自动化脚本程序，执行Selenium自动化测试。在此之前，我们依旧需要解决一个问题，那就是IDE的选择。
IDE，Integrated Development Environment，集成开发环境。一个好的编辑器或者好的IDE将会极大的提高生产力，帮我们做很多事情，使得编码工作更加简单，编码的体验更加容易。一般情况下，我们有以下几种工具可以选择：
IDLE：Python自带的IDE，功能简单，使用方便
Notepad++：一个强大的开源编辑器
Vim：Linux系统中最好用的编辑器之一
Sublime Text：一个非常轻便好用的现代化的编辑器，推荐。
PyCharm：JetBrains公司提供的现代化的跨平台的Python IDE。
使用Sublime Text 3搭建Python环境
****通过快捷键Ctrl+ 或者View > Show Console打开控制台，输入以下代码并回车
importurllib.request,os;pf='Package Control.sublime-package';ipp=sublime.installed_packages_path();urllib.request.install_opener(urllib.request.build_opener(urllib.request.ProxyHandler()));open(os.path.join(ipp,pf),'wb').write(urllib.request.urlopen('http://sublime.wbond.net/'+pf.replace(' ','%20')).read())
安装完以后，重启Sublime Text 3
如果在Perferences->package settings中看到package control这一项，则安装成功
按下Ctrl+Shift+P调出命令面板
输入install package选项并回车
输入i，匹配到以后，按回车，安装。Anaconda是一个终极的Python插件。安装完了以后便可用Sublime Text 3编写Python代码，并且使用Ctrl+B来编译执行。
一般来说，一个好的IDE提供一下功能，使你的编码开发工作变得更有效率：
一个图形化的智能代码提示和补全功能
可以轻松查看方法和类
语法高亮
提供单元测试和调试的工具
源代码版本管理工具的支持
我们可以尝试用上述的编辑器或者IDE来进行Python代码编写工作。
开始使用WebDriver
接下来我们尝试几个简单的例子来体会一下Selenium WebDriver的使用。
示例1
## 引入WebDriver的包fromseleniumimportwebdriver## 创建浏览器对象browser=webdriver.Firefox()## 打开百度网站browser.get('https://www.baidu.com/')
示例2
## 引入WebDriver包fromseleniumimportwebdriver## 引入WebDriver Keys包fromselenium.webdriver.common.keysimportKeys## 创建浏览器对象browser=webdriver.Firefox()## 导航到百度主页browser.get('https://www.baidu.com')## 检查标题是否为‘百度一下，你就知道’assert'百度一下，你就知道'inbrowser.title## 找到名字为wd的元素，赋值给elemelem=browser.find_element_by_name('wd')# 找到搜索框elem.send_keys('seleniumhq'+Keys.RETURN)# 搜索seleniumhq## 关闭浏览器browser.quit()
Selenium 3.0.1 出现的问题以及解决
3.0.1 更新以后，需要做两个操作：
Geckodriver executable needs to be in PATH。Geckodirver的下载地址：https://github.com/mozilla/geckodriver/releases
报错内容:
WebDriverException:Message:'geckodriver'executable needs to be in Path
geckodriver是一原生态的第三方浏览器，对于selenium3.x版本都会使用geckodriver来驱动firefox，所以需要下载geckodriver.exe。放置在Path 环境变量可以访问到的地方。例如 C:\python34
需要将火狐的安装路径放到path，然后重启（必须重启电脑）
报错内容：
selenium.common.exceptions.WebDriverException: Message: 'geckodriver' executable needs to be in PATH.
参考地址：http://stackoverflow.com/questions/40208051/selenium-using-python-geckodriver-executable-needs-to-be-in-path/40208762
XAMPP的安装部署和环境搭建
XAMPP的安装，在Windows操作系统中比较简单，可以直接运行安装文件，默认全部下一步，即可完成软件的安装。
请注意：Windows XP系统只能可以XAMPP 1.8.2版本；Windows 7以及以上的系统可以安装最新版的XAMPP。XAMPP不分32位和64位操作系统。
XAMPP的部署
XAMPP = OS + Apache + MySQL + PHP + Perl
我们一般部署的网站，符合XAMPP环境的话，只需要启动Apache和MySQL两个应用。
部署步骤
启动Apache
启动MySQL
解压网站源文件，例如解压然之：ranzhi.2.5.zip，请把压缩包里面的ranzhi这个文件夹解压出来；禅道也类似，需要把压缩包中的zentaopms文件夹解压出来
部署源文件，请将解压以后的源文件放到xampp\htdocs文件夹中
通过浏览器访问部署好的网站源文件，进行向导安装。http://localhost/ranzhi/www
PS:这里我们主要支持的是PHP+MySQL开发的网站部署。
XAMPP的问题解决
无法启动Apache：请认真查看日志，判断80和443端口被什么样的程序占用，需要关闭对应程序，或者修改Apache的端口。
IIS：控制面板 | 管理工具 | Internet信息服务 | 默认网站 | 关闭
VisualSVN Server： 控制面板 | 管理工具 | VisualSVN Server | 关闭
VMware Workstation： 开始 | VMware Workstation | 编辑 | 首选项 | 共享虚拟机 | 禁用共享
HP LoadRunner： 右侧任务栏 | 右键 | 关闭
修改XAMPP Apache 端口：Config | httpd.conf修改Linsten 80 | Httpd-ssl.conf修改 Listen 443
无法启动MySQL：请认真查看错误日志，找到已经启动的MySQL的程序进程，杀掉该进程。
使用unittest编写测试脚本
通过上面的例子，我们可以简单的写出Selenium WebDriver的脚本，但是对于测试工作来说，上述的脚本还远远不够。因为上述的脚本没有“检查”。
接下来我们将会使用Python语言的unittest框架展开“检查”。
unittest基础
unittest框架的原本的名字是PyUnit。是从JUnit这样一个被广泛使用的Java应用开发的单元测试框架创造而来。类似的框架还有NUnit（.Net开发的单元测试框架）等。
我们可以使用unittest框架为任意Python项目编写可理解的单元测试集合。现在这个unittest已经作为Python的标准库模块发布。我们安装完Python以后，便可以直接使用unittest。
unittest框架提供了编写test cases，test suites和test fixtures的基本功能。我们首先关注Test cases的编写与执行。
使用unittest需要以下简单的三步：
引入unittest模组
继承unittest.TestCase基类
测试方法以test开头
unittest示例
## 引入unittest模组importunittest## 定义测试类，名字为DemoTests## 该类必须继承unittest.TestCase基类classDemoTests(unittest.TestCase):## 使用'@'修饰符，注明该方法是类的方法## setUpClass方法是在执行测试之前需要先调用的方法## 是开始测试前的初始化工作@classmethoddefsetUpClass(cls):pass## 测试一（务必以test开头）deftest_01(self):pass## 测试三（务必以test开头）deftest_02(self):pass## 测试三（务必以test开头）deftest_03(self):pass## tearDownClass方法是执行完所有测试后调用的方法## 是测试结束后的清除工作@classmethoddeftearDownClass(cls):pass# 执行测试主函数if__name__=='__main__':## 执行main全局方法，将会执行上述所有以test开头的测试方法unittest.main(verbosity=2)
Python知识的补充：
Python文件的后缀名是.py
.py文件可以用来直接执行。也可以被用来作为模块导入。在cmd命令行中执行的命令为python demo.py
在Python中导入模块（模组）一般使用的是import
使用unittest框架编写Selenium WebDriver测试
接下来我们查看一个完整的Selenium WebDriver自动化测试实例
实例
importunittestfromseleniumimportwebdriverfromselenium.webdriver.common.keysimportKeysclassSearchTests(unittest.TestCase):defsetUp(self):# 创建一个新的浏览器对象self.driver=webdriver.Firefox()self.driver.implicitly_wait(30)self.driver.maximize_window()# 导航到京东主页self.driver.get("https://www.jd.com/")deftest_search_by_category(self):# 获取到搜索框self.search_field=self.driver.find_element_by_id("key")self.search_field.clear()# 输入iphone 6s plus并按下回车进行搜索self.search_field.send_keys("iphone 6s plus"+Keys.RETURN)# 获取所有的查询结果products=self.driver.find_elements_by_css_selector("li[class='gl-item']")# 断言：检查查询出来的个数是否为24个self.assertEqual(24,len(products))deftearDown(self):# 关闭浏览器对象self.driver.quit()if__name__=='__main__':unittest.main(verbosity=2)
理解unittest框架提供的各种断言方法
方法 Method检查条件
assertEqual(a, b [, msg])a == b，msg可选，用来解释失败的原因
assertNotEqual(a, b [, msg]a != b，msg可选，用来解释失败的原因
assertTrue(x [, msg])x 是真，msg可选，用来解释失败的原因
assertFalse(x [, msg])x 是假，msg可选，用来解释失败的原因
assertIsNot(a, b [, msg])a 不是 b，msg可选，用来解释失败的原因
WebDriver API 基本操作
这里我们将会开始WebDriver API的基本操作，从元素定位以及浏览器的基本操作开始。
定位符
元素的定位和操作是自动化测试的核心部分，其操作是建立在定位的基础上的。因此我们首选要开始定位元素。
在html里面，元素具有各种各样的属性。我们可以通过这样唯一区别其他元素的属性来定位到这个元素。WebDriver提供了一系列的元素定位方法。常见的有以下几种：
id
name
class name
tag
link text
partial link text
xpath
css selector
查找简单元素
我们从简单的一个元素开始定位。最基本的方法是id和name。大多数元素有这两个属性，在对控件的id和name命名是一般也会使其有意义，而取不同的名字。
例如我们看下面这段html
我们可以使用对应的方法来定位这个input
find_element_by_id('search')find_element_by_name('q')find_element_by_class_name('input-text')
这里我们开始用最简单的方式来尝试定位
查看下面一个例子
self.driver.get('http://pro.demo.zentao.net')# 用name定位用户文本输入框self.account_field=self.driver.find_element_by_name('account')# 用name定位密码文本输入框self.password_field=self.driver.find_element_by_name('password')self.account_field.clear()self.password_field.clear()self.driver.implicitly_wait(30)# 输入用户名demoself.account_field.send_keys('demo')# 输入密码123456self.password_field.send_keys('123456')self.driver.find_element_by_id('submit').click()self.driver.implicitly_wait(30)companyname=self.driver.find_element_by_id('companyname')self.assertEqual('demo项目管理系统',companyname.text)
示例2
self.driver.find_element_by_id('menuproduct').click()self.driver.implicitly_wait(30)self.driver.find_element_by_id('menuproject').click()self.driver.implicitly_wait(30)self.driver.find_element_by_id('menuqa').click()self.driver.implicitly_wait(30)self.driver.find_element_by_id('menudoc').click()self.driver.implicitly_wait(30)self.driver.find_element_by_id('menureport').click()self.driver.implicitly_wait(30)self.driver.find_element_by_id('menucompany').click()self.driver.implicitly_wait(30)self.driver.find_element_by_link_text('退出').click()self.driver.implicitly_wait(30)
此外XPath定位和CSS Selector定位，和定位一组元素这样的内容案例，将在后续的讲义继续探讨和讲解。
控制浏览器
浏览器的控制也是自动化测试的一个基本组成部分，我们可以将浏览器最大化，设置浏览器的高度和宽度以及对浏览器进行导航操作等。
## 浏览器最大化driver.maximize_window()## 设置浏览器的高度为800像素，宽度为480像素driver.set_window_size(480,800)## 浏览器后退driver.back()## 浏览器前进driver.forward()
这里我们做一个综合性的练习实例
# coding=utf-8importunittestfromseleniumimportwebdriverfromselenium.webdriver.common.byimportByfromselenium.webdriver.support.uiimportWebDriverWaitfromselenium.webdriver.supportimportexpected_conditions# import sys# reload(sys)# sys.setdefaultencoding('utf8')classWebDriverTests(unittest.TestCase):@classmethoddefsetUpClass(cls):# create a new Firefox sessioncls.driver=webdriver.Firefox()cls.driver.get('about:blank')cls.driver.implicitly_wait(30)print(" -- set up finished -- ")print()deftest_01_navigate(self):passurl_baidu='https://www.baidu.com/'url_zentao='http://pro.demo.zentao.net/user-login-Lw==.html'# 导航到百度self.driver.get(url_baidu)self.driver.maximize_window()self.driver.implicitly_wait(30)# 导航到禅道self.driver.get(url_zentao)self.driver.maximize_window()self.driver.implicitly_wait(30)# 后退self.driver.back()self.assertEqual(url_baidu,self.driver.current_url)self.driver.implicitly_wait(30)# 前进self.driver.forward()self.assertEqual(url_zentao,self.driver.current_url)self.driver.implicitly_wait(30)print("-- test 01 finished -- ")print()deftest_02_element_interaction(self):self.driver.get('http://pro.demo.zentao.net')## 找到用户名和密码的输入框self.account_field=self.driver.find_element_by_name('account')self.password_field=self.driver.find_element_by_name('password')## 清除当前的输入self.account_field.clear()self.password_field.clear()self.driver.implicitly_wait(30)## 输入用户名和密码，进行登录self.account_field.send_keys('demo')self.password_field.send_keys('123456')self.driver.find_element_by_id('submit').click()self.driver.implicitly_wait(30)companyname=self.driver.find_element_by_id('companyname')self.assertEqual('demo项目管理系统',companyname.text)print(companyname.get_attribute('type'))print()self.driver.implicitly_wait(30)print('-- test 02 finished -- ')print()deftest_03_element_interation2(self):## 这里执行了一段JavaScript代码js='selectTheme("green")'self.driver.execute_script(js)self.driver.implicitly_wait(30)js='selectTheme("red")'self.driver.execute_script(js)self.driver.implicitly_wait(30)js='selectTheme("lightblue")'self.driver.execute_script(js)self.driver.implicitly_wait(30)js='selectTheme("blackberry")'self.driver.execute_script(js)self.driver.implicitly_wait(30)self.driver.find_element_by_id('menuproduct').click()self.driver.implicitly_wait(30)self.driver.find_element_by_id('menuproject').click()self.driver.implicitly_wait(30)self.driver.find_element_by_id('menuqa').click()self.driver.implicitly_wait(30)self.driver.find_element_by_id('menudoc').click()self.driver.implicitly_wait(30)self.driver.find_element_by_id('menureport').click()self.driver.implicitly_wait(30)self.driver.find_element_by_id('menucompany').click()self.driver.implicitly_wait(30)self.driver.find_element_by_link_text('退出').click()self.driver.implicitly_wait(30)WebDriverWait(self.driver,10).until(expected_conditions.element_to_be_clickable((By.ID,"submit")))self.driver.implicitly_wait(30)print('-- test 03 finished -- ')print()deftest_04_cookies(self):self.driver.add_cookie({'name':'key-neeeeew','value':'value-neeeewwwww'})# 遍历cookies 中的name 和value 信息打印，当然还有上面添加的信息forcookieinself.driver.get_cookies():print("%s -> %s"%(cookie['name'],cookie['value']))print()self.driver.delete_all_cookies()cookies=self.driver.get_cookies()print(cookies)print()print('-- test 04 finished -- ')print()@classmethoddeftearDownClass(cls):# close the browser windowcls.driver.quit()passprint('-- tear down finished -- ')print()if__name__=='__main__':unittest.main(verbosity=2)