detect and launch browser versions, headlessly or otherwise
Latest commit f05b11c Sep 3, 2014 @substack 1.0.0
Failed to load latest commit information.
bin command to print the config Dec 27, 2013
example add options support while launching browsers Apr 25, 2013
lib fix the formatting mess Jul 11, 2013
node_modules/headless Do not use path.exists Jul 11, 2013
LICENSE package.json Jun 27, 2012
README.markdown 0.3.0 Apr 25, 2013
index.js using xtend Sep 3, 2014
package.json 1.0.0 Sep 3, 2014



Detect the browser versions available on your system and launch them in an isolated profile for automated testing purposes.

You can launch browsers headlessly (if you have Xvfb or with phantom) and set the proxy configuration on the fly.


var launcher = require('launcher');
launcher(function (err, launch) {
    if (err) return console.error(err);

    console.log('# available browsers:');

    var opts = {
        headless : true,
        browser : 'chrome',
        proxy : 'localhost:7077',
    launch('', opts, function (err, ps) {
        if (err) return console.error(err);

$ node example/launch.js 
# available browsers:
{ local: 
   [ { name: 'chrome',
       re: {},
       type: 'chrome',
       profile: '/home/substack/.config/browser-launcher/chrome-17.0.963.12_9c0bdd8d',
       command: 'google-chrome',
       version: '17.0.963.12' },
     { name: 'chromium',
       re: {},
       type: 'chrome',
       profile: '/home/substack/.config/browser-launcher/chromium-18.0.1025.168_e025d855',
       command: 'chromium-browser',
       version: '18.0.1025.168' },
     { name: 'phantom',
       re: {},
       type: 'phantom',
       headless: true,
       profile: '/home/substack/.config/browser-launcher/phantom-1.4.0_31767fa2',
       command: 'phantomjs',
       version: '1.4.0' },
     { name: 'firefox',
       re: {},
       type: 'firefox',
       profile: [Object],
       command: 'firefox',
       version: '12.0' } ] }


var launcher = require('launcher')


Create a new launcher function in cb(err, launch), scanning for system browsers if no ~/.config/browser-launcher/config.json is present and reading from that file otherwise.

launch(uri, opts, cb)

Launch a new instance of opts.browser with the optional version constraint opts.version. Without an opts.version, the highest version of opts.browser is used.

To launch the browser headlessly (if it isn't already headless like phantom), set opts.headless. This launches the browser with node-headless which uses the Xvfb command to create a fake X server.

To use the browser with a proxy, set opts.proxy as a colon-separated 'host:port' string.

Set proxy routes to skip over with opts.noProxy.

You can pass additional options directly through to the browser commands with opts.options.

cb fires with cb(err, ps) where ps is the process object created with spawn().


This property shows what browsers are configured to be launchable, divided into groups. The default group is 'local'.


npm install browser-launcher