Firefox

This module is a browser plugin for DalekJS. It provides all a WebDriverServer & browser launcher for Mozilla Firefox & Firefox OS.

The browser plugin can be installed with the following command:

 $ npm install dalek-browser-firefox --save-dev
 

You can use the browser plugin by adding a config option to the your Dalekfile

 "browser": ["firefox"]
 

Or you can tell Dalek that it should test in this browser via the command line:

 $ dalek mytest.js -b firefox
 

Dalek looks for the browser in the std. installation directory, if you installed the browser in a different place, you can add the location of the browser executable to you Dalekfile, because Dalek isnʼt capable of finding the executable yet on its own.

 "browsers": [{
   "firefox": {
     "path": "~/Apps/FirefoxNightlyDebug.app/Contents/MacOS/firefox-bin"
   }
 }]
 

The Firefox plugin only implements a subset of Dalekʼs assertions & actions, so if you run into any bugs, the issue is most probably related to missing commands. Please report any issues you find, Thank you :)

The Webdriver Server tries to open Port 9006 by default, if this port is blocked, it tries to use a port between 9007 & 9096 You can specifiy a different port from within your Dalekfile like so:

 "browsers": [{
   "firefox": {
     "port": 5555 
   }
 }]
 

It is also possible to specify a range of ports:

 "browsers": [{
   "firefox": {
     "portRange": [6100, 6120] 
   }
 }]
 

If you would like to test Nightly, Aurora oder Firefox OS releases, you can simply apply a snd. argument, which defines the browser type:

 $ dalek mytest.js -b firefox:aurora
 

for Firefox Aurora, and if you would like to use the Firefox OS, just append :os:

 $ dalek mytest.js -b firefox:os
 

This will only work if you installed your browser in the default locations, if the browsers binary is located in a non default location, you are able to specify its location in your Dalekfile:

 "browsers": [{
   "firefox": {
     "binary": "/Applications/Custom Located Firefox.app/MacOS/Contents/firefox-bin" 
   }
 }]
 

This also works for the aurora & Firefox OS builds

 "browsers": [{
   "firefox:aurora": {
     "binary": "/Applications/Custom Located Firefox Aurora.app/MacOS/Contents/firefox-bin" 
   }
 }]