firefox-profile

firefox-profile-js

Firefox Profile for Selenium WebdriverJS, admc/wd or any other library that allows you to set capabilities.

This class allows you to:

• create a firefox profile
• use an existing profile (by specifying path)
• add extensions to your profile,
• specify proxy settings,
• set the user preferences...

More info on user preferences here.

Installation

"real" npm support is on its way... soon... maybe... Open an issue if you need it... Use npm:

npm install firefox-profile

Usage

Make sur you have selenium server running... or use 'selenium-webdriver/remote' class.

Steps

• create a profile
• modify the profile:
  • setPreference(key, value)
  • addExtension(path/To/Extenstion.xpi) or addExtension(path/To/Unpacked/Extension/)
• create firefox capabilities and set the 'firefox_profile' capability to profile.encoded()
• attach the capabilitites to your webdriver (using withCapabilities)

I wanna see it!

    /******************************************************************
     * with selenium webdriverJs
     * installs firebug 
     * and make http://saadtazi.com the url that is opened on new tabs
    /******************************************************************
    var webdriver = require('selenium-webdriver');

    // create profile
    var FirefoxProfile = require('firefox-profile');
    var myProfile = new FirefoxProfile();

    // you can add an extension by specifying the path to the xpi file 
    // or to the unzipped extension directory
    myProfile.addExtension('test/extensions/firebug-1.12.4-fx.xpi', function() {
    	
        var capabilities = webdriver.Capabilities.firefox();
        
        // attach your newly created profile
        
        myProfile.encoded(function(encodedProfile) {
            capabilities.set('firefox_profile', encodedProfile);

            // you can set firefox preferences
            myProfile.setPreference('browser.newtab.url', 'http://saadtazi.com');

            // it is required to create or update user.js
            // only needed if you set some preferences
            myProfile.updatePreferences();
            
            // start the browser
            var wd = new webdriver.Builder().
                      withCapabilities(capabilities).
                      build();
            
            // woot!
            wd.get('http://en.wikipedia.org');
        });
    });

    /**************************************************
    /* with admc/wd
    /* installs firebug, and make it active by default
    /**************************************************

    var FirefoxProfile = require('./lib/firefox_profile'),
        wd = require('wd');

    // set some userPrefs if needed
    var fp = new FirefoxProfile();
    // activate and open firebug by default for all sites
    fp.setPreference('extensions.firebug.allPagesActivation', 'on');
    // activate the console panel
    fp.setPreference('extensions.firebug.console.enableSites', true);
    // show the console panel
    fp.setPreference('extensions.firebug.defaultPanelName', 'console');
    fp.updatePreferences();
    // you can install multiple extensions at the same time
    fp.addExtensions(['test/extensions/firebug-1.12.4-fx.xpi'], function() {
        fp.encoded(function(zippedProfile) {
            browser = wd.promiseChainRemote();
            browser.init({
              browserName:'firefox',
              // set firefox_profile capabilities HERE!!!!
              firefox_profile: zippedProfile
            }).
            // woOot!!
            get('http://en.wikipedia.org');
        });
});

API Documentation

The API documentation can be found in doc/.

It can be regenerated using grunt docs. Requires apidox - listed in devDependencies.

Tests

mocha
# or
grunt mochacov:unit

Coverage

grunt mochacov:coverage

Generates doc/coverage.html

TODO

• add documentation and comments
• write tests
• fix bugs
• write more tests
• fix more bugs
• clean tmp directory on process 'exit' and 'SIGINT'

Disclaimer

This class is actually a port of the python class.

Found a bug?

Open a github issue.

Changelog

0.1.1

• fixed potential EMFILE when installing multiple extensions (contribution from https://github.com/circusbred)