Package Exports
- firefox-profile
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (firefox-profile) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
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
- attach the capabilitites to your webdriver
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();
// you can set firefox preferences BEFORE calling encoded()
myProfile.setPreference('browser.newtab.url', 'http://saadtazi.com');
// attach your newly created profile
myProfile.encoded(function(encodedProfile) {
capabilities.set('firefox_profile', encodedProfile);
// 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('firefox-profile'),
wd = require('wd');
// set some userPrefs if needed
// Note: make sure you call encoded() after setting some userPrefs
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');
// 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 commentswrite testsfix 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.