addons-linter for Mac

The Add-ons Linter is being used by web-ext and addons.mozilla.org to lint WebExtensions.

It can also be used as a standalone binary and library.

You can find more information about the linter and it's implemented rules in our documentation.

Usage

Command Line

You need Node.js to use the add-ons linter.

To validate your add-on locally, install the linter from npm:

After installation, run the linter and direct it to your add-on file:

Alternatively you can point it at a directory:

The addons-linter will check your add-on and show you errors, warnings, and friendly messages for your add-on. If you want more info on the options you can enable/disable for the command-line app, use the --help option:

Privileged extensions

The addons-linter can lint privileged extensions only when the --privileged option is passed to it. This option changes the behavior of the linter to: emit errors when the input file (or directory) is a regular extension (i.e. the extension does not use privileged features) hide messages related to privileged features (e.g., permissions and properties) when the input file (or directory) is a privileged extension

Linter API Usage

You can use the linter directly as a library to integrate it better into your development process.

linter.output is composed by the following properties (the same of the 'json' report type):

Development

If you'd like to help us develop the addons-linter, that's great! It's pretty easy to get started, you just need Node.js installed on your machine.

Quick Start

If you have Node.js installed, here's the quick start to getting your development dependencies installed and running the tests

You can also build the addons-linter binary to test your changes.

Required Node version

addons-linter requires Node.js v22 or greater. Have a look at our .circleci/config.yml file which Node.js versions we officially test.

Using nvm is probably the easiest way to manage multiple Node versions side by side. See nvm on GitHub for more details.

Install dependencies

Install dependencies with npm:

npm scripts

Building

You can run npm run build to build the library.

Once you build the library you can use the CLI in bin/addons-linter.

Testing

Run npm test. This will watch for file-changes and re-runs the test suite.

Coverage

We're looking to maintain coverage at 100%. Use the coverage data in the test output to work out what lines aren't covered and ensure they're covered.

Assertions and testing APIs

We are using using Sinon for assertions, mocks, stubs and more see the Sinon docs for the API available.

Jest is being used as a test-runner but also provides helpful tools. Please make sure you read their documentation for more details.

Logging

We use pino for logging: By default logging is off (level is set to 'fatal') . Logging in tests can be enabled using an env var e.g: LOG_LEVEL=debug jest test Logging on the CLI can be enabled with --log-level [level].

Prettier