Skip to content
This repository has been archived by the owner on Feb 21, 2022. It is now read-only.

buzinas/tslint-eslint-rules

Repository files navigation

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

DEPRECATED

I originally created this project because it was impossible to run ESLint on a TypeScript codebase. Today you can use https://github.com/typescript-eslint/typescript-eslint for that purpose, so this project is unmaintained and deprecated.

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