JavaSelenium 页面常用基本操作语法

• 元素定位   

             findElement() 方法返回一个元素, 如果没有找到,会抛出一个异常 NoElementFindException()

             findElements()方法返回多个元素, 如果没有找到,会返回空数组, 不会抛出异常。

             语法：WebElement element = driver.findElement(By.XXXX（"XXXX"））； 

以下为定位方式：by.后面的

id，name，className，tagName，linkText("链接的全部文字")，partialLinkText（"链接的部分文字"），cssSelector(“css表达式”)，xpath("//input[@id='XXXX']")

xpath地址常见语法（详细内容见另笔记）：//XXXX[@XX='XXXX']     或    //XXXX[contains,(@XXXX,'XXXX')]        或       //*[@id='list']/li[1]/div[2]/span[1]    

 

• 页面操作

             driver.navigate().back();                 //回到上一页

             driver.navigate().forward();            //跳转下一页          

             driver.getTitle();                            // 获取当前页面的标题

             driver.getCurrentUrl();                   // 获取当前页面的url

 

• 元素常规操作

             WebElement.click();   

             WebElement.clear();                                     //清空     

             WebElement.sendKeys("掘金网");     　　　 //输入文本

             WebElement.sendKeys("c:\shao.png");        

             WebElement.getText();

 

• 判断相关方法

             WebElement.isEnabled()                              //是否可点击

             WebElement.isSelected();                            //是否选中

　　　   WebElement.isDisplayed()　　　　　　　　//是否显示

 

• 鼠标操作 

         需要先实例化一个Actions，且每次点击都必须添加perform（翻译：执行）

            Actions action = new Actions(driver);

            action.click().perform();                                                  //鼠标左击 

            action.contextClick().perform();                                     //鼠标右击

            action.doubleClick().perform();                                      //鼠标双击

            action.moveToElement(WebElement XX).perform();    //鼠标悬停

     // 鼠标拖动实现

            driver.findElement(By.xpath("//*[@id='tbPic']")).click();

            WebElement begin = driver.findElement(By.xpath("//*[@id='list']/li[1]/div[2]/span[1]"));

            WebElement end = driver.findElement(By.xpath("//*[@id='list']/li[2]/div[2]/span[1]"));

            action .dragAndDrop(begin, end).perform();

　　　  action .dragAndDropBy(WebElement element, int x, int y).perform();   //将element元素水平拖动x，垂直拖动y像素

 

• 点选框及下拉列表框操作

     //单选框

             WebElement radio=driver.findElement(By.id("XXXXX"));

             radio.isSelected();                  //判断某个单选项是否被选中            

             radio.click();                            //选择某个选项

             radio.clear();                           //清空选项

     //复选框

             WebElement checkbox = driver.findElement(By.id("XXXXX"));

             checkbox.isSelected();//是否选中

             checkbox.click();

     //下拉框选择

             Select select = new Select(driver.findElement(By.id("frequency")));

             select.selectByValue("1");

             driver.findElement(By.id("validDays")).click();

 

• 弹框警告处理

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

             alert.accept();                                      //确定

             alert.dismiss();                                     //取消

 

• iframe中元素定位方法：先定位iframe,用switchTo().frame(XXXXX)切换再定位其他元素

             WebElement iframeElement = driver.findElement(By.xpath("//iframe[contains(@id,'x-URS-iframe')]"));

             driver.switchTo().frame(iframeElement);

       //要操作原页面元素，需要切回

             driver.switchTo().defaultContent();                     //回到默认的页面

             driver.switchTo().parentFrame();                         //切回父级框             

 

• 弹出页面切换操作（如多个页面间切换）

             getWindowHandle()； 与 getWindowHandles()；

    //举例说明

     public void windowshandle() {

            windowsHandle = driver.getWindowHandle();                             //获取当前页面handle

            Set<String> handles = driver.getWindowHandles();                     //获取浏览器所有页面handle

            for(String s : handles) {                                                                   //JDK1.5 for循环新写法，简洁效率

                    if(s.equals(windowsHandle)) {

                            continue; //遍历，如果handles中的一个handle等于当前页面handle，说明没切换页面，跳出本次循环，继续下次循环

                    }

                    System.out.println(s);

                    driver.switchTo().window(s);

           }

           driver.findElement(By.linkText("案例")).click();

    }

 

• 元素等待

    //分3种等待：

1. 强制等待，休眠线程（死等）：Thread.sleep(2000);   //等待2s
2. 隐式等待： 如果在规定的时间，找到了元素就继续操作，否则就报错（#条件满足，还是会继续等待完时间）
   * 语法： driver.manage().timeouts().implicitlyWait(timeout, TimeUnit.SECONDS);
   * （第一个参数将接受时间作为整数值，例如10（共等待10s），第二个参数将接受时间测量）
   * 应用场景：全局，例如所有元素在10s没出现都抛出异常
3. 显示等待：如果在规定的时间内，满足条件就继续操作，否则就报错(#条件满足就操作，不继续等待)
   * 使用前先实例化: WebDriverWait wait = new WebDriverWait(driver,timeout);
   * （第一个参数为WebDriver对象，第二个参数为整数时间，例如10（共等10s））
   * 语法：（ExpectedConditions类中方法）wait.until(ExpectedConditions.XXXX);

     ExpectedConditions方法：

         .elementSelectionStateToBe（）

                   例如：//判断某个元素的选中状态是否符合预期

                        ExpectedConditions.elementSelectionStateToBe(By.xpath("//*[@id='kw']"), true);

                            //判断某个元素(已定位)的选中状态是否符合预期

                        ExpectedConditions.elementSelectionStateToBe(driver.findElement(By.xpath("//*[@id='kw']")), false);

 

         .elementToBeSelected（）

                   例如：//判断某个元素是否被选中，一般用在下拉列表

                        ExpectedConditions.elementToBeSelected(By.xpath("//*[@id='kw']"));

 

         .frameToBeAvaliableAndSwitchToIt（）

                   例如：//判断该表单是否可以切过去，可以就切过去并返回true，否则放回false

                        ExpectedConditions.frameToBeAvailableAndSwitchToIt(By.id("**"));

 

         .invisibilityOfTheElementLocated（）

                   例如：//判断某个元素是否不存在于DOM或不可见

                        ExpectedConditions.invisibilityOfElementLocated(By.xpath("//*[@id='kw']"));

 

         .invisibilityOfElementWithText（）

 

         .presenceOfAllElementsLocatedBy（）

                   例如：//只要存在一个就是true

                        ExpectedConditions.presenceOfAllElementsLocatedBy(By.xpath("//*[@id='kw']"));

         .textToBePresentInElement（）

 

         .textToBePresentInElementLocated（）

                   例如：//元素中的text是否包含语气的字符串

                        ExpectedConditions.textToBePresentInElementLocated(By.xpath("//*[@id='kw']"), "百度一下");

 

         .visibilityOfAllElements（）//判断所有元素是否可见

 

         .textToBePresentInElementValue（）

                   例如：//元素的value属性中是否包含XXXX的字符串

                        ExpectedConditions.textToBePresentInElementValue(By.xpath("//*[@id='kw']"), "XXXX");

 

         .titleIs（）    //标题是不是XXXX

 

         .titleContains（） //标题是否包含XXXX

 

         .visibilityOf（）

                   例如：//判断元素(定位后)是否可见

                        ExpectedConditions.visibilityOf(driver.findElement(By.xpath("//*[@id='kw']")));

 

         .alertIsPresent（）//判断页面中是否存在alert

 

         .visibilityOfAllElementsLocatedBy（）

 

         .visibilityOfElementLocated（）

                   例如：//判断元素是否可见（非隐藏，并且元素的宽和高都不等以0）

                        ExpectedConditions.visibilityOfElementLocated(By.xpath("//*[@id='kw']"));

 

         .presenceOfElementLocated（By.id（"XXX"））          

                   例如：//判断该元素是否被加载在DOM中，并不代表该元素一定可见

                        ExpectedConditions.presenceOfElementLocated(By.xpath("//*[@id='kw']"));

 

         .elementToBeClickable(By.id("XXX"))                              

                   例如：//判断元素是否可以点击

                        ExpectedConditions.elementToBeClickable(By.xpath("//*[@id='kw']"));