root 3bf41bf355 update | hai 1 ano | |
---|---|---|
.. | ||
configs | hai 1 ano | |
node_modules | hai 1 ano | |
rules | hai 1 ano | |
index.js | hai 1 ano | |
license | hai 1 ano | |
package.json | hai 1 ano | |
readme.md | hai 1 ano |
More than 100 powerful ESLint rules
You might want to check out XO, which includes this plugin.
Propose or contribute a new rule โก
npm install --save-dev eslint eslint-plugin-unicorn
Use a preset config or configure each rule in package.json
.
If you don't use the preset, ensure you use the same env
and parserOptions
config as below.
{
"name": "my-awesome-project",
"eslintConfig": {
"env": {
"es2022": true
},
"parserOptions": {
"ecmaVersion": "latest",
"sourceType": "module"
},
"plugins": [
"unicorn"
],
"rules": {
"unicorn/better-regex": "error",
"unicorn/โฆ": "error"
}
}
}
๐ผ Configurations enabled in.\
๐ซ Configurations disabled in.\
โ
Set in the recommended
configuration.\
๐ง Automatically fixable by the --fix
CLI option.\
๐ก Manually fixable by editor suggestions.
| Nameย ย ย ย ย ย ย ย ย ย ย ย ย ย ย ย ย ย ย ย ย ย ย ย ย ย ย ย ย ย ย ย ย ย ย | Description | ๐ผ | ๐ซ | ๐ง | ๐ก |
| :----------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :- | :- | :- | :- |
| better-regex | Improve regexes by making them shorter, consistent, and safer. | โ
| | ๐ง | |
| catch-error-name | Enforce a specific parameter name in catch clauses. | โ
| | ๐ง | |
| consistent-destructuring | Use destructured variables over properties. | โ
| | ๐ง | ๐ก |
| consistent-function-scoping | Move function definitions to the highest possible scope. | โ
| | | |
| custom-error-definition | Enforce correct Error
subclassing. | | โ
| ๐ง | |
| empty-brace-spaces | Enforce no spaces between braces. | โ
| | ๐ง | |
| error-message | Enforce passing a message
value when creating a built-in error. | โ
| | | |
| escape-case | Require escape sequences to use uppercase values. | โ
| | ๐ง | |
| expiring-todo-comments | Add expiration conditions to TODO comments. | โ
| | | |
| explicit-length-check | Enforce explicitly comparing the length
or size
property of a value. | โ
| | ๐ง | ๐ก |
| filename-case | Enforce a case style for filenames. | โ
| | | |
| import-style | Enforce specific import styles per module. | โ
| | | |
| new-for-builtins | Enforce the use of new
for all builtins, except String
, Number
, Boolean
, Symbol
and BigInt
. | โ
| | ๐ง | |
| no-abusive-eslint-disable | Enforce specifying rules to disable in eslint-disable
comments. | โ
| | | |
| no-array-callback-reference | Prevent passing a function reference directly to iterator methods. | โ
| | | ๐ก |
| no-array-for-each | Prefer forโฆof
over the forEach
method. | โ
| | ๐ง | ๐ก |
| no-array-method-this-argument | Disallow using the this
argument in array methods. | โ
| | ๐ง | ๐ก |
| no-array-push-push | Enforce combining multiple Array#push()
into one call. | โ
| | ๐ง | ๐ก |
| no-array-reduce | Disallow Array#reduce()
and Array#reduceRight()
. | โ
| | | |
| no-await-expression-member | Disallow member access from await expression. | โ
| | ๐ง | |
| no-console-spaces | Do not use leading/trailing space between console.log
parameters. | โ
| | ๐ง | |
| no-document-cookie | Do not use document.cookie
directly. | โ
| | | |
| no-empty-file | Disallow empty files. | โ
| | | |
| no-for-loop | Do not use a for
loop that can be replaced with a for-of
loop. | โ
| | ๐ง | |
| no-hex-escape | Enforce the use of Unicode escapes instead of hexadecimal escapes. | โ
| | ๐ง | |
| no-instanceof-array | Require Array.isArray()
instead of instanceof Array
. | โ
| | ๐ง | |
| no-invalid-remove-event-listener | Prevent calling EventTarget#removeEventListener()
with the result of an expression. | โ
| | | |
| no-keyword-prefix | Disallow identifiers starting with new
or class
. | | โ
| | |
| no-lonely-if | Disallow if
statements as the only statement in if
blocks without else
. | โ
| | ๐ง | |
| no-negated-condition | Disallow negated conditions. | โ
| | ๐ง | |
| no-nested-ternary | Disallow nested ternary expressions. | โ
| | ๐ง | |
| no-new-array | Disallow new Array()
. | โ
| | ๐ง | ๐ก |
| no-new-buffer | Enforce the use of Buffer.from()
and Buffer.alloc()
instead of the deprecated new Buffer()
. | โ
| | ๐ง | ๐ก |
| no-null | Disallow the use of the null
literal. | โ
| | ๐ง | ๐ก |
| no-object-as-default-parameter | Disallow the use of objects as default parameters. | โ
| | | |
| no-process-exit | Disallow process.exit()
. | โ
| | | |
| no-static-only-class | Disallow classes that only have static members. | โ
| | ๐ง | |
| no-thenable | Disallow then
property. | โ
| | | |
| no-this-assignment | Disallow assigning this
to a variable. | โ
| | | |
| no-typeof-undefined | Disallow comparing undefined
using typeof
. | โ
| | ๐ง | ๐ก |
| no-unnecessary-await | Disallow awaiting non-promise values. | โ
| | ๐ง | |
| no-unreadable-array-destructuring | Disallow unreadable array destructuring. | โ
| | ๐ง | |
| no-unreadable-iife | Disallow unreadable IIFEs. | โ
| | | |
| no-unsafe-regex | Disallow unsafe regular expressions. | | โ
| | |
| no-unused-properties | Disallow unused object properties. | | โ
| | |
| no-useless-fallback-in-spread | Disallow useless fallback when spreading in object literals. | โ
| | ๐ง | |
| no-useless-length-check | Disallow useless array length check. | โ
| | ๐ง | |
| no-useless-promise-resolve-reject | Disallow returning/yielding Promise.resolve/reject()
in async functions or promise callbacks | โ
| | ๐ง | |
| no-useless-spread | Disallow unnecessary spread. | โ
| | ๐ง | |
| no-useless-switch-case | Disallow useless case in switch statements. | โ
| | | ๐ก |
| no-useless-undefined | Disallow useless undefined
. | โ
| | ๐ง | |
| no-zero-fractions | Disallow number literals with zero fractions or dangling dots. | โ
| | ๐ง | |
| number-literal-case | Enforce proper case for numeric literals. | โ
| | ๐ง | |
| numeric-separators-style | Enforce the style of numeric separators by correctly grouping digits. | โ
| | ๐ง | |
| prefer-add-event-listener | Prefer .addEventListener()
and .removeEventListener()
over on
-functions. | โ
| | ๐ง | |
| prefer-array-find | Prefer .find(โฆ)
and .findLast(โฆ)
over the first or last element from .filter(โฆ)
. | โ
| | ๐ง | ๐ก |
| prefer-array-flat | Prefer Array#flat()
over legacy techniques to flatten arrays. | โ
| | ๐ง | |
| prefer-array-flat-map | Prefer .flatMap(โฆ)
over .map(โฆ).flat()
. | โ
| | ๐ง | |
| prefer-array-index-of | Prefer Array#{indexOf,lastIndexOf}()
over Array#{findIndex,findLastIndex}()
when looking for the index of an item. | โ
| | ๐ง | ๐ก |
| prefer-array-some | Prefer .some(โฆ)
over .filter(โฆ).length
check and .{find,findLast}(โฆ)
. | โ
| | ๐ง | ๐ก |
| prefer-at | Prefer .at()
method for index access and String#charAt()
. | | โ
| ๐ง | ๐ก |
| prefer-code-point | Prefer String#codePointAt(โฆ)
over String#charCodeAt(โฆ)
and String.fromCodePoint(โฆ)
over String.fromCharCode(โฆ)
. | โ
| | | ๐ก |
| prefer-date-now | Prefer Date.now()
to get the number of milliseconds since the Unix Epoch. | โ
| | ๐ง | |
| prefer-default-parameters | Prefer default parameters over reassignment. | โ
| | ๐ง | ๐ก |
| prefer-dom-node-append | Prefer Node#append()
over Node#appendChild()
. | โ
| | ๐ง | |
| prefer-dom-node-dataset | Prefer using .dataset
on DOM elements over calling attribute methods. | โ
| | ๐ง | |
| prefer-dom-node-remove | Prefer childNode.remove()
over parentNode.removeChild(childNode)
. | โ
| | ๐ง | ๐ก |
| prefer-dom-node-text-content | Prefer .textContent
over .innerText
. | โ
| | | ๐ก |
| prefer-event-target | Prefer EventTarget
over EventEmitter
. | | โ
| | |
| prefer-export-from | Prefer exportโฆfrom
when re-exporting. | โ
| | ๐ง | ๐ก |
| prefer-includes | Prefer .includes()
over .indexOf()
and Array#some()
when checking for existence or non-existence. | โ
| | ๐ง | ๐ก |
| prefer-json-parse-buffer | Prefer reading a JSON file as a buffer. | | โ
| ๐ง | |
| prefer-keyboard-event-key | Prefer KeyboardEvent#key
over KeyboardEvent#keyCode
. | โ
| | ๐ง | |
| prefer-logical-operator-over-ternary | Prefer using a logical operator over a ternary. | โ
| | | ๐ก |
| prefer-math-trunc | Enforce the use of Math.trunc
instead of bitwise operators. | โ
| | ๐ง | ๐ก |
| prefer-modern-dom-apis | Prefer .before()
over .insertBefore()
, .replaceWith()
over .replaceChild()
, prefer one of .before()
, .after()
, .append()
or .prepend()
over insertAdjacentText()
and insertAdjacentElement()
. | โ
| | ๐ง | |
| prefer-modern-math-apis | Prefer modern Math
APIs over legacy patterns. | โ
| | ๐ง | |
| prefer-module | Prefer JavaScript modules (ESM) over CommonJS. | โ
| | ๐ง | ๐ก |
| prefer-native-coercion-functions | Prefer using String
, Number
, BigInt
, Boolean
, and Symbol
directly. | โ
| | ๐ง | |
| prefer-negative-index | Prefer negative index over .length - index
for {String,Array,TypedArray}#{slice,at}()
and Array#splice()
. | โ
| | ๐ง | |
| prefer-node-protocol | Prefer using the node:
protocol when importing Node.js builtin modules. | โ
| | ๐ง | |
| prefer-number-properties | Prefer Number
static properties over global ones. | โ
| | ๐ง | ๐ก |
| prefer-object-from-entries | Prefer using Object.fromEntries(โฆ)
to transform a list of key-value pairs into an object. | โ
| | ๐ง | |
| prefer-optional-catch-binding | Prefer omitting the catch
binding parameter. | โ
| | ๐ง | |
| prefer-prototype-methods | Prefer borrowing methods from the prototype instead of the instance. | โ
| | ๐ง | |
| prefer-query-selector | Prefer .querySelector()
over .getElementById()
, .querySelectorAll()
over .getElementsByClassName()
and .getElementsByTagName()
. | โ
| | ๐ง | |
| prefer-reflect-apply | Prefer Reflect.apply()
over Function#apply()
. | โ
| | ๐ง | |
| prefer-regexp-test | Prefer RegExp#test()
over String#match()
and RegExp#exec()
. | โ
| | ๐ง | ๐ก |
| prefer-set-has | Prefer Set#has()
over Array#includes()
when checking for existence or non-existence. | โ
| | ๐ง | ๐ก |
| prefer-set-size | Prefer using Set#size
instead of Array#length
. | โ
| | ๐ง | |
| prefer-spread | Prefer the spread operator over Array.from(โฆ)
, Array#concat(โฆ)
, Array#slice()
and String#split('')
. | โ
| | ๐ง | ๐ก |
| prefer-string-replace-all | Prefer String#replaceAll()
over regex searches with the global flag. | | โ
| ๐ง | |
| prefer-string-slice | Prefer String#slice()
over String#substr()
and String#substring()
. | โ
| | ๐ง | |
| prefer-string-starts-ends-with | Prefer String#startsWith()
& String#endsWith()
over RegExp#test()
. | โ
| | ๐ง | ๐ก |
| prefer-string-trim-start-end | Prefer String#trimStart()
/ String#trimEnd()
over String#trimLeft()
/ String#trimRight()
. | โ
| | ๐ง | |
| prefer-switch | Prefer switch
over multiple else-if
. | โ
| | ๐ง | |
| prefer-ternary | Prefer ternary expressions over simple if-else
statements. | โ
| | ๐ง | |
| prefer-top-level-await | Prefer top-level await over top-level promises and async function calls. | โ
| | | ๐ก |
| prefer-type-error | Enforce throwing TypeError
in type checking conditions. | โ
| | ๐ง | |
| prevent-abbreviations | Prevent abbreviations. | โ
| | ๐ง | |
| relative-url-style | Enforce consistent relative URL style. | โ
| | ๐ง | ๐ก |
| require-array-join-separator | Enforce using the separator argument with Array#join()
. | โ
| | ๐ง | |
| require-number-to-fixed-digits-argument | Enforce using the digits argument with Number#toFixed()
. | โ
| | ๐ง | |
| require-post-message-target-origin | Enforce using the targetOrigin
argument with window.postMessage()
. | | โ
| | ๐ก |
| string-content | Enforce better string content. | | โ
| ๐ง | ๐ก |
| switch-case-braces | Enforce consistent brace style for case
clauses. | โ
| | ๐ง | |
| template-indent | Fix whitespace-insensitive template indentation. | โ
| | ๐ง | |
| text-encoding-identifier-case | Enforce consistent case for text encoding identifiers. | โ
| | ๐ง | ๐ก |
| throw-new-error | Require new
when throwing an error. | โ
| | ๐ง | |
See the ESLint docs for more information about extending config files.
Note: Preset configs will also enable the correct parser options and environment.
This plugin exports a recommended
config that enforces good practices.
{
"name": "my-awesome-project",
"eslintConfig": {
"extends": "plugin:unicorn/recommended"
}
}
This plugin exports an all
config that makes use of all rules (except for deprecated ones).
{
"name": "my-awesome-project",
"eslintConfig": {
"extends": "plugin:unicorn/all"
}
}