This library is a webdriver module for nodejs. It makes it possible to write super easy selenium tests in your favorite BDD or TDD test framework. Even Cucumber tests are supported. Take a look into the example directory for test samples.
Either download it from github or use npm:
npm install webdriverjs
To run tests on your local machine, you have to download a selenium standalone server which executes the selenium commands. You find the latest version here. It is also possible to run the tests in the cloud (e.g. on BrowserStack, Sauce Labs or TestingBot). For more informations, see below.
Run selenium server first:
java -jar path/to/your/selenium-server-standalone-2.35.0.jar
Webdriverjs has just a few methods. Most of the methods you will use regurarly are the methods available from the client. To begin using Webdriverjs you just need to create a client.
var webdriverjs = require('webdriverjs'),
client = {};
describe('my webdriverjs tests', function(){
this.timeout(99999999);
before(function(){
client = webdriverjs.remote(options);
client.init();
});
it('Github test',function(done) {
client
.url('https://github.com/')
.getElementSize('.header-logo-wordmark', function(err, result) {
expect(err).to.be.null;
assert.strictEqual(result.height , 30);
assert.strictEqual(result.width, 94);
})
.getTitle(function(err, title) {
expect(err).to.be.null;
assert.strictEqual(title,'GitHub · Build software better, together.');
})
.getElementCssProperty('class name','subheading', 'color', function(err, result){
expect(err).to.be.null;
assert.strictEqual(result, 'rgba(136, 136, 136, 1)');
})
.call(done);
});
after(function(done) {
client.end(done);
});
});
See more examples with other libraries in the example directory.
Type: Object
Example:
browserName: 'chrome', // options: firefox, chrome, opera, safari
version: '27.0', // browser version
platform: 'XP', // OS platform
tags: ['tag1','tag2'], // specify some tags (e.g. if you use Sauce Labs)
name: 'my test' // set name for test (e.g. if you use Sauce Labs)
Type: String
Default: verbose
Options: verbose | silent | command | data | result
Create client as singleton instance for use in different files
Type: Boolean
Default: true
Sauce Labs support
To run your tests via Sauce Labs, add the following attributes to your option object. If you are using Webdriverjs in a public repository, never publish your Sauce Labs key! Export these informations as enviroment variables.
host: 'ondemand.saucelabs.com', // Sauce Labs remote host
user: '<username>', // your username
key: '<access-key>', // your access key
port: 80
Find a test example here!
BrowserStack support
You can also run your tests with BrowserStack on a remote machine.
host: 'hub.browserstack.com', // Browserstack remote host
user: '<username>', // your username
key: '<access-key>', // your access key
port: 80
Find a test example here!
TestingBot support
You can also run your tests with TestingBot on a remote machine.
host: 'hub.testingbot.com', // TestingBot remote host
user: '<client_key>', // your client key
key: '<client_secret>', // your client secret
port: 80
Find a test example here!
If you wish to end all sessions, you can call the endAll method:
require("webdriverjs").endAll(callback);
Where callback is an optional parameter. This method can be used if you run lots of tests, and you want to make sure that all sessions on your selenium server are closed when you are done. Usually its enough to close each client with its end() method, but if you, for some reason, want to make sure that no sessions are open, use endAll(). (note: this method is also available from the client returned from .remote() as well, but its the same as webdriverjs.endAll())
To get a list of all open sessions, you can call:
require("webdriverjs").sessions(callback);
which wil return an array with all sessions from selenium (note: this method is also available from the client returned from .remote() as well, but its the same as webdriverjs.sessions()).
If you which to extend with your own set of commands there is a method called addCommand available from the client object:
var client = require("webdriverjs").remote();
// create a command the returns the current url and title as one result
// just to show an example
client.addCommand("getUrlAndTitle", function(callback) {
this.url(function(err,urlResult) {
this.getTitle(function(err,titleResult) {
var specialResult = {url: urlResult.value, title: titleResult};
if (typeof callback == "function") {
callback(err,specialResult);
}
})
});
});
client
.init()
.url('https://www.github.com')
.getUrlAndTitle(function(err,result){
expect(err).to.be.null;
assert.strictEqual(result.url,'https://github.com/');
assert.strictEqual(result.title,'GitHub · Build software better, together.');
})
.end();
These are the current implemented helper methods. All methods take from 0 to a couple of parameters. Also all methods accept a callback so that we can assert values or have more logic when the callback is called.
- addValue(
String
css selector,String|String[]
value,Function
callback)
adds a value to an object found by a css selector. You can also use unicode characters likeLeft arrow
orBack space
. You'll find all supported characters here. To do that, the value has to correspond to a key from the table. - buttonClick(
String
css selector,Function
callback)
click on a button using a css selector - call(callback)
call given function in async order of current command queue - clearElement(
String
css selector,Function
callback)
clear an element of text - click(
String
css selector,Function
callback)
Clicks on an element based on a css selector - deleteCookie(
String
name,Function
callback)
Delete a cookie for current page. - doubleClick(
String
css selector,Function
callback)
Clicks on an element based on a css selector - dragAndDrop(
String
sourceCssSelector,String
destinationCssSelector,Function
callback)
Drags an item to a destination - end(
Function
callback)
Ends a sessions (closes the browser) - endAll(
Function
callback)
Ends all sessions (closes the browser) - execute(
String
script,Array
arguments,Function
callback)
Inject a snippet of JavaScript into the page for execution in the context of the currently selected frame. - getAttribute(
String
css selector,String
attribute name,Function
callback)
Get an attribute from an dom obj based on the css selector and attribute name - getCookie(name,
Function
callback)
Gets the cookie for current page. - getCssProperty(
String
css selector,String
css property name,Function
callback)
Gets a css property from a dom object selected with a css selector - getElementCssProperty(
String
find by,String
finder,String
css property name,Function
callback)
Gets a css property from a dom object selected with one of the base selecting mechanisms in the webdriver protocol (class name, css selector, id, name, link text, partial link text, tag name, xpath) - getElementSize(
String
css selector,Function
callback)
Gets the width and height for an object based on the css selector - getLocation(
String
css selector,Function
callback)
Gets the x and y coordinate for an object based on the css selector - getLocationInView(
String
css selector,Function
callback)
Gets the x and y coordinate for an object based on the css selector in the view - getSource(
Function
callback)
Gets source code of the page - getTagName(
String
css selector,Function
callback)
Gets the tag name of a dom obj found by the css selector - getText(
String
css selector,Function
callback)
Gets the text content from a dom obj found by the css selector - getTitle(
Function
callback)
Gets the title of the page - getValue(
String
css selector,Function
callback)
Gets the value of a dom obj found by css selector - isSelected(
String
css selector,Function
callback)
Return true or false if an OPTION element, or an INPUT element of type checkbox or radiobutton is currently selected (found by css selector). - isVisible(
String
css selector,Function
callback)
Return true or false if the selected dom obj is visible (found by css selector) - moveToObject(
String
css selector,Function
callback)
Moves the page to the selected dom object - pause(
Integer
milliseconds,Function
callback)
Pauses the commands by the provided milliseconds - refresh(
Function
callback)
Refresh the current page - saveScreenshot(
String
path to file,Function
callback)
Saves a screenshot as a png from the current state of the browser - setCookie(
Object
cookie,Function
callback)
Sets a cookie for current page. - setValue(
String
css selector,String|String[]
value,Function
callback)
Sets a value to an object found by a css selector (clears value before). You can also use unicode characters likeLeft arrow
orBack space
. You'll find all supported characters here. To do that, the value has to correspond to a key from the table. - submitForm(
String
css selector,Function
callback)
Submits a form found by the css selector - waitFor(
String
css selector,Integer
milliseconds,Function
callback)
Waits for an object in the dom (selected by css selector) for the amount of milliseconds provided. the callback is called with false if the object isnt found.
Here are the implemented bindings (and links to the official json protocol binding)
- alertAccept
- alertDismiss
- alertText
- buttondown
- buttonup
- element
- elementIdAttribute
- elementIdClick
- elementDoubleClick
- elementIdCssProperty
- elementIdDisplayed
- elementIdLocation
- elementIdLocationInView
- elementIdName
- elementIdSize
- elementIdText
- elementIdValue
- elementIdSelected
- elements
- execute
- frame
- init
- moveto
- screenshot
- session
- sessions
- status
- submit
- title
- url
- source
- window
- windowHandles
- windowHandlePosition
- windowHandleSize
- forward
- back
- refresh
- cookie
- cookieName
The npm module for this library is maintained by: