Selenium-webdriver 常用总结

基本使用

const {Builder, By, Key, until， Button} = require("selenium-webdriver");
let broswer = new Builder().forBrowser('ie').build()  #这里使用了ie引擎
broswer.get('http://www.baidu.com')
broswer.quit()  // 表示关闭浏览器   
//drive.close()表示关闭当前窗口
​

选择器

broswer.findElement(By.name('btnG'))；
broswer.findElement({id:"btnG"})；
element.findElement()； //同样可以对元素使用findElement方法
findElements //查找多个元素

By.className(classname)
By.css(selector)   #css-selector
By.id(id)
By.name(name)
By.linkText(text)
By.partialLink(text)  
By.xpath()   
By.js()  //Locates an elements by evaluating a JavaScript expression. The result of this expression must be an element or list of elements.
​

属性获取

//获取代码：
browser.getPageSource().then(function(souce) {console.log(souce);
//获取网页标题:
browser.getTitle().then(b=>{console.log(b)});
//获取当前url：
browser.getCurrentUrl().then(b=>{console.log(b)});


//element为web元素对象，为findelement()的返回对象

element.getText().then(b=>{console.log("text",b)}) //返回里面没有被隐藏的文字（不带标签）

element.getTagName().then(b=>{console.log("Tagname",b)})
//返回标签名

element.getId().then(b=>{console.log("ID",b)})
//返回这个element服务器分配的不透明id


elements.getCssValue().then(=>{console.log("CSSvalue",b)})
//返回该element的CSS属性

//其他属性:
element.getAttribute("class").then(b=>{console.log(b)})
​

等待

//等待元素：
browser.wait(until.elementLocated(By.id('foo')), 10000);

browser.wait(function() {
    return driver.getTitle().then(function(title) { console.log(11111111);
        return title === 'webdriver - Google Search';
    });
}, 1000);

browser.wait(until.titleIs('webdriver - Google Search'), 1000)


//settimeouts
browser.manage().setTimeouts(args)
// args参数
{implicit: (number|null|undefined), pageLoad: (number|null|undefined), script: (number|null|undefined)}
implicit：等待元素加载的最大时间；pageLoad等待页面加载完成的最大时间
​

操作

• input 操作

//清空
element.clear();
//输入 
element.sendKeys("webdriver");
element.sendKeys(Key.ENTER);
element.submit();  //以submit命令提交执行
​

• 截图

broswer.takeScreenshot().then()  //返回页面png截图
element.takeScreenshoot().then() //返回元素png截图
​

• 鼠标操作

//单击鼠标
element.click() 
//连锁动作(action对象)
const actions = driver.actions();
actions
     .keyDown(SHIFT)
     .move({origin: el})
     .press()
     .release()
     .keyUp(SHIFT)
     .perform();
//actions对象以perform()作为动作链结尾，表示命令执行


//具体方法如下：
actions.clear() //清空所有动作，按键和状态
actions.click(element) //对element左键单击一次
actions.contextClick(element) //对element右键单击一次
actions.doubleClick(element)  //对element双击一次
actions.dragAndDrop(ele_from,to) //单击鼠标拖动ele_from元素，如果to是坐标{x:number,y:number}移动距离;如果to是元素移动到to元素中心，并释放鼠标。


actions.keyDown(key) //按下键盘的key键
actions.keyUp(key)  //释放key键

actions.move(options) //移动参数如下：  
//options ({duration: (number|undefined), origin: (Origin|WebElement|undefined), x: (number|undefined), y: (number|undefined)}|undefined) 
　　//origin是起始位置，默认为鼠标当前位置，可以设置元素为起始位置。x,y为偏移量。duration为持续时间默认（100ms）

actions.press(button) //按下鼠标 button默认是鼠标左键，有LEFT,RIGHT,MIDDLE三个值，通过Button.LEFT....获得
actions.release(button) //释放鼠标，默认左键
actions.sendKeys()  //同sendkeys
actions.pause(ms,devices) //暂停ms时间，如果devices没有指定，会创建一个针对所有的事件


更多细节参考：http://seleniumhq.github.io/selenium/docs/api/javascript/module/selenium-webdriver/lib/input_exports_Actions.html
​

options 对象

通过let options = broswer.manage() 获得

options.addCookie({name: 'foo', value: 'bar'})
options.deleteAllCookies() //删除所有cookies
options.deleteCookie(name) //按照name删除
options.getCookie(name) //拿到name字段的cookie值，为promise对象
options.getCookies() //返回所有cookies，为promise对象
​

nav 对象

通过let nav = broswer.navigate()获得

nav有四个方法分别为：

　　nav.back();

　　nav.forward();

　　nav.refresh();

　　nav.to(url);

分别为后退，前进，刷新，跳转到url

​

其他

rowser.excuteScript(script) //在当前frame中执行js代码
brower.switchTo() //targetlocator

Windows 或 Frames之间的切换

首先切换到默认的frame
driver.switchTo().defaultContent();
切换到某个frame：
driver.switchTo().frame(“leftFrame”);
从一个frame切换到另一个frame：
driver.switchTo().frame(“mainFrame”);
切换到某个window：
driver.switchTo().window(“windowName”);
​

targetlocator 对象参见：http://seleniumhq.github.io/selenium/docs/api/javascript/module/selenium-webdriver/lib/webdriver_exports_TargetLocator.html

其中 targetlocator.frame(id)可以用来切换 frame。通过 parentFrame()切回
 
更多 API 详见：http://seleniumhq.github.io/selenium/docs/api/javascript/index.html