[译]Selenium Python文档：七、WebDriver API接口

由于API文档格式不太适合cnblog博客，暂且翻译一部分，且暂未校对

注意：这不是官方文档，官方 API文档在这里.

本章包含Selenium WebDriver的所有接口

推荐import风格

本章中的API第一显示的都是类的绝对位置。然而，要推荐的是下面这种import风格：

from selenium import 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

特殊的按键类(Keys)可以像下面这样import:

from selenium.webdriver.common.keys import Keys

异常类可以像下面这样导入（使用真实的类名替换其中的TheNameOfExceptionClass）:

from selenium.common.exceptions import [TheNameOfTheExceptionClass]

API使用约定

有些方法和属性（ attributes）是可调用的，而有些是不可调用的(properties)。所有可调用的attributes都以圆括号结尾。

一个 property示例：

• current_url

当前加载的页面的URL

使用：driver.current_url

一个方法示例：

• close()

关闭当前窗口

使用：driver.close()

7.1.异常

异常可能出现在任意的webdriver代码中。

异常：selenium.common.exceptions.ElementNotSelectableException(msg=None, screen=None, stacktrace=None)

基类：selenium.common.exceptions.InvalidElementStateException

当选择一个不可选择的元素是抛出。比如，选择一个script元素。

异常：selenium.common.exceptions.ElementNotVisibleException(msg=None, screen=None, stacktrace=None)

基类：selenium.common.exceptions.InvalidElementStateException

当一个元素在DOM中，却是不可视的，无法与之交互时抛出。

通常会在尝试点击或者读取视图中一个隐藏元素是遇到这种异常。

异常：selenium.common.exceptions.ErrorInResponseException(response, msg)

基类：selenium.common.exceptions.WebDriverException

当服务端出现错误时抛出。

当可能发生在于火狐扩展或远程驱动器服务器进行通信时出现。

异常：selenium.common.exceptions.ImeActivationFailedException(msg=None, screen=None, stacktrace=None)

基类：selenium.common.exceptions.WebDriverException

当激活一个IME引擎失败时抛出

异常：selenium.common.exceptions.ImeNotAvailableException(msg=None, screen=None, stacktrace=None)

基类：selenium.common.exceptions.WebDriverException