This article provides suggestions for how to set up your Mozilla application for extension development. These details apply to Firefox, Thunderbird, and SeaMonkey (version 2.0 and above).
Overview
- You'll create a new user profile to run your development specific Firefox session. This will utilize distinctive development preferences in
about:config
. - Install Firefox development extensions specifically for this new developer user profile.
- Edit files in the extensions folder of this profile, and restart the application as this new developer profile.
Development profile
The use of a separate user profile for development can be advantageous, averting performance degradation from development related settings, and further isolating personal data (such as bookmarks, extensions, and settings) from your testing environment. You could be running two instances of Firefox simultaneously.
Note: For an extended guide on how to set up even more user profiles, take a look at Multiple Firefox profiles. This particularly comes in handy for the use of all currently available Firefox versions: Firefox, Beta, Developer Edition, and Nightly. It even allows the running of simultaneous versions, at the same time.
To quickly achieve our task of creating just a developer profile, we will start the application with the parameters:
/path/to/Firefox -no-remote
-P ProfileName
Without these parameters, the default behavior of your Mozilla applications is to only open the everyday user profile: named default. As we are specifically defining the user profile dev, If you don't have the dev profile already created, the profile selection window opens, where you can create it.
In the following example, the described command starts a new instance of Firefox, with a profile called dev; even if an instance of Firefox is already running.
On Ubuntu (and many other Linux distributions):
/usr/bin/firefox -no-remote -P dev
On other distributions of Linux/Unix:
/usr/local/bin/firefox -no-remote -P dev
On MacOS Mavericks (10.9) and newer:
/Applications/Firefox.app/Contents/MacOS/firefox-bin -no-remote -P dev &
On Windows:
Start -> Run "%ProgramFiles%\Mozilla Firefox\firefox.exe" -no-remote -P dev
On Windows 64 bit:
Start -> Run "%ProgramFiles(x86)%\Mozilla Firefox\firefox.exe" -no-remote -P dev
To start Thunderbird or SeaMonkey instead of Firefox, substitute thunderbird
, or seamonkey
for the firefox
used in our examples.
Note: you could run Firefox using your regular profile while developing. However, you won't enjoy the benefits of isolated resources, which we discussed earlier.
The Parameter -P ProfileName
doesn't imply -no-remote
, therefore use them together. If you are already running a Firefox instance without -no-remote
, and you attempt to start another instance with -P ProfileName
(but without the -no-remote
parameter), that second invocation would ignore its -P ProfileName
parameter, instead opening a new window for the already running instance; sharing all its profile, sessions etc.
Download Firefox
Download your desired version of Firefox. For example, Nightly and/or Developer Edition. Unpack them in your user home directory, and name folders for easy navigation to firenightly and firedevedition or similar. You do not have to install these unstable versions, if you do not wish.
Make a symbolic link (also referred to as a shortcut) to the firefox binary (firefox.exe on Windows), then move the link to your desktop, or your preferred location. To run this version of Firefox, simply double click on this file. Explore this profile a little: change some settings, install any additional extensions, and finally close this instance of Firefox.
Now run your Firefox Profile Manager. (Linux, Mac OS X, Windows instructions.) You'll see the list of available user profiles one which is default (stable) and other (unstable) profile(s) created automatically when you run other versions of Firefox earlier. Choose default and uncheck "Don't ask at startup" checkbox. Click "Start Firefox". Now when you start any version of Firefox you may choose any profile you like.
Development command flags
As of Gecko 2 (Firefox 4), JavaScript files are cached ("fastload"). The -purgecaches
command-line flag disables this behavior. Alternatively, you can set the MOZ_PURGE_CACHES environment variable. See this bug for more information.
Development preferences
There is a set of development preferences that, when enabled, allows you to view more information about application activity, thus making debugging easier. However, these preferences can degrade performance, so you may want to use a separate development profile when you enable these preferences.
Accessing Firefox development preferences
To change preference settings in Firefox or SeaMonkey, type about:config
in the Location Bar. You can also use the Extension Developer's Extension, which provides a menu interface for Firefox settings.
Accessing Thunderbird development preferences
To change preference settings in Thunderbird, open the "Preferences" (Unix) or "Options" (Windows) interface. On the "Advanced" page, select the "General" tab then click the "Config Editor" button.
Recommended development preferences
Not all preferences are defined by default, and are therefore not listed by default. You will have to create new (boolean) entries for them. For more information about Mozilla preferences, refer to the mozillaZine article on "about:config".
Tip: You can install either the Developer Profile or DevPrefs add-ons to handle setting these preferences automatically, and skip the rest of this section.
- javascript.options.showInConsole = true. Logs errors in chrome files to the Error Console.
- nglayout.debug.disable_xul_cache = true. Disables the XUL cache so that changes to windows and dialogs do not require a restart. This assumes you're using directories rather than JARs. Changes to XUL overlays will still require reloading of the document overlaid.
- browser.dom.window.dump.enabled = true. Enables the use of the dump() statement to print to the standard console. See
window.dump
for more info. You can usensIConsoleService
instead ofdump()
from a privileged script. - javascript.options.strict = true. Enables strict JavaScript warnings in the Error Console. Note that since many people have this setting turned off when developing, you will see lots of warnings for problems with their code in addition to warnings for your own extension. You can filter those with Console2.
- devtools.chrome.enabled = true. This enables to run JavaScript code snippets in the chrome context of the Scratchpad from the Tools menu. Don't forget to switch from content to browser as context.
- devtools.debugger.remote-enabled = true. This adds a "Browser Debugger" entry to the "Web Developer" submenu of the "Tools" menu. The Browser Debugger can be used to debug the JavaScript code of extensions. The
devtools.chrome.enabled
preference must also be set to true for the Browser Debugger to be enabled. - devtools.debugger.prompt-connection = false. This prevents the Browser Debugger from prompting for connection permission every time.
- extensions.logging.enabled = true. This will send more detailed information about installation and update problems to the Error Console. (Note that the extension manager automatically restarts the application at startup sometimes, which may mean you won't have time to see the messages logged before the automatic restart happens. To see them, prevent the automatic restart by setting the environment NO_EM_RESTART to 1 before starting the application.)
- nglayout.debug.disable_xul_fastload = true. For Gecko 2.0+ (Firefox 4.0+). See this bug for more information. Although the bug has been closed, it is believed that this pref is still relevant.
- You might also want to set dom.report_all_js_exceptions = true. See Exception logging in JavaScript for details.
- devtools.errorconsole.deprecation_warnings = true. Detect deprecated code use.
nglayout.debug.disable_xul_fastload
to true in a production environment; it exists solely to aid in debugging. In particular, add-ons should never change this preference.Note: The Error Console is disabled by default starting in Gecko 2.0. You can re-enable it by changing the devtools.errorconsole.enabled
preference to true
and restarting the browser. With this, javascript.options.showInConsole
is also set to true
by default.
Development extensions
These extensions may help you with your development.
- DOM Inspector, used to inspect and edit the live DOM of any web document or XUL application (Firefox and Thunderbird)
- Venkman, a JavaScript Debugger (Firefox version, Thunderbird version)
- Thunderbird Developer Tools, enables debugging Thunderbird remotely using using Firefox developer tools
- Extension Developer's Extension a suite of tools for extension development (Firefox)
- Extension Test an add-on which makes it easier to detect problems which will lead to rejection by addons.mozilla.org
- Console² enhanced JavaScript console (Firefox version, Thunderbird version)
- Javascript Command for writing/testing javascript on Firefox windows
- Inspect Context Open DOM Inspector at this node from Inspect on context menu.
- Chrome List navigate and view files in chrome:// (Firefox version, Thunderbird version)
- Chrome Edit Plus a user file editor (Firefox and Thunderbird)
- Firebug a variety of development tools (Firefox)
- Pentadactyl, a general purpose extension with builtin tools for extension development, including a command line with chrome JavaScript evaluation (including property and function argument completion) and the ability to demand-load external JavaScript and CSS files into window chrome.
- Chromebug combines elements of a JavaScript debugger and DOM (Firefox, "kinda works for Thunderbird")
- MozRepl explore and modify Firefox and other Mozilla apps while they run (Firefox, Thunderbird version is not working)
- ExecuteJS an enhanced JavaScript console (Firefox version, Thunderbird version is not working)
- XPCOMViewer an XPCOM inspector (Firefox and Thunderbird)
- JavaScript shells to test snippets of JavaScript (Firefox and Thunderbird)
- SQLite Manager to manage the SQLite database (Firefox and Thunderbird)
- ViewAbout enables access to various about: dialogs from the View menu (Firefox version, Thunderbird version )
- Crash Me Now! useful for testing debug symbols and the crash reporting system (Firefox and Thunderbird)
- Javascript Object Examiner displays JavaScript object methods and properties for any available scope
- Developer Profile and DevPrefs sets up the development environment described above when installed (Firefox and Fennec)
Firefox extension proxy file
Extension files are normally installed in the user profile. However, it is usually easier to place extension files in a temporary location, which also protects source files from accidental deletion. This section explains how to create a proxy file that points to an extension that is installed in a location other than the user profile.
- Get the extension ID from the extension's install.rdf file.
- Create a file in the "
extensions
" directory under your profile directory with the extension's ID as the file name (for example "your_profile_directory/extensions/{46D1B3C0-DB7A-4b1a-863A-6EE6F77ECB58}
"). (How to find your profile directory) Alternatively, rather than using a GUID, create a unique ID using the format "name@yourdomain" (for examplechromebug@mydomain.com
) - then the proxy filename will be same as that ID, with no curly brackets {}. -
The contents of this file should be the path to the directory that contains your install.rdf file, for example
/full/path/to/yourExtension/
on Mac and Linux, andC:\full\path\to\yourExtension\
on Windows. Remember to include the closing slash and remove any trailing whitespace.- Note: If you already installed the extension via XPI, you should uninstall it first before creating the pointer file.
- Also note that the use of proxy files requires that the extension's chrome.manifest defines its chrome urls using traditional directories, rather than a JARed structure. See below.
- Place the file in the extensions folder of your profile and restart the application.
Using directories rather than JARs
Regardless of whether you choose to eventually package your extension's chrome in a JAR or in directories, developing in directories is simpler. If you choose a JARed structure for releasing, you can still develop with a directory structure by editing your chrome.manifest. For example, rather than having
content myExtension jar:chrome/myExtension.jar!/content/
use
content myExtension chrome/content/
Preventing the first launch extension selector
Requires Gecko 8.0(Firefox 8.0 / Thunderbird 8.0 / SeaMonkey 2.5)Starting in Firefox 8, on the first launch of a new version of Firefox, it presents user interface letting users select which third party add-ons to keep. This lets them weed out add-ons that were installed without their knowledge, or that are no longer needed.
However, this interface can be disruptive when debugging add-ons. You can avoid this by setting the preference extensions.autoDisableScopes
to 14
.