Selenium WebDriver API常用方法

通过实施例引入selenium的webdriver API
一个简单的入门方法就是这个例子，它在Google上搜索“Cheese”一词，然后将结果页面的标题输出到控制台。

public class Selenium2Example  {
    public static void main(String[] args) {

        WebDriver driver = new FirefoxDriver();
        //创建Firefox驱动程序的新实例
        //请注意，其余的代码依赖于接口，而不是实现。

        driver.get("http://www.google.com");
        //现在使用它来访问Google
        //或者，同样的事情可以像这样
        // driver.navigate().to("http://www.google.com");

        WebElement element = driver.findElement(By.name("q"));
        //通过名称

        element.sendKeys("Cheese!");
        //输入要搜索的

        element.submit();
        //现在提交表单，webdriver的将找到的元素为我们的表单

        System.out.println("Page title is: " + driver.getTitle());
        //检查页面

        (new WebDriverWait(driver, 10)).until(new ExpectedCondition() {
            public Boolean apply(WebDriver d) {
                return d.getTitle().toLowerCase().startsWith("cheese!");
            }
        });
        // Google的搜索使用JavaScript动态呈现。
        //等待页面加载，10秒后超时

        System.out.println("Page title is: " + driver.getTitle());
        //应该看到：“Cheese！ -  Google搜索”

        driver.quit();
        //关闭浏览器
    }
}

获取页面
您可能想要使用WebDriver的第一件事是浏览到一个页面。正常的做法是通过调用“get”：
 
 driver.get("http://www.google.com");

定位UI元素（WebElements）
在WebDriver中定位元素可以在WebDriver实例本身或WebElement上完成。每个语言绑定都会显示“查找元素”和“查找元素”方法。
前者返回与查询匹配的WebElement对象，如果找不到这样的元素，则会抛出异常。后者返回WebElements的列表，如果没有DOM元素
与查询匹配，则可能为空。
“查找”方法采用名为“By”的定位器或查询对象。“通过”策略如下。
按ID
这是定位元素最有效和最优选的方法。UI开发人员常见的陷阱是在页面上具有非唯一ID或自动生成id，都应该避免。html元素上的类
比自动生成的id更合适。

< div  id = “coolestWidgetEvah” > ...
        WebElement element = driver.findElement(By.id("coolestWidgetEvah"));

按类名
在这种情况下，“类”是指DOM元素上的属性。通常在实际使用中有许多具有相同类名称的DOM元素，因此找到多个元素成为找到第一个
元素的更实际的选择。

Cheddar

Gouda

        List cheeses = driver.findElements(By.className("cheese"));

按标签名称
DOM标签元素的名称。

        WebElement frame = driver.findElement(By.tagName("iframe"));

按名称
找到具有匹配name属性的input元素。

        WebElement cheese = driver.findElement(By.name("cheese"));

通过链接文本
找到具有匹配的可见文本的链接元素。

cheese>
        WebElement cheese = driver.findElement(By.linkText("cheese"));

通过部分链接文本
找到具有部分匹配的可见文本的链接元素

search for cheese>
        WebElement cheese = driver.findElement(By.partialLinkText("cheese"));

通过CSS
像名字一样，它是由css定位策略。默认情况下使用本地浏览器支持，因此请参考w3c css选择器以获取一般可用的css选择器列表。
如果浏览器没有对css查询的本机支持，则使用Sizzle。IE 6,7和FF3.0目前使用Sizzle作为css查询引擎。
请注意，并不是所有浏览器都是平等的，某些可能在一个版本中运行的css可能无法在另一个版本中运行

milkcheese

        WebElement cheese = driver.findElement(By.cssSelector("#food span.dairy.aged"));

通过XPath
在很高的级别，WebDriver尽可能使用浏览器的本机XPath功能。在那些没有本机XPath支持的浏览器上，我们提供了我们自己的实现。
这可能会导致一些意外的行为，除非您知道各种XPath引擎的差异。

        List inputs = driver.findElements(By.xpath("//input"));

使用JavaScript
您可以执行任意JavaScript来查找元素，只要返回一个DOM元素，它将被自动转换为一个WebElement对象。
jQuery已加载的页面上的简单示例：
WebElement element = (WebElement) ((JavascriptExecutor)driver).executeScript("return $('.cheese')[0]");
查找页面上每个标签的所有输入元素：

        List labels = driver.findElements(By.tagName("label"));
        List inputs = (List) ((JavascriptExecutor)driver).executeScript(
        "var labels = arguments[0], inputs = []; for (var i=0; i < labels.length; i++){" +
        "inputs.push(document.getElementById(labels[i].getAttribute('for'))); } return inputs;", labels);

获取文本值
人们通常希望检索元素中包含的innerText值。这将返回单个字符串值。请注意，这只会返回页面上显示的可见文本。

        WebElement element = driver.findElement(By.id("elementID"));
        element.getText();

用户输入 - 填写表单
我们已经看到了如何在textarea或文本字段中输入文本，但是其他元素呢？您可以“切换”复选框的状态，您可以使用“点击”来
设置选择的OPTION标签。处理SELECT标签并不太糟糕：

        WebElement select = driver.findElement(By.tagName("select"));
        List allOptions = select.findElements(By.tagName("option"));
        for (WebElement option : allOptions) {
        System.out.println(String.format("Value is: %s", option.getAttribute("value")));
        option.click();
        }

这将在页面上找到第一个“SELECT”元素，依次循环遍历每个OPTION，打印出它们的值，然后依次选择它们。您将注意到，这不是
处理SELECT元素最有效的方法。WebDriver的支持类包括一个名为“Select”，它提供了与这些交互的有用方法。

        Select select = new Select(driver.findElement(By.tagName("select")));
        select.deselectAll();
        select.selectByVisibleText("Edam");

这将从页面上的第一个SELECT中取消选择所有选项，然后选择带有显示文本“Edam”的OPTION。
填写表单后，您可能需要提交。一种方法是找到“提交”按钮并点击它：

        driver.findElement(By.id("submit")).click();
或者，WebDriver在每个元素上都有“提交”的方便方法。如果您在表单中的元素上调用此方法，则WebDriver会向上移动DOM，
直到找到封闭表单，然后调用submit。如果元素不是一个表单，那么NoSuchElementException将抛出：

        element.submit();

在Windows和帧之间移动
某些Web应用程序有许多框架或多个窗口。WebDriver支持使用“switchTo”方法在命名窗口之间移动：

        driver.switchTo().window("windowName");

所有调用driver现在将被解释为指向特定窗口。但是你怎么知道这个窗口的名字？看看打开它的javascript或链接：

Click here to open a new window

或者，您可以将“窗口句柄”传递给“switchTo（）。window（）”方法。知道这一点，可以遍历每个打开的窗口，如下所示：

        for (String handle : driver.getWindowHandles()) {
        driver.switchTo().window(handle);
        }

您也可以从帧到帧（或到iframe）进行切换：

        driver.switchTo().frame("frameName");

弹出对话框
从Selenium 2.0 beta 1开始，内置支持处理弹出对话框。触发一个打开弹出窗口的操作后，您可以使用以下命令访问警报：
这将返回当前打开的警报对象。使用此对象，您现在可以接受，关闭，读取其内容，甚至键入到提示。该界面在警报，确认和提示
方面同样出色

        Alert alert = driver.switchTo().alert();

导航：历史和位置
早些时候，我们使用“get”命令（driver.get("http://www.example.com")或driver.Url="http://www.example.com"C＃）覆盖了
导航到一个页面 。如您所见，WebDriver有许多较小的，以任务为中心的接口，导航是一项有用的任务。因为加载一个页面是一个
基本的要求，所以这样做的方法存在于主WebDriver界面上，但它只是一个同义词：

        driver.navigate().to("http://www.example.com");

重申：“ navigate().to()和” get()“做的完全一样。一个人比其他人更容易输入！
“浏览”界面还显示了浏览器历史记录中向前和向后移动的功能：
请注意，此功能完全取决于底层浏览器。如果您习惯了一个浏览器的另一个浏览器的行为，那么当您调用这些方法时，
可能会发生意外事件。

        driver.navigate().forward();
        driver.navigate().back();

Cookies
在我们离开这些下一步之前，您可能有兴趣了解如何使用Cookie。首先，您需要位于该cookie有效的域上。如果您在开始与网站
交互之前尝试预设Cookie，并且您的主页很大/需要一段时间来加载替代方法是在网站上找到较小的页面
（通常404页面很小，例如http://example.com/some404page）。

        driver.get("http://www.example.com");
        //转到正确的域

        Cookie cookie = new Cookie("key", "value");
        driver.manage().addCookie(cookie);
        //现在设置cookie

        Set allCookies = driver.manage().getCookies();
        for (Cookie loadedCookie : allCookies) {
        System.out.println(String.format("%s -> %s", loadedCookie.getName(), loadedCookie.getValue()));
        }
        //现在输出当前URL

        driver.manage().deleteCookieNamed("CookieName");
        driver.manage().deleteCookie(loadedCookie);
        driver.manage().deleteAllCookies();
        //您可以通过3种方式删除Cookie

更改用户代理
Firefox驱动程序很简单：

        FirefoxProfile profile = new FirefoxProfile();
        profile.addAdditionalPreference("general.useragent.override", "some UA string");
        WebDriver driver = new FirefoxDriver(profile);

拖放
以下是使用Actions类执行拖放的示例。本地事件需要启用

        WebElement element = driver.findElement(By.name("source"));
        WebElement target = driver.findElement(By.name("target"));

        (new Actions(driver)).dragAndDrop(element, target).perform();

WebDriver：高级用法
显性和隐性等待
等待自动化任务执行经过一定的时间，然后继续下一步。您应该选择使用显性等待或隐性等待。
警告：不要混合隐式和显式等待。这样做可能会导致不可预测的等待时间。例如，设置10秒的隐式等待和15秒的显式等待，
可能会在20秒后引起超时。
显式等待
显式等待是您定义的代码，以等待某个条件发生，然后再继续执行代码。最糟糕的情况是Thread.sleep（），它将条件设置
为等待的确切时间段。
有一些方便的方法可以帮助您编写只需要等待的代码。
WebDriverWait与ExpectedCondition组合是一种可以实现的方式。

        WebDriver driver = new FirefoxDriver();
        driver.get("http://somedomain/url_that_delays_loading");
        WebElement myDynamicElement = (new WebDriverWait(driver, 10))
        .until(ExpectedConditions.presenceOfElementLocated(By.id("myDynamicElement")));

在等待10秒钟之前抛出一个TimeoutException或者如果它发现该元素将返回0 -10秒。默认情况下，WebDriverWait将每500毫秒调用
ExpectedCondition直到成功返回。ExpectedCondition函数类型的成功返回值是布尔值true或非空对象。
预期条件
自动化Web浏览器时会遇到一些常见的情况。以下列出了使用这些条件的几个例子。Java，C＃和Python绑定包括convienence方法，
所以你不必自己编写一个ExpectedCondition类，或为它们创建自己的实用程序包。
元素可点击 - 显示和启用。
该示例在功能上等同于第一个隐式等待示例。
ExpectedConditions包（Java）（Python）（. NET）包含一组用于WebDriverWait的预定义条件。

        WebDriverWait wait = new WebDriverWait(driver, 10);
        WebElement element = wait.until(ExpectedConditions.elementToBeClickable(By.id("someid")));

隐性等待
一个隐含的等待是告诉WebDriver在一段时间内轮询DOM，试图找到一个元素（如果它们不能立即可用）。默认设置为0.一旦设置，
隐式等待设置为WebDriver对象实例的使用寿命。

        WebDriver driver = new FirefoxDriver();
        driver.manage().timeouts().implicitlyWait(10, TimeUnit.SECONDS);
        driver.get("http://somedomain/url_that_delays_loading");
        WebElement myDynamicElement = driver.findElement(By.id("myDynamicElement"));