eslint-plugin-consistent-subscribe
v1.4.0
Published
ESLint rule, checking pairing subscriptions
Downloads
3
Maintainers
Readme
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:
/* 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:
/* 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
Author
© 2016 Viktor Gvozdev [email protected] and contributors.
License
Released under the MIT license.