wd-sync-raw

wd-sync

A synchronous version with a nice api of wd, the lightweight WebDriver / Selenium2 client for node.js, built using node-fibers.

Site

Note: headless zombie was removed in 1.1.0

"Raw" fork: This version is a drop-in replacement for the official node-wd-sync with one additional feature: In node-wd-sync, elements returned from synchronized methods are wrapped in synchronization code as well. This fork provides access to the original, untouched element, which you can reference via the .rawElement property in cases where you need to access the unmodified element. E.g.:

var element = browser.elementByCssSelector('#myElement');
browser.execute('arguments[0].className += " hidden"', [element.rawElement]);

status

install

npm install wd-sync

code samples

CoffeeScript

# assumes that selenium server is running 
 
wdSync = require 'wd-sync'
 
# 1/ simple Wd example 
 
{browser, sync} = wdSync.remote()
 
sync ->
  console.log "server status:", @status()
  @init browserName:'firefox'
  console.log "session id:", @getSessionId()
  console.log "session capabilities:", @sessionCapabilities()
 
  @get "http://google.com"
  console.log @title()
 
  queryField = @elementByName 'q'
  @type queryField, "Hello World"
  @type queryField, "\n"
 
  @setWaitTimeout 3000
  @elementByCss '#ires' # waiting for new page to load 
  console.log @title()
 
  console.log @elementByNameIfExists 'not_exists' # undefined 
 
  @quit()
 

JavaScript

// assumes that selenium server is running
 
var wdSync = require('wd-sync');
 
// 1/ simple Wd example
 
var client = wdSync.remote()
    , browser = client.browser
    , sync = client.sync;
 
sync( function() {
 
  console.log("server status:", browser.status());
  browser.init( { browserName: 'firefox'} );
  console.log("session id:", browser.getSessionId());
  console.log("session capabilities:", browser.sessionCapabilities());
 
  browser.get("http://google.com");
  console.log(browser.title());
 
  var queryField = browser.elementByName('q');
  browser.type(queryField, "Hello World");
  browser.type(queryField, "\n");
 
  browser.setWaitTimeout(3000);
  browser.elementByCss('#ires'); // waiting for new page to load
  console.log(browser.title());
 
  console.log(browser.elementByNameIfExists('not_exists')); // undefined
 
  browser.quit();
 
});
 

doc

• CoffeeScript
• JavaScript
• wd doc
• JsonWireProtocol official doc

Note: Doc and README modifications must be done in the doc/template directory.

examples

• CoffeeScript
• JavaScript

api

supported

full JsonWireProtocol mapping

available environments

WebDriver

local WebDriver / Selenium2 server

Sauce Labs

Remote testing with Sauce Labs.

running tests

local / selenium server:

1/ Install and start Selenium server

./node_modules/.bin/install_selenium
./node_modules/.bin/install_chromedriver
./node_modules/.bin/start_selenium_with_chromedriver

2/ run tests

make test

remote / Sauce Labs

1/ configure sauce environment

export SAUCE_USERNAME=<SAUCE_USERNAME>
export SAUCE_ACCESS_KEY=<SAUCE_ACCESS_KEY>
# if using sauce connect
./node_modules/.bin/install_sauce_connect
./node_modules/.bin/start_sauce_connect

2/ run tests

make test_e2e_sauce
make test_midway_sauce_connect

building doc/mapping

README + doc

1/ Update the templates

2/ run make build_doc

mappings

1/ Upgrade wd

2/ run make build_mapping

publishing

npm version [patch|minor|major]
git push --tags origin master
npm publish