Eslint-plugin-consistent-subscribe NPM

eslint-plugin-consistent-subscribe

ESLint rule, checking pairing subscriptions

Installation

You'll first need to install ESLint:

$ npm i eslint --save-dev

Next, install eslint-plugin-consistent-subscribe:

$ npm install eslint-plugin-consistent-subscribe --save-dev

Note: If you installed ESLint globally (using the -g flag) then you must also install eslint-plugin-consistent-subscribe globally.

Usage

Add consistent-subscribe to the plugins section of your .eslintrc configuration file. You can omit the eslint-plugin- prefix:

{
    "plugins": [
        "consistent-subscribe"
    ]
}

Then configure the rules you want to use under the rules section.

{
    "rules": {
        "consistent-subscribe/consistent-subscribe": 2
    }
}

Supported Rules

consistent-subscribe

Rule Details

This rule aims to...\ Examples of incorrect code for this rule:

$('body').on('click', onClick);
// subscribe, without unsubscribe

Examples of correct code for this rule:

$('body').on('click', onClick);
setTimeout(() => {
  $('body').off('click', onClick);
}, 1000);

Options

This rule takes a list of objects, where each object describes a separate API subscription.\ Default value is:

/* eslint-enable consistent-subscribe/consistent-subscribe: [2, {open: 'addEventListener', close: 'removeEventListener'}, {open: 'on',close: 'off'}, {open: 'subscribe',close: 'unsubscribe'}] */

open name of subscribe method, i.e. on/subscribe/addEventListener
close name of unsubscribe method, i.e. off/unsubscribe/removeEventListener

contextEquality. default true - need check, that listened object strict equal The following patterns are not warnings:

/* eslint-enable consistent-subscribe/consistent-subscribe: [2, {open: 'on',close: 'off', contextEquality: false}] */
$('body').on('click', onClick);
$(document.body).off('click', onClick);

openArgumentsEquality/closeArgumentsEquality. default true - arguments should strict equal\ If need check not all arguments, this is array of indexed arguments for check\

The following patterns are considered warnings:
```js
/* eslint-enable consistent-subscribe/consistent-subscribe: [2, {open: 'on',close: 'off', openArgumentsEquality: true, closeArgumentsEquality: true}] */
$('body').on('click', onClick);
$('body').off('click');//missing handler argument
```

The following patterns are not warnings:
```js
/* eslint-enable consistent-subscribe/consistent-subscribe: [2, {open: 'on',close: 'off', openArgumentsEquality: [0], closeArgumentsEquality: [0]}] */
$('body').on('click', onClick);
$('body').off('click');//missing handler argument, but it's OK, because checked only first argument
```