This repository contains the extension code for Greg Martin and Shoshana Vasserman's study to be hosted by Mozilla Rally.
/schemas- This directory contains files that outline the data being sent to Mozilla's servers, and examples of that data.
/src- This directory contains the source code for this extension
/tests/integration- This directory would contain integration tests
- It's currently (as of 5/11/21) just the template scripts
manifest.json- This file contains important permission information, as well as the location of the background script to run
package.json- This file contains important information about dependant packages and npm scripts
web-ext-config.js- This file contains information to run the extension locally
- The use of Firefox nightly is configured in this file
- Start by cloning this repository
- You might need the Firefox nightly build, which can be downloaded here
- You'll also need to install
nodeandnpmlocally. - In the root directory of the repo, run
npm installto install all dependency packages - In the root directory of the repo, run
npm run buildand ensure there are no errors - Once you've built the package without errors, you can run
npm run watchto start the extension. A version of Firefox with the extension should start automatically.- In
about:debugging, you should see your extension under "This Firefox" - If you click "Inspect", you'll be guided to a debugging site for your extension
- The data should be available under Storage > Extension Storage > moz-extension://......
- If you want to dump the current data, type
let data = await browser.storage.local.get()in the debugging console, and then print thedatavariable. You can copy the object from there- Note: This command must be run from the
about:debugging-> Extension Console. It won't work from the normal Firefox console.
- Note: This command must be run from the
- In
Note: These instructions are written for a MacOSX user. They'll likely be very similar for a Linux user, but not for Windows.