webdriverjs
Advanced tools
A WebDriver module for nodejs. Either use the super easy help commands or use the base Webdriver wire protocol commands.
It is written so its easy to add new protocol implementations and add helper commands so make testing easier. Each command resides as one file inside the node module folder which makes it easy to extend.
The two main reasons for this projects are:
Ease of use - Writing tests with webdriver should be very easy
Easy to extend - Adding helper functions, or more complicated sets and combinations of existing commands, should also be very easy.
Either download it from github or use npm:
npm install webdriverjs
Run selenium server first:
java -jar node_modules/webdriverjs/bin/selenium-server-standalone-2.31.0.jar
You can use any nodejs test framework as well as any BDD/TDD assertion library.
describe('my webdriverjs tests', function(){
this.timeout(99999999);
var client = {};
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, 68);
})
.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.
If you want to extend with your own set of commands there is a method called addCommand:
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('http://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();
Type: Object
Default capabilities:
browserName: 'firefox', // options: firefox, chrome, opera, safari
version: '',
javascriptEnabled: true,
platform: 'ANY'
If selenium can't find the browser binary, add the path as attribute in your desiredCapabilities object.
for Firefox:
'firefox_binary': <path to binary>
//e.g. '/Applications/Firefox.app/Contents/MacOS/firefox'
for Chrome:
'chrome.binary': <path to binary>
for Opera:
'opera.binary': <path to binary>
for Safari:
'safari.binary': <path to binary>
Type: String
Default: verbose
Options: verbose | silent | command | data | result
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.
String css selector, String value, Function callback)String css selector, Function callback)String css selector, Function callback)String css selector, Function callback)String name, Function callback)String css selector, Function callback)String sourceCssSelector, String destinationCssSelector, Function callback)Function callback)String script, Array arguments, Function callback)String css selector, String attribute name, Function callback)Function callback)String css selector, String css property name, Function callback)String find by, String finder, String css property name, Function callback)String css selector, Function callback)String css selector, Function callback)String css selector, Function callback)String css selector, Function callback)Function callback)String css selector, Function callback)String css selector, Function callback)Function callback)String css selector, Function callback)String css selector, Function callback)String css selector, Function callback)String css selector, Function callback)Integer milliseconds, Function callback)Function callback)String path to file, Function callback)Object cookie, Function callback)String css selector, String value, Function callback)String css selector, Function callback)String css selector, Integer milliseconds, Function callback)Here are the implemented bindings (and links to the official json protocol binding)
The npm module for this library is maintained by:
FAQs
A nodejs bindings implementation for selenium 2.0/webdriver
The npm package webdriverjs receives a total of 36 weekly downloads. As such, webdriverjs popularity was classified as not popular.
We found that webdriverjs demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 4 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Research
Socket researchers have discovered malicious npm packages targeting crypto developers, stealing credentials and wallet data using spyware delivered through typosquats of popular cryptographic libraries.
Security News
Socket's package search now displays weekly downloads for npm packages, helping developers quickly assess popularity and make more informed decisions.
Security News
A Stanford study reveals 9.5% of engineers contribute almost nothing, costing tech $90B annually, with remote work fueling the rise of "ghost engineers."