/tslint-eslint-rules

Improve your TSLint with the missing ESLint rules

Primary LanguageTypeScriptMIT LicenseMIT

Build Status Downloads per Month NPM Version ZenHub Shields.io License

ESLint rules for TSLint

Improve your TSLint with the missing ESLint Rules

You want to code in TypeScript but miss all the rules available in ESLint?

Now you can combine both worlds by using this TSLint plugin!

Usage

Install from NPM to your Dev Dependencies

npm install --save-dev tslint-eslint-rules

Or install from Yarn to your Dev Dependencies

yarn add tslint-eslint-rules --dev

Configure TSLint to use tslint-eslint-rules:

In your tslint.json file, source the rules from this package, e.g:

{
  "rules": {
    "no-constant-condition": true
  },
  "rulesDirectory": [
    "node_modules/tslint-eslint-rules/dist/rules"
  ]
}

You can also add other tslint config packages to combine these rules with other custom community rules.

Configure your rules

In your tslint.json file, insert the rules as described below.

Rules (copied from the ESLint website)

The following tables shows all the existing ESLint rules and the similar rules available in TSLint. Please refer to the following icons as they provide the status of the rule.

Icon Description
🚫 The rule is not applicable to Typescript.
β˜‘οΈ The rule is provided natively by TSLint.
βœ… The rule is available via tslint-eslint-rules.
❌ The rule is currently unavailable.

Possible Errors

The following rules point out areas where you might have made mistakes.

❔ ESLint TSLint Description
β˜‘οΈ comma-dangle trailing-comma disallow or enforce trailing commas (recommended)
β˜‘οΈ no-cond-assign no-conditional-assignment disallow assignment in conditional expressions (recommended)
β˜‘οΈ no-console no-console disallow use of console in the node environment (recommended)
βœ… no-constant-condition no-constant-condition disallow use of constant expressions in conditions (recommended)
βœ… no-control-regex no-control-regex disallow control characters in regular expressions (recommended)
β˜‘οΈ no-debugger no-debugger disallow use of debugger (recommended)
🚫 no-dupe-args Not applicable disallow duplicate arguments in functions (recommended)
🚫 no-dupe-keys Not applicable disallow duplicate keys when creating object literals (recommended)
βœ… no-duplicate-case no-duplicate-case disallow a duplicate case label. (recommended)
β˜‘οΈ no-empty no-empty disallow empty statements (recommended)
βœ… no-empty-character-class no-empty-character-class disallow the use of empty character classes in regular expressions (recommended)
βœ… no-ex-assign no-ex-assign disallow assigning to the exception in a catch block (recommended)
βœ… no-extra-boolean-cast no-extra-boolean-cast disallow double-negation boolean casts in a boolean context (recommended)
❌ no-extra-parens no-extra-parens disallow unnecessary parentheses
βœ… no-extra-semi no-extra-semi disallow unnecessary semicolons (recommended)
🚫 no-func-assign Not applicable disallow overwriting functions written as function declarations (recommended)
βœ… no-inner-declarations no-inner-declarations disallow function or variable declarations in nested blocks (recommended)
βœ… no-invalid-regexp no-invalid-regexp disallow invalid regular expression strings in the RegExp constructor (recommended)
βœ… no-irregular-whitespace ter-no-irregular-whitespace disallow irregular whitespace (recommended)
🚫 no-negated-in-lhs Not applicable disallow negation of the left operand of an in expression (recommended)
🚫 no-obj-calls Not applicable disallow the use of object properties of the global object (Math and JSON) as functions (recommended)
βœ… no-regex-spaces no-regex-spaces disallow multiple spaces in a regular expression literal (recommended)
βœ… no-sparse-arrays ter-no-sparse-arrays disallow sparse arrays (recommended)
βœ… no-unexpected-multiline no-unexpected-multiline Avoid code that looks like two expressions but is actually one
🚫 no-unreachable Not applicable disallow unreachable statements after a return, throw, continue, or break statement (recommended)
β˜‘οΈ no-unsafe-finally no-unsafe-finally disallow control flow statements in finally blocks (recommended)
β˜‘οΈ use-isnan use-isnan disallow comparisons with the value NaN (recommended)
βœ… valid-jsdoc valid-jsdoc enforce valid JSDoc comments
βœ… valid-typeof valid-typeof Ensure that the results of typeof are compared against a valid string (recommended)

Best Practices

These are rules designed to prevent you from making mistakes. They either prescribe a better way of doing something or help you avoid footguns.

❔ ESLint TSLint Description
❌ accessor-pairs accessor-pairs Enforces getter/setter pairs in objects
❌ array-callback-return array-callback-return Enforce return statements in callbacks of array’s methods
❌ block-scoped-var block-scoped-var treat var statements as if they were block scoped
β˜‘οΈ complexity cyclomatic-complexity specify the maximum cyclomatic complexity allowed in a program
❌ consistent-return consistent-return require return statements to either always or never specify values
β˜‘οΈ curly curly specify curly brace conventions for all control statements
β˜‘οΈ default-case switch-default require default case in switch statements
❌ dot-location dot-location enforces consistent newlines before or after dots
❌ dot-notation dot-notation encourages use of dot notation whenever possible
β˜‘οΈ eqeqeq triple-equals require the use of === and !==
β˜‘οΈ guard-for-in forin make sure for-in loops have an if statement
β˜‘οΈ no-alert ban disallow the use of alert, confirm, and prompt
can be achieved using the "ban": [true, ["alert"]] tslint rule
β˜‘οΈ no-caller no-arg disallow use of arguments.caller or arguments.callee
❌ no-case-declarations no-case-declarations disallow lexical declarations in case clauses
❌ no-div-regex no-div-regex disallow division operators explicitly at beginning of regular expression
❌ no-else-return no-else-return disallow else after a return in an if
β˜‘οΈ no-empty-function no-empty disallow use of empty functions
❌ no-empty-pattern no-empty-pattern disallow use of empty destructuring patterns
❌ no-eq-null no-eq-null disallow comparisons to null without a type-checking operator
β˜‘οΈ no-eval no-eval disallow use of eval()
❌ no-extend-native no-extend-native disallow adding to native types
❌ no-extra-bind no-extra-bind disallow unnecessary function binding
❌ no-extra-label no-extra-label disallow unnecessary labels
β˜‘οΈ no-fallthrough no-switch-case-fall-through disallow fallthrough of case statements (recommended)
❌ no-floating-decimal no-floating-decimal disallow the use of leading or trailing decimal points in numeric literals
❌ no-implicit-coercion no-implicit-coercion disallow the type conversions with shorter notations
❌ no-implicit-globals no-implicit-globals disallow var and named functions in global scope
❌ no-implied-eval no-implied-eval disallow use of eval()-like methods
β˜‘οΈ no-invalid-this no-invalid-this disallow this keywords outside of classes or class-like objects
❌ no-iterator no-iterator disallow Usage of __iterator__ property
β˜‘οΈ no-labels label-position disallow use of labeled statements
❌ no-lone-blocks no-lone-blocks disallow unnecessary nested blocks
❌ no-loop-func no-loop-func disallow creation of functions within loops
β˜‘οΈ no-magic-numbers no-magic-numbers disallow the use of magic numbers
βœ… no-multi-spaces no-multi-spaces disallow use of multiple spaces
❌ no-multi-str no-multi-str disallow use of multiline strings
🚫 no-native-reassign Not applicable disallow reassignments of native objects
β˜‘οΈ no-new no-unused-expression disallow use of the new operator when not part of an assignment or comparison
❌ no-new-func no-new-func disallow use of new operator for Function object
β˜‘οΈ no-new-wrappers no-construct disallows creating new instances of String,Number, and Boolean
🚫 no-octal Not applicable disallow use of octal literals (recommended)
❌ no-octal-escape no-octal-escape disallow use of octal escape sequences in string literals, such as var foo = "Copyright \251";
❌ no-param-reassign no-param-reassign disallow reassignment of function parameters
βœ… no-proto ter-no-proto disallow the use of __proto__ property
β˜‘οΈ no-redeclare no-duplicate-variable disallow declaring the same variable more than once (http://eslint.org/docs/rules/recommended)
❌ no-return-assign no-return-assign disallow use of assignment in return statement
βœ… no-script-url ter-no-script-url disallow use of javascript: urls.
❌ no-self-assign no-self-assign disallow assignments where both sides are exactly the same
βœ… no-self-compare ter-no-self-compare disallow comparisons where both sides are exactly the same
❌ no-sequences no-sequences disallow use of the comma operator
β˜‘οΈ no-throw-literal no-string-throw restrict what can be thrown as an exception
❌ no-unmodified-loop-condition no-unmodified-loop-condition disallow unmodified conditions of loops
β˜‘οΈ no-unused-expressions no-unused-expression disallow Usage of expressions in statement position
❌ no-unused-labels no-unused-labels disallow unused labels
❌ no-useless-call no-useless-call disallow unnecessary .call() and .apply()
❌ no-useless-concat no-useless-concat disallow unnecessary concatenation of literals or template literals
❌ no-useless-escape no-useless-escape disallow unnecessary usage of escape character
❌ no-void no-void disallow use of the void operator
❌ no-warning-comments no-warning-comments disallow Usage of configurable warning terms in comments e.g. TODO or FIXME
❌ no-with no-with disallow use of the with statement
β˜‘οΈ radix radix require use of the second argument for parseInt()
❌ vars-on-top vars-on-top require declaration of all vars at the top of their containing scope
❌ wrap-iife wrap-iife require immediate function invocation to be wrapped in parentheses
β˜‘οΈ yoda binary-expression-operand-order disallow Yoda conditions

Strict Mode

These rules relate to using strict mode.

❔ ESLint TSLint Description
🚫 strict Not applicable require effective use of strict mode directives

Variables

These rules have to do with variable declarations.

❔ ESLint TSLint Description
❌ init-declarations init-declarations enforce or disallow variable initializations at definition
❌ no-catch-shadow no-catch-shadow disallow the catch clause parameter name being the same as a variable in the outer scope
🚫 no-delete-var Not applicable disallow deletion of variables (recommended)
❌ no-label-var no-label-var disallow labels that share a name with a variable
β˜‘οΈ no-shadow no-shadowed-variable disallow declaration of variables already declared in the outer scope
❌ no-shadow-restricted-names no-shadow-restricted-names disallow shadowing of names such as arguments
🚫 no-undef Not applicable disallow use of undeclared variables unless mentioned in a /*global */ block (recommended)
❌ no-undef-init no-undef-init disallow use of undefined when initializing variables
❌ no-undefined no-undefined disallow use of undefined variable
β˜‘οΈ no-unused-vars no-unused-variable disallow unused variables (recommended).
β˜‘οΈ no-use-before-define no-use-before-declare disallow use of variables before they are defined

Node.js and CommonJS

These rules are specific to JavaScript running on Node.js or using CommonJS in the browser.

❔ ESLint TSLint Description
❌ callback-return callback-return enforce return after a callback
❌ global-require global-require enforce require() on top-level module scope
βœ… handle-callback-err handle-callback-err enforce error handling in callbacks
❌ no-mixed-requires no-mixed-requires disallow mixing regular variable and require declarations
❌ no-new-require no-new-require disallow use of new operator with the require function
❌ no-path-concat no-path-concat disallow string concatenation with __dirname and __filename
❌ no-process-env no-process-env disallow use of process.env
❌ no-process-exit no-process-exit disallow process.exit()
❌ no-restricted-modules no-restricted-modules restrict Usage of specified node modules
❌ no-sync no-sync disallow use of synchronous methods

Stylistic Issues

These rules are purely matters of style and are quite subjective.

❔ ESLint TSLint Description
βœ… array-bracket-spacing array-bracket-spacing enforce consistent spacing inside array brackets
βœ… block-spacing block-spacing disallow or enforce spaces inside of single line blocks
βœ… brace-style brace-style enforce one true brace style
β˜‘οΈ camelcase variable-name require camel case names
❌ comma-spacing comma-spacing enforce spacing before and after comma
❌ comma-style comma-style enforce one true comma style
βœ… computed-property-spacing ter-computed-property-spacing require or disallow padding inside computed properties
❌ consistent-this consistent-this enforce consistent naming when capturing the current execution context
β˜‘οΈ eol-last eofline enforce newline at the end of file, with no multiple empty lines
βœ… func-call-spacing ter-func-call-spacing require or disallow spacing between function identifiers and their invocations
❌ func-names func-names require function expressions to have a name
❌ func-style func-style enforce use of function declarations or expressions
❌ id-blacklist id-blacklist disallow certain identifiers to prevent them being used
❌ id-length id-length this option enforces minimum and maximum identifier lengths (variable names, property names etc.)
❌ id-match id-match require identifiers to match the provided regular expression
βœ… indent ter-indent enforce consistent indentation
❌ jsx-quotes jsx-quotes specify whether double or single quotes should be used in JSX attributes
❌ key-spacing key-spacing enforce spacing between keys and values in object literal properties
Tslint's whitespace can partially be used
❌ keyword-spacing keyword-spacing enforce spacing before and after keywords
Tslint's whitespace can partially be used
β˜‘οΈ linebreak-style linebreak-style disallow mixed 'LF' and 'CRLF' as linebreaks
❌ lines-around-comment lines-around-comment enforce empty lines around comments
❌ max-depth max-depth specify the maximum depth that blocks can be nested
βœ… max-len ter-max-len enforce a maximum line length
β˜‘οΈ max-lines max-file-line-count enforce a maximum number of lines per file
❌ max-nested-callbacks max-nested-callbacks specify the maximum depth callbacks can be nested
❌ max-params max-params specify the number of parameters that can be used in the function declaration
❌ max-statements max-statements specify the maximum number of statement allowed in a function
❌ max-statements-per-line max-statements-per-line specify the maximum number of statements allowed per line
🚫 new-cap Not applicable require a capital letter for constructors
β˜‘οΈ new-parens new-parens disallow the omission of parentheses when invoking a constructor with no arguments
βœ… newline-after-var ter-newline-after-var require or disallow an empty newline after variable declarations
❌ newline-before-return newline-before-return require newline before return statement
❌ newline-per-chained-call newline-per-chained-call enforce newline after each call when chaining the calls
❌ no-array-constructor no-array-constructor disallow use of the Array constructor
β˜‘οΈ no-bitwise no-bitwise disallows bitwise operators
❌ no-continue no-continue disallow use of the continue statement
❌ no-inline-comments no-inline-comments disallow comments inline after code
❌ no-lonely-if no-lonely-if disallow if as the only statement in an else block
βœ… no-mixed-spaces-and-tabs ter-no-mixed-spaces-and-tabs disallow mixed spaces and tabs for indentation (recommended)
β˜‘οΈ no-multiple-empty-lines no-consecutive-blank-lines disallow multiple empty lines
❌ no-negated-condition no-negated-condition disallow negated conditions
❌ no-nested-ternary no-nested-ternary disallow nested ternary expressions
❌ no-new-object no-new-object disallow the use of the Object constructor
❌ no-restricted-syntax no-restricted-syntax disallow use of certain syntax in code
❌ no-spaced-func no-spaced-func disallow space between function identifier and application
❌ no-ternary no-ternary disallow the use of ternary operators
β˜‘οΈ no-trailing-spaces no-trailing-whitespace disallow trailing whitespace at the end of lines
❌ no-underscore-dangle no-underscore-dangle disallow dangling underscores in identifiers
❌ no-unneeded-ternary no-unneeded-ternary disallow the use of ternary operators when a simpler alternative exists
❌ no-whitespace-before-property no-whitespace-before-property disallow whitespace before properties
βœ… object-curly-spacing object-curly-spacing require or disallow padding inside curly braces
β˜‘οΈ one-var one-variable-per-declaration require or disallow one variable declaration per function
❌ one-var-declaration-per-line one-var-declaration-per-line require or disallow a newline around variable declarations
❌ operator-assignment operator-assignment require assignment operator shorthand where possible or prohibit it entirely
❌ operator-linebreak operator-linebreak enforce operators to be placed before or after line breaks
βœ… padded-blocks ter-padded-blocks enforce padding within blocks
β˜‘οΈ quote-props object-literal-key-quotes require quotes around object literal property names
β˜‘οΈ quotes quotemark specify whether backticks, double or single quotes should be used
❌ require-jsdoc require-jsdoc Require JSDoc comment
β˜‘οΈ semi semicolon require or disallow use of semicolons instead of ASI
❌ semi-spacing semi-spacing enforce spacing before and after semicolons
βœ… sort-imports sort-imports enforce sorting import declarations within module
❌ sort-vars sort-vars sort variables within the same declaration block
❌ space-before-blocks space-before-blocks require or disallow a space before blocks
❌ space-before-function-paren space-before-function-paren require or disallow a space before function opening parenthesis
βœ… space-in-parens space-in-parens require or disallow spaces inside parentheses
❌ space-infix-ops space-infix-ops require spaces around operators
Tslint's whitespace can partially be used
❌ space-unary-ops space-unary-ops require or disallow spaces before/after unary operators
β˜‘οΈ spaced-comment comment-format require or disallow a space immediately following the // or /* in a comment
❌ wrap-regex wrap-regex require regex literals to be wrapped in parentheses
βœ… no-tabs ter-no-tabs disallow all tabs

ECMAScript 6

These rules are only relevant to ES6 environments.

❔ ESLint TSLint Description
βœ… arrow-body-style ter-arrow-body-style require braces in arrow function body
βœ… arrow-parens ter-arrow-parens require parens in arrow function arguments
βœ… arrow-spacing ter-arrow-spacing require space before/after arrow function's arrow
🚫 constructor-super Not applicable verify calls of super() in constructors
❌ generator-star-spacing generator-star-spacing enforce spacing around the * in generator functions
❌ no-class-assign no-class-assign disallow modifying variables of class declarations
❌ no-confusing-arrow no-confusing-arrow disallow arrow functions where they could be confused with comparisons
🚫 no-const-assign Not applicable disallow modifying variables that are declared using const
🚫 no-dupe-class-members Not applicable disallow duplicate name in class members
❌ no-duplicate-imports no-duplicate-imports disallow duplicate module imports
❌ no-new-symbol no-new-symbol disallow use of the new operator with the Symbol object
❌ no-restricted-imports no-restricted-imports restrict usage of specified modules when loaded by import declaration
🚫 no-this-before-super Not applicable disallow use of this/super before calling super() in constructors.
❌ no-useless-constructor no-useless-constructor disallow unnecessary constructor
β˜‘οΈ no-var no-var-keyword require let or const instead of var
β˜‘οΈ object-shorthand object-literal-shorthand require method and property shorthand syntax for object literals
βœ… prefer-arrow-callback ter-prefer-arrow-callback require arrow functions as callbacks
β˜‘οΈ prefer-const prefer-const suggest using const declaration for variables that are never modified after declared
❌ prefer-destructuring prefer-destructuring require using destructuring when assigning to variables from arrays and objects
❌ prefer-reflect prefer-reflect suggest using Reflect methods where applicable
❌ prefer-rest-params prefer-rest-params suggest using the rest parameters instead of arguments
❌ prefer-spread prefer-spread suggest using the spread operator instead of .apply().
❌ prefer-template prefer-template suggest using template literals instead of strings concatenation
❌ require-yield require-yield disallow generator functions that do not have yield
❌ template-curly-spacing template-curly-spacing enforce spacing around embedded expressions of template strings
❌ yield-star-spacing yield-star-spacing enforce spacing around the * in yield* expressions

Contributing

Bugs, rules requests, doubts etc., open a Github Issue. If you want to create one of the missing rules or fix/improve some existing rule please check out the contribution guide.

LICENSE

MIT