1、概述

Selenium [sə’liniəm]。
Selenium Python bindings 使用非常简洁方便的 API 让你去使用像 Firefox, IE, Chrome, Remote 等等 这样的 Selenium WebDrivers(Selenium web 驱动器)。

Selenium Python bindings 提供了一个简单的 API,让你使用 Selenium WebDriver 来编写功能 / 校验测试。 通过 Selenium PythonAPI,你可以非常直观的使用 Selenium WebDriver 的所有功能。

selenium 中文文档

pip install selenium

如果你想使用一个远程的 WebDriverSelenium 服务是唯一的依赖。
Selenium server 是一个 JAVA 工程,Java Runtime Environment (JRE) 1.6 或者更高的版本是推荐的运行环境。

# 下载页:http://seleniumhq.org/download/
java -jar selenium-server-standalone-2.x.x.jar

2、基本使用

from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.support import expected_conditions as EC
from selenium.webdriver.support.wait import WebDriverWait
browser = webdriver.Chrome()
browser.get('https://www.taobao.com/')
# 显示等待 10s
wait = WebDriverWait(browser, 10)
# 等待直到元素加载出
input = wait.until(EC.presence_of_element_located((By.ID, 'q')))
# 等待直到元素可点击
button = wait.until(EC.element_to_be_clickable((By.CSS_SELECTOR, '.btn-search')))
print(input, button)
# 创建一个浏览器对象
browser = webdriver.Chrome()
try:
    # 开启一个浏览器并访问https://www.baidu.com
    browser.get('https://www.baidu.com')
    # 在打开的网页响应中根据id查找元素   获取到查询框
    input = browser.find_element_by_id('kw')
    # 向查询框中输入Python
    input.send_keys('Python')
    # 模拟回车
    input.send_keys(Keys.ENTER)
    # 显示等待, 等待10秒
    wait = WebDriverWait(browser, 10)
    # 显式等待指定某个条件,然后设置最长等待时间。如果在这个时间还没有找到元素,那么便会抛出异常
    wait.until(EC.presence_of_element_located((By.ID,'content_left')))
    # 输出当前的url
    print(browser.current_url)
    # 输出Cookies
    print(browser.get_cookies())
    # 输出页面响应内容
    print(browser.page_source)
finally:
    pass
    # 关闭浏览器
    browser.close()

Selenium 声明浏览器对象

from selenium import webdriver
browser = webdriver.Chrome()
browser = webdriver.Firefox()
browser = webdriver.Edge()
browser = webdriver.PhantomJS()
browser = webdriver.Safari()

Selenium 查找元素
查找单个元素的方法:

  • find_element_by_name 通过 name 查找
  • find_element_by_xpath 通过 xpath 查找
  • find_element_by_link_text 通过链接查找
  • find_element_by_partial_link_text 通过部分链接查找
  • find_element_by_tag_name 通过标签名称查找
  • find_element_by_class_name 通过类名查找
  • find_element_by_css_selector 通过 css 选择武器查找
from selenium import webdriver
from selenium.webdriver.common.by import By
# 申明一个浏览器对象
browser = webdriver.Chrome()
# 使用浏览器访问淘宝
browser.get('https://www.taobao.com')
# 在响应结果中通过id查找元素
input_first = browser.find_element_by_id('q')
# 在响应结果中通过css选择器查找元素
input_second = browser.find_element_by_css_selector('#q')
# 第二种方式,通过使用 By.xxx 指定查找方式
input = browser.find_element(By.ID,'q')
print(input)
# 在响应结果中通过xpath查找元素
input_third = browser.find_element_by_xpath('//*[@id="q"]')
print(input_first)
print(input_second)
print(input_third)
browser.close()

查多个元素的方法:

  • find_elements_by_name
  • find_elements_by_xpath
  • find_elements_by_link_text
  • find_elements_by_partial_link_text
  • find_elements_by_tag_name
  • find_elements_by_class_name
  • find_elements_by_css_selector
from selenium import webdriver
from selenium.webdriver.common.by import By
# 申明一个浏览器对象
browser = webdriver.Chrome()
# 使用浏览器访问淘宝
browser.get('https://www.taobao.com')
# 根据选择查找多个元素
input_first = browser.find_elements_by_css_selector('.service-bd li')
input_second = browser.find_elements(By.CSS_SELECTOR,'.service-bd li')
print(input_first)
print(input_second)
browser.close()

Selenium 元素交互操作
对获取的元素调用交互方法。

import time
from selenium import webdriver
from selenium.webdriver.common.by import By
# 申明一个浏览器对象
browser = webdriver.Chrome()
# 使用浏览器访问淘宝
browser.get('https://www.taobao.com')
# 根据 ID 查找元素
input_search = browser.find_element(By.ID,'q')
# 模拟输入 PSV 到输入框
input_search.send_keys('PSV')
time.sleep(2)
# 清空输入
input_search.clear()
input_search.send_keys('3DS')
button = browser.find_element(By.CLASS_NAME,'btn-search')
# 模拟点击
button.click()

Selenium 交互动作
更多操作

from selenium import webdriver
from selenium.webdriver import ActionChains
browser = webdriver.Chrome()
url = 'http://www.runoob.com/try/try.php?filename=jqueryui-api-droppable'
browser.get(url)
# 切换id为iframeResult的frame
browser.switch_to.frame('iframeResult')
source = browser.find_element_by_css_selector('#draggable')
target = browser.find_element_by_css_selector('#droppable')
actions = ActionChains(browser)
actions.drag_and_drop(source, target)
actions.perform()

Selenium 执行 JavaScript

from selenium import webdriver
# 申明一个浏览器对象
browser = webdriver.Chrome()
browser.get('https://www.zhihu.com/explore')
# 执行JavaScript脚本
browser.execute_script('window.scrollTo(0, document.body.scrollHeight)')
browser.execute_script('alert("To Bottom")')

Selenium 获取元素信息

from selenium import webdriver
from selenium.webdriver.common.by import By
# 申明一个浏览器对象
browser = webdriver.Chrome()
browser.get('https://www.zhihu.com/explore')
logo = browser.find_element(By.ID,'zh-top-link-logo')
# 获取属性
print(logo.get_attribute('class'))
print(logo)
browser.close()
# 申明一个浏览器对象
browser = webdriver.Chrome()
browser.get('https://www.zhihu.com/explore')
submit = browser.find_element(By.ID,'zu-top-add-question')
# 获取文本值
print(submit.text)
print(submit)
browser.close()
# 申明一个浏览器对象
browser = webdriver.Chrome()
browser.get('https://www.zhihu.com/explore')
submit = browser.find_element(By.ID,'zu-top-add-question')
# 获取 id   0.04584255991652042-1
print(submit.id)
# 获取位置  {'y': 7, 'x': 675}
print(submit.location)
# 获取标签名称    button
print(submit.tag_name)
# 获取大小  {'width': 66, 'height': 32}
print(submit.size)
browser.close()

Selenium Frame

from selenium import webdriver
from selenium.common.exceptions import NoSuchElementException
browser = webdriver.Chrome()
url = 'http://www.runoob.com/try/try.php?filename=jqueryui-api-droppable'
browser.get(url)
# 将操作的响应数据换成 iframeResult
browser.switch_to.frame('iframeResult')
source = browser.find_element_by_css_selector('#draggable')
print(source)
try:
    logo = browser.find_element_by_class_name('logo')
exceptNoSuchElementException:
    print('NO LOGO')
# 切换成父元素
browser.switch_to.parent_frame()
logo = browser.find_element_by_class_name('logo')
print(logo)
print(logo.text)

Selenium 等待
等待分隐式等待和显示等待。

当使用了隐式等待执行测试的时候,如果 WebDriver 没有在 DOM 中找到元素,将继续等待,超出设定时间后则抛出找不到元素的异常,换句话说,当查找元素或元素并没有立即出现的时候,隐式等待将等待一段时间再查找 DOM,默认的时间是 0

显式等待指定某个条件,然后设置最长等待时间。如果在这个时间还没有找到元素,那么便会抛出异常了。

  • title_is 标题是某内容
  • title_contains 标题包含某内容
  • presence_of_element_located 元素加载出,传入定位元组,如 (By.ID, ‘p’)
  • visibility_of_element_located 元素可见,传入定位元组
  • visibility_of 可见,传入元素对象
  • presence_of_all_elements_located 所有元素加载出
  • text_to_be_present_in_element 某个元素文本包含某文字
  • text_to_be_present_in_element_value 某个元素值包含某文字
  • frame_to_be_available_and_switch_to_it frame 加载并切换
  • invisibility_of_element_located 元素不可见
  • element_to_be_clickable 元素可点击
  • staleness_of 判断一个元素是否仍在 DOM,可判断页面是否已经刷新
  • element_to_be_selected 元素可选择,传元素对象
  • element_located_to_be_selected 元素可选择,传入定位元组
  • element_selection_state_to_be 传入元素对象以及状态,相等返回 True,否则返回 False
  • element_located_selection_state_to_be 传入定位元组以及状态,相等返回 True,否则返回 False
  • alert_is_present 是否出现 Alert

更多操作

from selenium import webdriver
# 隐式等待
browser = webdriver.Chrome()
# 等待 10 秒
browser.implicitly_wait(10)
browser.get('https://www.zhihu.com/explore')
input = browser.find_element_by_class_name('zu-top-add-question')
print(input)
# 显示等待
from selenium.webdriver.common.by import By
from selenium.webdriver.support import expected_conditions as EC
from selenium.webdriver.support.wait import WebDriverWait
browser = webdriver.Chrome()
browser.get('https://www.taobao.com/')
# 显示等待 10s
wait = WebDriverWait(browser, 10)
# 等待直到元素加载出
input = wait.until(EC.presence_of_element_located((By.ID, 'q')))
# 等待直到元素可点击
button = wait.until(EC.element_to_be_clickable((By.CSS_SELECTOR, '.btn-search')))
print(input, button)

Selenium 前进后退

import time
from selenium import webdriver
browser = webdriver.Chrome()
browser.get('https://www.baidu.com/')
browser.get('https://www.taobao.com/')
browser.get('https://www.python.org/')
# 后退
browser.back()
time.sleep(1)
# 前进
browser.forward()
browser.close()

Selenium Cookies

from selenium import webdriver
browser = webdriver.Chrome()
browser.get('https://www.zhihu.com/explore')
# 获得 cookies
print(browser.get_cookies())
# 添加 cookie
browser.add_cookie({'name': 'name', 'domain': 'www.zhihu.com', 'value': 'germey'})
print(browser.get_cookies())
# 删除所有 cookies
browser.delete_all_cookies()
print(browser.get_cookies())

Selenium 选项卡管理

import time
from selenium import webdriver
browser = webdriver.Chrome()
browser.get('https://www.baidu.com')
# 打开一个选项卡
browser.execute_script('window.open()')
print(browser.window_handles)
# 选择第二个选项卡
browser.switch_to_window(browser.window_handles[1])
browser.get('https://www.taobao.com')
time.sleep(1)
browser.switch_to_window(browser.window_handles[0])
browser.get('https://python.org')

Selenium 异常处理

from selenium import webdriver
from selenium.common.exceptions import TimeoutException, NoSuchElementException
browser = webdriver.Chrome()
try:
    browser.get('https://www.baidu.com')
exceptTimeoutException:
    print('Time Out')
try:
    browser.find_element_by_id('hello')
exceptNoSuchElementException:
    print('No Element')
finally:
    browser.close()