webdriverjs-helper
v3.0.0
Published
JavaScript WebDriver Helper offer friendly APIs while using selenium-webdriver.
Downloads
524
Readme
webdriverjs-helper
This helper library offer lots of friendly api while using JavaScript WebDriver
Getting Started
Install the module with: npm install webdriverjs-helper
to enable the friendly APIs.
Testing
npm test
This starts a selenium server and runs tests in Firefox.
Build status
Documentation
You could setup the selenium webdriver like this. Remember to require 'webdriverjs-helper' to enable friendly apis.
var webdriver = require('selenium-webdriver')
require('chai').should()
// enable the friendly apis by requiring 'webdriverjs-helper'
require('webdriverjs-helper');
var builder = new webdriver.Builder().
usingServer('http://localhost:4444/wd/hub').
withCapabilities({
browserName: 'firefox'
})
var browser = builder.build()
browser.get('http://localhost:9001')
Browser API
browser.navigateTo(path)
Go to the path which is relative to current path.
browser.navigateTo('/demo.html?a=1&b=2#c=1')
browser.currentUrl(function(currUrl, url) {
currUrl.should.equal('http://localhost:9001/demo.html?a=1&b=2#c=1')
});
browser.currentUrl(currHandler)
Get current url.
browser.navigateTo('/demo.html?a=1&b=2#c=1')
browser.currentUrl(function(currUrl, url) {
currUrl.should.equal('http://localhost:9001/demo.html?a=1&b=2#c=1')
url.protocol.should.equal('http:')
url.slashes.should.equal(true)
url.host.should.equal('localhost:9001')
url.port.should.equal('9001')
url.hostname.should.equal('localhost')
url.href.should.equal('http://localhost:9001/demo.html?a=1&b=2#c=1')
url.hash.should.equal('#c=1')
url.search.should.equal('?a=1&b=2')
url.query.should.equal('a=1&b=2')
url.pathname.should.equal('/demo.html')
url.path.should.equal('/demo.html?a=1&b=2')
})
browser.refresh()
Refresh current page.
browser.forward()
Go forward to next page in history.
browser.back()
Go back to privious page in history.
browser.title(titleHandler)
Get title in current page.
browser.title(function (title) {
title.should.equal('your title')
})
Elements API
browser.elements(selector)
Get all matched element by selector. every element could use the friendly api listed below.
browser.elements(selector).count(coundHandler)
Get count of all matched elements.
browser.elements('input').count(function (count) {
count.should.equal(6)
})
browser.elements(selector).get(index, elemHandler)
Get the element in matched elements according to index.
browser.elements('input').get(0, function (elem) {
elem.enter('hello world!')
// elem.click()
})
browser.elements(selector).initialized
Get the status that all elements is initialized or not.
browser.elements(selector).init(initedHandler)
Initialize all elements and save inside. In initedHandler, initialized
property will be updated to true
. And you could change asyn-invoking to sync-invoking. For example,
browser.elements('input').init(function (elems) {
this.initialized.should.be.true
this.count().should.equal(6)
this.get(0).enter('hello world')
this.get(1).attr('name').should.equal('textbox')
/\* ... \*/
})
browser.element(selector)
Get first matched element by selector.
browser.element(selector).click()
Click the element, the click
method is also used for browser.input()
, browser.dropdownlist()
and browser.link()
element.
browser.element(selector).value(valueHandler)
Get value for the the matched element's value attribute. It could used in browser.input(selector).value()
as well.
browser.element('input#name').value(function (val) {
val.should.equal('your name')
})
browser.element(selector).attr(attrName, attrHandler)
Get value of the matched element's attrubute with attribute name attrName
.
browser.element('input[name="textbox"]').attr('name', function (attr) {
attr.should.equal('textbox')
})
browser.element(selector).css(propertyName, valueHandler)
Get css value of the matched element's css property with name propertyName
.
browser.element('input[name="textbox"]').css('font-family', function (property) {
property.should.equal('Georgia')
})
browser.element(selector).text(textHandler)
Get the innerText of the matched element.
browser.element('body').text(function (text) {
text.should.contain('hello world!')
})
browser.element(selector).html(htmlHandler)
Get the innerHTML of the matched element.
browser.element('body').html(function (html) {
html.should.contain('<p>hello world!</p>')
})
browser.element(selector).isEnabled(enabledHandler)
Get value for the matched element's status.
browser.element('input#btn').isEnabled(function (enabledStatus) {
enabledStatus.should.be.false
})
browser.element(selector).isVisible(displayedHandler)
Get value for visibility of element.
browser.element('#displayed').isVisible(function (displayed) {
displayed.should.be.false
})
browser.input(selector)
Get first matched input
element by selector, it includes textbox, checkbox, radio etc...
browser.input(selector).enter(text)
Enter text into matched textbox.
browser.input(selector).value(valueHandler)
Get value of matched textbox
browser.input(selector).check()
Check matched checkbox.
browser.input(selector).uncheck()
Uncheck matched checkbox.
browser.input(selector).isChecked(checkedHandler)
Get the checked status.
browser.input('input#checkbox').isChecked(function (checked) {
checked.should.be.true
})
browser.input(selector).select()
Select matched radio button.
browser.input(selector).isSeleced(selectedHandler)
Get the selected status. Same as isChecked
.
browser.dropdownlist(selector)
Get first matched select
element by selector.
browser.dropdownlist(selector).option(val1/*, val2 ... */)
Select these options with the valus in arguments. If the dropdownlist couldn't be multi-selected, the option with the last value would be selected.
browser.dropdownlist(selector).value(valueHandler)
Get the value for matched dropdownlist.
browser.dropdownlist(selector).values(valuesHandler)
For the multi-selected dropdownlist, it will return array of values.
browser.dropdownlist(selector).values(function (values) {
values.should.eql([2, 3])
})
browser.button(label [, partial])
Get first matched button by label, other methods are then available. Set partial to true for partial button label match.
browser.content('Some tag content' [, 'elementTag', partialMatch ])
Find an element by content and tag (optional). Performs a full text match and uses xpath under the hood. Argument 3 allows for a partial match and defaults to false.
browser.link(selector)
Use css selector to find the matched link
browser.link(partialLinkText)
ONLY FOR LINK
browser.link(':contains("Partial Link Text")').click()
browser.exec(script, args, callback)
browser.exec('alert("hello world!");', function() {
browser.dialog().text(function (text) {
text.should.equal('hello world!')
})
})
Use args
browser.exec('alert(arguments[0][0]);', ['hello!'], function() {
browser.dialog().text(function (text) {
text.should.equal('hello!')
})
})
Use elements
browser.exec('alert(arguments[0][0].name);', browser.elements('input[type="checkbox"]')
browser.dialog().text(function (text) {
text.should.equal('checkbox')
})
browser.execAsync(script, args, callback)
browser.manage().timeouts().setScriptTimeout(5000)
browser.execAsync('var callback = arguments[arguments.length - 1];setTimeout(function(){ callback(10); }, 500);', function(num) {
num.should.equal(10)
})
Use args
browser.manage().timeouts().setScriptTimeout(5000)
browser.execAsync('var callback = arguments[arguments.length - 1];var str = arguments[0][0]; setTimeout(function(){ callback(str); }, 500);', ['hello world'], function(str) {
str.should.equal('hello world')
});
Use elements
browser.manage().timeouts().setScriptTimeout(5000)
browser.execAsync('var callback = arguments[arguments.length - 1];var elem = arguments[0][0]; setTimeout(function(){ callback(elem); }, 500);', browser.elements('input[type="checkbox"]'), function(element) {
element.attr('name', function(name) {
name.should.equal('checkbox')
})
})
Alert API
browser.dialog()
Get the dialog which could be alert, confirm, prompt dialog.
browser.dialog().text(textHandler)
Get the text on the dialog.
browser.dialog().accept(thenHandler)
Accept(Ok) the confirm and prompt dialog.
browser.dialog().dismiss(thenHandler)
Dismiss(Cancel) the alert, confirm and prompt dialog.
browser.dialog().enter(text, thenHandler)
Enter text in prompt dialog.
Contributing
In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using Grunt.
Release History
3.0.0 2016-04-05
- Release of 3.0.0
- Breaking change, remove window API extensions due to change in webdriver API 2.0.0 2014-11-08
- Release of 2.0.0
- Breaking change
isDisplayed
is nowisVisible
due to #4 1.8.1 2014-11-08 - Fix issue #3 1.8.0 2014-09-25
- Update selenium standalone server to 2.43.1
1.6.0 2014-05-28
- Support partial button label matching
1.5.1 2014-05-15
- Support more complex partial matches with child nodes in
browser.content
1.5.0 2014-05-15
- Add support for partial match in
browser.content
1.4.0 2014-05-15
- Add method
browser.content('content', [, 'elementTag' ])
1.3.0 2014-05-14
- Add support for
browser.button(label)
selector
1.2.0 2014-05-12
1.0.0 2014-04-28
- Forked from original repository
- Added
coffee-script
as a dependency - Updated tests to kick off a selenium server
0.2.1 2013-10-20 Add exec
and execAsync
JavaScript support
0.2.0 2013-10-20 Add dialog behaviors
0.1.0 2013-10-17 MVP
Original Project
Originally forked from https://github.com/winsonwq/webrdirver-helper.git
Forked as there was a lack of communication from the original developer and we required patches to be added.
Thanks to Wang Qiu for creating a great library upon which we could build.
License
MIT
Original license
Copyright (c) 2013 Wang Qiu Licensed under the MIT license.