WDIO Firefox Profile Service
You want to run your Firefox browser with a specific extension or need to set couple preferences? Selenium allows you to use a profile for the Firefox browser by passing this profile as
base64 string to the
firefox_profile property in your desired capabilities. This requires to build that profile and convert it into
base64. This service for the wdio testrunner takes the work of compiling the profile out of your hand and let's you define your desired options comfortable from the
To find all possible options just open about:config in your Firefox browser or go to mozillaZine website to find the whole documentation about each setting. In Addition to that you can define compiled (as
*.xpi) Firefox extensions that should get installed before the test starts.
The easiest way is to keep
@wdio/firefox-profile-service as a devDependency in your
You can simple do it by:
npm install @wdio/firefox-profile-service --save-dev
Instructions on how to install
WebdriverIO can be found here.
Setup your profile by adding the
firefox-profile service to your service list. Then define your settings in the
firefoxProfile property like this:
// wdio.conf.js// ...};
If you have build a custom Firefox extension that you want to install in the browser make sure to set
'xpinstall.signatures.required': false as profile flag since Firefox extensions are required to be signed by Mozilla.
Contains all settings as key value pair. You can find all available settings on the
Add one or multiple extensions to the browser session. All entries can be either an absolute path to the
.xpi file or the path to an unpacked Firefox extension directory.
Create Firefox profile based on an existing one by setting an absolute path to that profile.
Set network proxy settings. The parameter
proxy is a hash which structure depends on the value of mandatory
proxyType key, which takes one of the following string values:
direct- direct connection (no proxy)
system- use operating system proxy settings
pac- use automatic proxy configuration set based on the value of
manual- manual proxy settings defined separately for different protocols using values from following keys:
Automatic Proxy:// wdio.conf.js}// ...};
Manual HTTP Proxy:// wdio.conf.js}// ...};
Manual HTTP and HTTPS Proxy:// wdio.conf.js}// ...};
Please set this flag to
true if you use Firefox v55 or lower.
For more information on WebdriverIO see the homepage.