1、
通过示例介绍Selenium-WebDriver
一个简单的入门方法就是这个例子，
它在Google上搜索术语“Cheese”，
然后将结果页面的标题输出到控制台。
java csharp python
from selenium import webdriver
from selenium.common.exceptions import TimeoutException
from selenium.webdriver.support.ui import WebDriverWait
# 可自从2.4.0
from selenium.webdriver.support import expected_conditions as EC
# 可自从2.26.0
driver = webdriver.Firefox()
# 创建Firefox的驱动的一个新实例
driver.get("https://www.google.com")
# 去谷歌主页
print driver.title
# 页面Ajaxy所以标题原来是这样：
inputElement = driver.find_element_by_name("q")
# 找到元素的name属性是Q（谷歌搜索框）
inputElement.send_keys("cheese!")
# 键入搜索
inputElement.submit()
# 提交表单（尽管谷歌自动搜索现在没有提交）
try:
WebDriverWait(driver, 10).until(EC.title_contains("cheese!"))
# 我们不得不等待页面刷新，最后一件事，似乎被更新的标题是
print driver.title
# 您应该看到"cheese! - Google Search"
finally:
driver.quit()
2、
抓取页面
您可能想要使用WebDriver做的第一件事是导航到一个页面。
正常的做法是调用“get”：
driver.get("https://www.google.com")
3、
查找UI元素（WebElements）
“Find”方法使用名为“By”的定位器或查询对象。
“By”策略列在下面。
By ID
如何找到如下所示的元素的示例：
<div id="coolestWidgetEvah">...</div>
element = driver.find_element_by_id("coolestWidgetEvah")
or
from selenium.webdriver.common.by import By
element = driver.find_element(by=By.ID, value="coolestWidgetEvah")
By Class Name
如何找到如下所示的元素的示例：
<div class="cheese"><span>Cheddar</span></div><div class="cheese"><span>Gouda</span></div>
cheeses = driver.find_elements_by_class_name("cheese")
or
from selenium.webdriver.common.by import By
cheeses = driver.find_elements(By.CLASS_NAME, "cheese")
By Tag Name
如何找到如下所示的元素的示例：
<iframe src="..."></iframe>
frame = driver.find_element_by_tag_name("iframe")
or
from selenium.webdriver.common.by import By
frame = driver.find_element(By.TAG_NAME, "iframe")
By Name
如何找到如下所示的元素的示例：
<input name="cheese" type="text"/>
cheese = driver.find_element_by_name("cheese")
or
from selenium.webdriver.common.by import By
cheese = driver.find_element(By.NAME, "cheese")
By Link Text
如何找到如下所示的元素的示例：
<a href="http://www.google.com/search?q=cheese">cheese</a>>
cheese = driver.find_element_by_link_text("cheese")
or
from selenium.webdriver.common.by import By
cheese = driver.find_element(By.LINK_TEXT, "cheese")
By Partial Link Text
如何找到如下所示的元素的示例：
<a href="http://www.google.com/search?q=cheese">search for cheese</a>>
cheese = driver.find_element_by_partial_link_text("cheese")
or
from selenium.webdriver.common.by import By
cheese = driver.find_element(By.PARTIAL_LINK_TEXT, "cheese")
By CSS
下面找到奶酪的例子：
<div id="food"><span class="dairy">milk</span><span class="dairy aged">cheese</span></div>
cheese = driver.find_element_by_css_selector("#food span.dairy.aged")
or
from selenium.webdriver.common.by import By
cheese = driver.find_element(By.CSS_SELECTOR, "#food span.dairy.aged")
By XPath
这是一个小抽象，所以对于下面的一段HTML：
<input type="text" name="example" />
<INPUT type="text" name="other" />
inputs = driver.find_elements_by_xpath("//input")
or
from selenium.webdriver.common.by import By
inputs = driver.find_elements(By.XPATH, "//input")
Using JavaScript
jQuery加载的页面上的简单示例：
element = driver.execute_script("return $('.cheese')[0]")
为页面上的每个标签查找所有输入元素：
labels = driver.find_elements_by_tag_name("label")
inputs = driver.execute_script(
"var labels = arguments[0], inputs = []; for (var i=0; i < labels.length; i++){" +
"inputs.push(document.getElementById(labels[i].getAttribute('for'))); } return inputs;", labels)
4、
获取文本值
element = driver.find_element_by_id("element_id")
element.text
5、
用户输入 - 填写表单
复选框：
from selenium.webdriver.support.ui import Select
select = Select(driver.find_element_by_tag_name("select"))
select.deselect_all()
select.select_by_visible_text("Edam")
提交：
driver.find_element_by_id("submit").click()
或者
element.submit()
6、
在Windows和Frames之间移动
一些Web应用程序有许多框架或多个窗口。
WebDriver支持使用“switchTo”方法在命名窗口之间移动：
driver.switch_to.window("windowName")
或者，
您可以将“窗口句柄”传递给“switchTo().window()”方法。
知道这一点，
可以遍历每个打开的窗口，
如下所示：
for handle in driver.window_handles:
driver.switch_to.window(handle)
您也可以在帧之间切换（或者切换到iframe）：
driver.switch_to.frame("frameName")
7、
弹出对话框
alert = driver.switch_to.alert
# 用法: alert.dismiss(), etc等
8、
导航：历史和位置
driver.get("http://www.example.com")
# Python没有driver.navigate
“导航”界面还提供了在浏览器历史记录中前后移动的功能：
driver.forward()
driver.back()
9、
Cookies
driver.get("http://www.example.com")
# 转到正确的域
driver.add_cookie({'name':'key', 'value':'value', 'path':'/'})
# 现在设置cookie。这是整个域的一个
# 这里的cookie名称是“键”，它的值是“值”。
# 可以传入的其他键是：
# 域 -> 字符串，
# 安全 -> 布尔值，
# 到期 -> 毫秒，因为它应该过期。
for cookie in driver.get_cookies():
print "%s -> %s" % (cookie['name'], cookie['value'])
# 现在输出当前URL的所有可用cookie
可以用2种方法删除cookie
driver.delete_cookie("CookieName")
# By name
driver.delete_all_cookies()
# Or all of them
10、
更改用户代理
profile = webdriver.FirefoxProfile()
profile.set_preference("general.useragent.override", "some UA string")
driver = webdriver.Firefox(profile)
11、
拖放
以下是使用Actions类执行拖放操作的示例。
from selenium.webdriver.common.action_chains import ActionChains
element = driver.find_element_by_name("source")
target = driver.find_element_by_name("target")
ActionChains(driver).drag_and_drop(element, target).perform()
12、
显式等待
明确的等待是您定义的代码，
以便在继续执行代码之前等待某种条件发生。
最糟糕的情况是Thread.sleep（），
它将条件设置为等待的确切时间段。
有一些便利的方法可以帮助您编写只会根据需要等待的代码。
WebDriverWait与ExpectedCondition结合是可以实现的一种方式。
from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait # available since 2.4.0
from selenium.webdriver.support import expected_conditions as EC # available since 2.26.0
ff = webdriver.Firefox()
ff.get("http://somedomain/url_that_delays_loading")
try:
element = WebDriverWait(ff, 10).until(EC.presence_of_element_located((By.ID, "myDynamicElement")))
finally:
ff.quit()
这会在抛出TimeoutException之前等待10秒，
或者如果它发现该元素将在0-10秒内返回它。
WebDriverWait默认每500毫秒调用一次ExpectedCondition，
直到它成功返回。
ExpectedCondition函数类型的成功返回值是布尔值true或非空对象。
预期条件
自动化网页浏览器时经常遇到一些常见的情况。
下面列出的是使用这些条件的几个例子。
元素是可点击的 - 显示并启用。
from selenium.webdriver.support import expected_conditions as EC
wait = WebDriverWait(driver, 10)
element = wait.until(EC.element_to_be_clickable((By.ID,'someid')))
ExpectedConditions包含一组预定义的条件以与WebDriverWait一起使用。
13、
隐等待
隐含的等待是告诉WebDriver在尝试查找一个或多个元素（
如果它们不是立即可用的）时轮询DOM一段时间。
默认设置为0.
一旦设置，
就会为WebDriver对象实例的生命周期设置隐式等待。
from selenium import webdriver
ff = webdriver.Firefox()
ff.implicitly_wait(10)
# 秒
ff.get("http://somedomain/url_that_delays_loading")
myDynamicElement = ff.find_element_by_id("myDynamicElement")