eslint-plugin-userscripts

Implements rules for userscripts in eslint.

Installation

You'll first need to install ESLint:

1npm install eslint --save-dev

Next, install eslint-plugin-userscripts:

1npm install eslint-plugin-userscripts --save-dev

Usage in legacy config

Add userscripts to the plugins section of your .eslintrc configuration file:

1{
2  "extends": ["plugin:userscripts/recommended"]
3}

Usage in recent flat config

Add an element to the config array in your eslint.config.* file :

1const userscripts = require('eslint-plugin-userscripts');
2
3module.exports = [
4  // other configs
5  {
6    files: ['*.user.js'],
7    plugins: {
8      userscripts: {
9        rules: userscripts.rules
10      }
11    },
12    rules: {
13      ...userscripts.configs.recommended.rules
14    },
15    settings: {
16      userscriptVersions: {
17        violentmonkey: '*'
18      }
19    }
20  }
21];

Supported Rules

Rule	Description	Recommended
filename-user	Ensures userscripts end with .user.js	✅
no-invalid-grant	Ensures the argument passed to @grant is valid	✅
no-invalid-metadata	Ensures userscripts have valid metadata	✅
require-name	Ensures userscripts have a name	✅
require-description	Ensures userscripts have a description	✅
require-version	Ensures userscripts have a valid version	✅
use-homepage-and-url	Ensures that for each homepage attribute, homepageURL is also used	✅
require-download-url	Ensures that for each downloadURL there is a updateURL	✅
align-attributes	Ensures that attributes are spaced out and aligned	✅
require-attribute-space-prefix	Ensure that attributes are prefixed by one space	✅
metadata-spacing	Ensures there is a newline between the metadata and the code	✅
no-invalid-headers	Ensures userscripts have valid headers	✅
compat-grant	Ensures your @grant permissions are supported
compat-headers	Ensures your headers are supported
better-use-match	Prefers @match over @include	✅