Skip to content
Selenium Hub/Grid built in nodeJS and used in production on
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
lib partial update to new version Nov 29, 2015
tests Clean up unused/unnecessary code. Dec 23, 2013


Selenium Hub/Grid built in nodeJS and used in production on

At TestingBot we've been using this code for 11 months now, running on a single CPU server with the latest version of nodejs.

We built this to replace the Selenium grid functionality that comes with the default Selenium source code in Java. One of the reasons we used nodeJS was because we wanted it to be easy to read and understand.

With this code, you can run a Selenium grid, point your own Selenium nodes to it and run tests against it. It also comes with an option to use the TestingBot grid if a specific browser is not present on your grid. So for example: you have 2 virtual machines with both Linux and Windows but you also want to run tests against Mac. By using this grid, your tests will run on your own 2 virtual machines and use the TestingBot grid to run the tests on our Mac VMs.



  • NodeJS, at least v0.10.0
  • npm

User Quick Start

  • sudo npm -g install node-seleniumgrid
  • node-seleniumgrid -k testingbot_key -s testingbot_secret

You now have a local Selenium grid running on port 4444. Start a Selenium node and point it to this grid, it should register to the grid. Now run a simple Selenium test against your new grid, depending on the capabilities you requested it should forward the test to your Selenium node.

  1. run node-seleniumgrid
  2. start a node java -jar selenium-standalone.jar -role node -hub http://my-computer-ip:4444/grid/register
  3. point your test to run on my-computer-ip port 4444:
require "rubygems"
require "selenium-webdriver" 
require "selenium/client"

caps = {
  :browserName => "firefox",
  :version => "22",
  :platform => "WINDOWS"

urlhub = "http://my-computer-ip:4444/wd/hub"
client =
client.timeout = 120

@webdriver = Selenium::WebDriver.for :remote, :url => urlhub, :desired_capabilities => caps, :http_client => client ""
puts @webdriver.title


If you encounter problems setting this up, please open a ticket in the issues section.


There are tests included in this project, to run them, please use mocha: mocha tests/*.js


Fork the project, make a change, and send a pull request!


Licensed under the Apache License, Version 2.0

You can’t perform that action at this time.