Skip to content

A browser extension to debug the Firefox Normandy client

Notifications You must be signed in to change notification settings

tiftran/normandy-devtools

 
 

Repository files navigation

Normandy Devtools

A set of tools for interacting with Normandy without using a server.

Features

  • Disables automatic runs of Normandy
  • Allows triggering full runs of Normandy manually
  • Lists all recipes from the server, including if their filter matches the current browser
  • Allows executing individual recipes, regardless of filters
  • See current filter expression context
  • Evaluate filter expressions
  • Use a different Normandy environment (does not change browser settings)
  • Create custom one-off recipes for testing

Planned features

  • Choose branch for preference studies (Issue #2)
  • Temporarily change filter expressions context (Issue #4)
  • Check signature state of recipes (Issue #5)

Installation

This extension uses a web extension experimental API to communicate with Normandy. It requires Firefox 62 or higher. As of version 0.5.0, the add-on can be installed on any compatible Nightly without changing preferences.

It is recommended to use Nightly with a dedicated profile while development of this extension active.

  1. Download the latest release from the releases page on Github.

  2. Open about:addons, and choose "Install from File" from the gear in the top right. Choose the .zip file downloaded from the releases page.

  3. Click on the new hand icon in the browser toolbar.

Note that the extension will not automatically update.

Development

You'll need to use Nightly and about:debugging to use unsigned development versions of the add-on.

$ git clone https://github.com/mozilla/normandy-devtools.git
$ cd normandy-devtools
$ yarn install

To run the extension in development mode:

$ yarn watch

To build the extension in production mode:

$ yarn build

This will create a zip file ./web-ext-artifacts/normandy-devtools-$VERSION.zip.

To sign the zip file, use mozilla-addon-signer.

About

A browser extension to debug the Firefox Normandy client

Resources

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 75.6%
  • Python 18.7%
  • CSS 5.7%