eslint-plugin-top

Disallow side effects at the top level of files.

Quick links: npm | Source code | License | Changelog | Security

Installation

Install eslint-plugin-top, along with ESLint if it isn't already installed:

npm install @ericcornelissen/eslint-plugin-top eslint --save-dev

Usage

New Config (since ESLint v9)

Import from @ericcornelissen/eslint-plugin-top and use one of the preset configurations, e.g.:

import top from '@ericcornelissen/eslint-plugin-top';

export default [
  top.configs.recommended,
  // or
  top.configs.strict
  // ...
];

Or configure the rules you want to use in the rules section, e.g.:

import top from '@ericcornelissen/eslint-plugin-top';

export default [
  {
    plugins: {top},
    rules: {
      'top/no-top-level-side-effects': 'error',
      'top/no-top-level-state': 'error',
      'top/no-top-level-variables': 'error'
    }
  }
];

Note that the rule prefix (top in the example) must match the name of the key used in the plugins object.

Legacy Config (before ESLint v9)

First, add @ericcornelissen/top to the plugins section of your .eslintrc configuration file. You must omit the eslint-plugin- infix:

plugins:
  - '@ericcornelissen/top'

Then, configure the rules you want to use in the rules section:

rules:
  '@ericcornelissen/top/no-top-level-side-effects': error
  '@ericcornelissen/top/no-top-level-state': error
  '@ericcornelissen/top/no-top-level-variables': error

Supported Rules

• no-top-level-side-effects
• no-top-level-state
• no-top-level-variables

Preset Configurations

• recommended: disallow top level variables while allowing mutable values and disallows top level side effects except for creating things like Symbols.
• strict: disallow all top level variables and side effects except for importing other files.

Please open an issue if you found a mistake or if you have a suggestion for how to improve the documentation.