selenium（Python）总结

Python相关：（Ubuntu下）

参考http://selenium-python.readthedocs.io/api.html#selenium.webdriver.remote.webdriver.WebDriver.quit

1.下载selenium server（该服务需要运行在Java环境下，需要安装jdk）

下载的是一个jar包，放在Java安装路径的lib文件夹下。

2.安装Python相关的依赖 pip install selenium

3.使用Firefox浏览器时，在Ubuntu下需要下载 geckodriverckod https://github.com/mozilla/geckodriver/releases
解压放到/usr/local/bin 目录下。

webdriver支持的浏览器：

webdriver.Firefox
webdriver.FirefoxProfile
webdriver.Chrome
webdriver.ChromeOptions
webdriver.Ie
webdriver.Opera
webdriver.PhantomJS
webdriver.Remote
webdriver.DesiredCapabilities
webdriver.ActionChains
webdriver.TouchActions
webdriver.Proxy

from selenium import webdriver

driver = webdriver.Firefox（）

元素定位：

1.可以通过这几种方法来查找元素 返回单个元素
element = driver.find_element_by_id("passwd-id")
element = driver.find_element_by_name("passwd")
element = driver.find_element_by_xpath("//input[@id='passwd-id']")
element = driver.find_element_by_link_text（“百度链接”）
element = driver.find_element_by_partial_link_text（“百度”）类似模糊查询，输入链接text的一部分
element = driver.find_element_by_tag_name（‘h1’）返回第一个h1标签
element = driver.find_element_by_class_name（‘content’）返回类名为content的标签
element = driver.find_element_by_css_selector（'p.content'）返回如下的第一个p 标签
<p class="content">Site content goes here.</p>
这个类似css的选择器

2.返回元素列表：
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

find_element_by_ 会返回第一个符合条件的元素，当找不到元素时会报NoSuchElementException异常

当没有ID和name属性时，使用xpath
当知道<a>text</a>标签的text时 使用linkText

selenium提供两种方法定位元素：还有如下一种方法 这种方法效率更高，但是第一种更符合使用习惯
from selenium.webdriver.common.by import By

通过By类
driver.find_element(By.XPATH, '//button[text()="Some text"]')
driver.find_elements(By.XPATH, '//button')
driver.find_elements(By.ID，“hshg-id”)
其他属性同第一种方法，都换成大写

Keys包用来模拟键盘操作

from selenium.webdriver.common.keys import Keys

对于Keys 类下有哪些属性，可以在ipython中查看（已安装selenium）

下拉页面(相当于滑动下拉框到底部)
elem.send_keys(Keys.PageDown)

Keys.BACK_SPACE 删除键

Keys.SPACE 空格键

Keys.ENTER 回车键

send_keys(Keys.CONTROL,'a') 全选
send_keys(Keys.CONTROL,'c') 复制
send_keys(Keys.CONTROL,'x') 剪切
send_keys(Keys.CONTROL,'v') 粘贴

elem.send_keys("python")
elem.send_keys(Keys.RETURN) 类似鼠标点击进入
上面两句可以合写一句elem.send_keys（"123",Keys.RETURN）

窗体相关方法：

导航网页 位置：

driver.get("http://www.example.com") 进入某一网页

driver.forward() 前进

driver.back() 后退

execute_script(script, *args)  在当前窗口执行js 代码 （js代码自己写）

driver.execute_script("window.scrollTo(arguments[0], arguments[1]);",50,500) 传参使用内部的arguments列表

driver.create_web_element(element_id)  使用指定的元素id创建一个web元素

driver.fullscreen_window()   调用窗口管理器特定的“全屏”操作

driver.page_source 整个页面的HTML代码 当前打开的页面

driver.title 网页的标题<title>标签中的文字

get_screenshot_as_base64()

获取当前窗口的屏幕截图，作为base64编码的字符串
这对于嵌入在HTML中的嵌入图像很有用

get_screenshot_as_file(filename) save_screenshot(filename) 两方法等同
driver.get_screenshot_as_file(‘/Screenshots/foo.png’)
将当前窗口的屏幕截图保存到PNG图像文件中。返回
如果有任何的IOError，则返回True。在文件名中使用完整路径。

get_screenshot_as_png()
将当前窗口的屏幕截图作为二进制数据。

get_window_position(windowHandle='current')
得到当前窗口x y 的位置

driver.get_window_position() 默认可以不写

get_window_rect()
得到窗口的x，y坐标，以及当前窗口的高度和宽度。

get_window_size(windowHandle='current')
得到当前窗口的高度和宽度

implicitly_wait(time_to_wait)
设置一个隐式的等待超时，当元素找到就往下执行，否则超过时间就报异常

driver.implicitly_wait(30) second

quit()
退出驱动程序并关闭所有相关的窗口

close()
关闭当前窗口

refresh()
刷新当前网页.

minimize_window()
调用窗口管理器特定的“最小化”操作

maximize_window()
最大化当前使用窗口

set_page_load_timeout(time_to_wait)
设置等待页面加载完成所需的时间 超时抛异常

set_script_timeout(time_to_wait)
设置脚本在一个时间内等待的时间，在抛出错误之前执行executeasyncscript调用

driver.current_url 正在加载页面的URL（driver相当于窗口）

current_window_handle
返回当前窗口的句柄

driver.name 返回低层调用浏览器名字

window_handles
在当前会话中返回所有窗口的句柄。

元素相关操作：

elem = driver.find_element_by_id("btn_id")

clear()
elem.clear()
如果是文本输入元素，就清除文本

click()
点击元素

send_keys(*value)
模拟输入元素 使用此方法发送简单的关键事件或填写表单字段

submit()
提交表单

get_attribute(name)
获得元素的属性,不存在时返回None
elem.get_attribute("class")

get_property(name)
获得元素的属性
elem.get_property("text_length")

value_of_css_property(property_name)
获取CSS属性

text
返回元素的文本

is_displayed()
判断该元素是否对用户可见

is_enabled()
判断是否使用了该元素

is_selected()
判断元素是否被选择，用于选框

screenshot(filename)
将当前元素的屏幕截图保存到PNG图像文件中。返回
如果有任何的IOError，则返回True。在文件名中使用完整路径
element.screenshot(‘/Screenshots/foo.png’)

id
elem.id 获取的不是属性ID， 是存储位置

location_once_scrolled_into_view
这种性质可能在没有任何警告的情况下发生变化。使用这个来发现屏幕上的元素是什么，
这样我们就可以点击它了。这个方法应该使元素被滚动到视图中。

rect
返回元素大小和位置的字典

弹出框：

from selenium.webdriver.common.alert import Alert

创建alert对象：alert = Alert(driver)
或者alert = driver.switch_to_alert()   不推荐使用这种方法

Alert(driver).accept() 同意

常用方法：直接用对象调用以下方法
accept() 同意弹出框

authenticate(username, password)
将用户名/密码发送到经过身份验证的对话框(如基本的HTTP身份验证)。隐式地“单击ok”

driver.switch_to.alert.authenticate(‘cheese’, ‘secretGouda’)

dismiss()
不同意

send_keys(keysToSend)
向弹出框发送text

text属性 获取弹出框的文本
alert_text = Alert(driver).text

Cookies：

设置cookie
# Now set the cookie. This one's valid for the entire domain
cookie = {‘name’ : ‘foo’, ‘value’ : ‘bar’}
driver.add_cookie(cookie)
获取cookie
# And now output all the available cookies for the current URL
driver.get_cookies()  获取所有的cookie

get_cookie(name)   根据cookie名获取指定的cookie

delete_all_cookies()     删除所有的cookie

delete_cookie(name)   根据cookie名删除指定的cookie

设置等待页面加载时间：
通过time模板设置sleep时间，不能确定是否加载
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC

try:
element = WebDriverWait(driver, 10).until(
EC.presence_of_element_located((By.ID, "myDynamicElement"))
)
finally:
driver.quit()

在抛出TimeoutException之前，它等待10秒，除非它在10秒内找到返回的元素。

常用的场景：selenium中提供的场景

title_is
title_contains
presence_of_element_located
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
invisibility_of_element_located
element_to_be_clickable
staleness_of
element_to_be_selected
element_located_to_be_selected
element_selection_state_to_be
element_located_selection_state_to_be
alert_is_present

wait = WebDriverWait(driver, 10) 固定等待时间
element = wait.until(EC.element_to_be_clickable((By.ID, 'someid')))

隐式等待告诉WebDriver在尝试查找任何元素(或元素)不立即可用时，在一定的时间内对DOM进行轮询。
默认设置为0。一旦设置好了，就为WebDriver对象的生命设置了隐式等待

driver.implicitly_wait(10) # seconds
当前页面任何元素不可用，都等待。等待时间不确定，并不是等待设置时间，当查询的元素可用，程序既向下走

myDynamicElement = driver.find_element_by_id("myDynamicElement")

动作链相关对鼠标的操作：
from selenium.webdriver.common.action_chains import ActionChains

actions = ActionChains(driver)
actions.move_to_element(menu) 鼠标移动到元素
actions.click(hidden_submenu) 鼠标点击（点击前可以不需要移动到元素）
actions.perform() 执行以上操作  使用动作链操作最后都必须选择执行才生效

ActionChains(driver).move_to_element(elem).click(elem).perform()上面三句可以连着写

常见操作：
click(on_element=None)
如果元素存在，点击元素。如果不存在点击鼠标当前位置

click_and_hold(on_element=None)
在一个元素上按下鼠标左键。素。如果不存在在鼠标当前位置点击鼠标右键

context_click(on_element=None)
在元素上执行上下文单击(右键单击)

double_click(on_element=None)
双击一个元素

drag_and_drop(source, target) 拖拽一个元素到另一个位置
在源元素上保留鼠标左键，
然后移动到目标元素并释放鼠标按钮

drag_and_drop_by_offset(source, xoffset, yoffset)
在源元素上保留鼠标左键，
然后移动到目标偏移量并释放鼠标按钮

key_down(value, element=None)
只发送一个键盘按键，而不释放它。仅被用于修饰符键(Ctrl、Alt和Shift键 enter等)。

value来源于键盘 通过Key类来发送
element存在时，通过元素send keys，不存在发送keys到焦点元素

key_up(value, element=None)
释放一个修饰符的键

这两个一起用如按 ctrl+c
ActionChains(driver).key_down(Keys.CONTROL).send_keys('c').key_up(Keys.CONTROL).perform()

ActionChains(driver).key_down(Keys.ENTER).key_up(Keys.ENTER).perform() 通过鼠标输入enter键

move_by_offset(xoffset, yoffset)
根据当前鼠标位置偏移

move_to_element(to_element)
移动鼠标到元素上

move_to_element_with_offset(to_element, xoffset, yoffset)
将鼠标移动到指定元素的偏移量。
偏移量是相对于元素的左上角的

pause(seconds)
暂停

perform()
执行所有存储操作

release(on_element=None)
在元素上释放一个鼠标按钮

reset_actions()
清除已经存储在远程终端上的操作

send_keys(*keys_to_send)
将键发送到当前焦点元素
参数使用Key类中的属性

send_keys_to_element(element, *keys_to_send)
像元素发送键

UI支持：
from selenium.webdriver.support.select import Select

只作用select标签
select = Select(select_element)

deselect_all()
清除所有选中的条目 取消勾选

deselect_by_index(index)
通过索引清除

deselect_by_value(value)
通过option的value来清除
<option value=”foo”>Bar</option>

deselect_by_visible_text(text)
<option value=”foo”>Bar</option>
通过text来取消勾选

select_by_index(index)
通过索引选择

select_by_value(value)

select_by_visible_text(text)

all_selected_options
返回所有选中的option列表

first_selected_option
返回第一个被选中的option

options
返回select下所有的option标签列表

期待事件 多用在assert中：
import selenium.webdriver.support.expected_conditions

selenium.webdriver.support.expected_conditions.element_to_be_clickable(locator)
判断页面是否有元素可点击
locator is a tuple of (by, path)

selenium.webdriver.support.expected_conditions.element_to_be_selected(element)
判断元素是否被选择

selenium.webdriver.support.expected_conditions.alert_is_present
期待弹出框出现

selenium.webdriver.support.expected_conditions.title_contains(title)
判断标题包括

selenium.webdriver.support.expected_conditions.url_changes(url)
判断URL改变

selenium.webdriver.support.expected_conditions.url_matches(pattern)
判断URL是否匹配 pattern期待的URL 和当前URL对比