ROADMAP.md

Roadmap

TSLint rules

✅ = done
🌟 = in ESLint core
🔌 = in another plugin
🛑 = unimplemented
◐ = implementations differ or ESLint version is missing functionality

TypeScript-specific

TSLint rule		ESLint rule
adjacent-overload-signatures	✅	typescript/adjacent-overload-signatures
ban-types	✅	typescript/ban-types
member-access	✅	typescript/explicit-member-accessibility
member-ordering	✅	typescript/member-ordering
no-any	✅	typescript/no-explicit-any
no-empty-interface	✅	typescript/no-empty-interface
no-import-side-effect	🔌	import/no-unassigned-import
no-inferrable-types	✅	typescript/no-inferrable-types
no-internal-module	✅	typescript/prefer-namespace-keyword
no-magic-numbers	🌟	no-magic-numbers
no-namespace	✅	typescript/no-namespace
no-non-null-assertion	✅	typescript/no-non-null-assertion
no-parameter-reassignment	✅	no-param-reassign
no-reference	✅	typescript/no-triple-slash-reference
no-unnecessary-type-assertion	🛑	N/A
no-var-requires	✅	typescript/no-var-requires
only-arrow-functions	🔌	prefer-arrow/prefer-arrow-functions
prefer-for-of	🛑	N/A
promise-function-async	🛑	N/A (relevant plugin)
typedef	🛑	N/A
typedef-whitespace	✅	typescript/type-annotation-spacing
unified-signatures	🛑	N/A

Functionality

TSLint rule		ESLint rule
await-promise	🛑	N/A
ban-comma-operator	🌟	no-sequences
ban	🌟	no-restricted-properties
curly	🌟	curly
forin	🌟	guard-for-in
import-blacklist	🌟	no-restricted-imports
label-position	🌟	no-unused-labels (similar)
no-arg	🌟	no-caller (also blocks arguments.caller)
no-bitwise	🌟	no-bitwise
no-conditional-assignment	🌟	no-cond-assign[1]
no-console	🌟	no-console (configuration works slightly differently)
no-construct	🌟	no-new-wrappers
no-debugger	🌟	no-debugger
no-duplicate-super	🌟	constructor-super
no-duplicate-switch-case	🌟	no-duplicate-case
no-duplicate-variable	🌟	no-redeclare
no-dynamic-delete	🛑	N/A
no-empty	🌟	no-empty
no-eval	🌟	no-eval
no-floating-promises	🛑	N/A (relevant plugin)
no-for-in-array	🛑	N/A
no-implicit-dependencies	🔌	import/no-extraneous-dependencies
no-inferred-empty-object-type	🛑	N/A
no-invalid-template-strings	🌟	no-template-curly-in-string
no-invalid-this	🌟	no-invalid-this
no-misused-new	✅	typescript/no-misused-new
no-null-keyword	🔌	no-null/no-null (doesn’t handle null type)
no-object-literal-type-assertion	✅	typescript/no-object-literal-type-assertion
no-return-await	🌟	no-return-await
no-shadowed-variable	🌟	no-shadow
no-sparse-arrays	🌟	no-sparse-arrays
no-string-literal	🌟	dot-notation
no-string-throw	🌟	no-throw-literal
no-submodule-imports	◐	import/no-internal-modules (slightly different)
no-switch-case-fall-through	🌟	no-fallthrough
no-this-assignment	✅	typescript/no-this-alias
no-unbound-method	🛑	N/A
no-unnecessary-class	✅	typescript/no-extraneous-class
no-unsafe-any	🛑	N/A
no-unsafe-finally	🌟	no-unsafe-finally
no-unused-expression	🌟	no-unused-expression
no-unused-variable	◐	no-unused-vars [2]
no-use-before-declare	✅	typescript/no-use-before-define
no-var-keyword	🌟	no-var
no-void-expression	🌟	no-void
prefer-conditional-expression	🛑	N/A
prefer-object-spread	🌟	prefer-object-spread
radix	🌟	radix
restrict-plus-operands	🛑	N/A
strict-boolean-expressions	🛑	N/A
strict-type-predicates	🛑	N/A
switch-default	🌟	default-case
triple-equals	🌟	eqeqeq
typeof-compare	🌟	valid-typeof
use-default-type-parameter	🛑	N/A
use-isnan	🌟	use-isnan

^[1] The ESLint rule also supports silencing with an extra set of parens (if ((foo = bar)) {})
^[2] Missing private class member support. typescript/no-unused-vars adds support for some TS-specific features.

Maintainability

TSLint rule		ESLint rule
cyclomatic-complexity	🌟	complexity
deprecation	◐	import/no-deprecated [1]
eofline	🌟	eol-last
indent	✅	typescript/indent or Prettier
linebreak-style	🌟	linebreak-style or Prettier
max-classes-per-file	🌟	max-classes-per-file
max-file-line-count	🌟	max-lines
max-line-length	🌟	max-len or Prettier
no-default-export	🔌	import/no-default-export
no-duplicate-imports	🔌	import/no-duplicates
no-mergeable-namespace	🛑	N/A
no-require-imports	🛑	N/A
object-literal-sort-keys	◐	sort-keys [2]
prefer-const	🌟	prefer-const
prefer-readonly	🛑	N/A
trailing-comma	◐	comma-dangle or Prettier

^[1] Only warns when importing deprecated symbols
^[2] Missing support for blank-line-delimited sections

Style

TSLint rule		ESLint rule
align	🛑	N/A
array-type	✅	typescript/array-type
arrow-parens	🌟	arrow-parens
arrow-return-shorthand	🌟	arrow-body-style
binary-expression-operand-order	🌟	yoda
callable-types	🛑	N/A
class-name	✅	typescript/class-name-casing
comment-format	🌟	capitalized-comments & spaced-comment
completed-docs	🔌	eslint-plugin-jsdoc
encoding	🛑	N/A
file-header	🔌	eslint-plugin-header or -file-header
file-name-casing	🔌	unicorn/filename-case
import-spacing	🔌	Use Prettier
interface-name	✅	typescript/interface-name-prefix
interface-over-type-literal	✅	typescript/prefer-interface
jsdoc-format	◐	valid-jsdoc or eslint-plugin-jsdoc
match-default-export-name	🛑	N/A
newline-before-return	🌟	padding-line-between-statements [1]
newline-per-chained-call	🌟	newline-per-chained-call
new-parens	🌟	new-parens
no-angle-bracket-type-assertion	✅	typescript/no-angle-bracket-type-assertion
no-boolean-literal-compare	🛑	N/A
no-consecutive-blank-lines	🌟	no-multiple-empty-lines
no-irregular-whitespace	🌟	no-irregular-whitespace with skipStrings: false
no-parameter-properties	✅	typescript/no-parameter-properties
no-redundant-jsdoc	🛑	N/A (open issue)
no-reference-import	🛑	N/A
no-trailing-whitespace	🌟	no-trailing-spaces
no-unnecessary-callback-wrapper	🛑	N/A and this might be unsafe (i.e. with forEach)
no-unnecessary-initializer	🌟	no-undef-init
no-unnecessary-qualifier	🛑	N/A
number-literal-format	🛑	N/A
object-literal-key-quotes	🌟	quote-props
object-literal-shorthand	🌟	object-shorthand
one-line	🛑	N/A
one-variable-per-declaration	🌟	one-var
ordered-imports	🔌	import/order
prefer-function-over-method	🌟	class-methods-use-this
prefer-method-signature	🛑	N/A
prefer-switch	🛑	N/A
prefer-template	🌟	prefer-template
prefer-while	🛑	N/A
quotemark	🌟	quotes
return-undefined	🛑	N/A
semicolon	🌟	semi
space-before-function-paren	🌟	space-before-function-paren
space-within-parens	🌟	space-in-parens
switch-final-break	🛑	N/A
type-literal-delimiter	✅	typescript/member-delimiter-style
variable-name	🌟	[2]
whitespace	🔌	Use Prettier

^[1] Recommended config: ["error", { blankLine: "always", prev: "*", next: "return" }]
^[2] camelcase, no-underscore-dangle, id-blacklist, and/or [id-match]

tslint-microsoft-contrib rules

Rule listing is here. Deprecated rules are excluded (missing-jsdoc, missing-optional-annotation, no-duplicate-case, no-duplicate-parameter-names, no-increment-decrement, no-empty-interfaces, no-missing-visibility-modifiers, no-multiple-var-decl, no-reserved-keywords, no-stateless-class, no-var-self, no-unnecessary-bind, and valid-typeof). See the docs in the link above to find out what to use instead.

Testing

Relevant plugins: chai-expect-keywords, chai-expect, chai-friendly, mocha, and jest

tslint-microsoft-contrib rule		ESLint rule
chai-prefer-contains-to-index-of	🛑	N/A
chai-vague-errors	🛑	N/A
mocha-avoid-only	🔌	jest/no-focused-tests
mocha-unneeded-done	🛑	N/A

TypeScript

tslint-microsoft-contrib rule		ESLint rule
prefer-array-literal	◐	typescript/no-array-constructor [1]
prefer-type-cast	🛑	N/A

^[1] ESLint rule is slightly less strict, allowing new Array<Foo>() and Array(2).

Miscellaneous

tslint-microsoft-contrib rule		ESLint rule
export-name	🛑	N/A (relevant plugin)
function-name	🛑	N/A
import-name	🛑	N/A (relevant plugin)
function-name	🛑	N/A
informative-docs	🛑	N/A
insecure-random	🔌	custom implementation
max-func-body-length	🌟	max-statements
no-banned-terms	🌟	[no-callee][no-callee] & no-eval
no-constant-condition	🌟	no-constant-condition
no-control-regex	🌟	no-control-regex
no-delete-expression	◐	no-delete-var
no-empty-line-after-opening-brace	🌟	padded-blocks [1] or Prettier
no-for-in	🌟	no-restricted-syntax [2]
no-function-expression	🌟	func-style [3]
no-invalid-regexp	🌟	no-invalid-regexp
no-multiline-string	🌟	no-multi-str
no-octal-literal	🌟	no-octal-escape, see also no-octal
no-regex-spaces	🌟	no-regex-spaces
no-relative-imports	🛑	N/A, Not recommended by the maintainers
no-single-line-block-comment	🛑	N/A
no-suspicious-comment	🌟	[no-warning-comments][no-warning-comments] [4]
no-typeof-undefined	🛑	N/A (this actually has a valid use: checking if a variable is defined)
no-unexternalized-strings	🛑	N/A
no-unnecessary-field-initialization	◐	no-undef-init [5]
no-unnecessary-local-variable	🛑	N/A
no-unnecessary-override	🛑	N/A
no-unnecessary-semicolons	🌟	no-extra-semi or Prettier
no-useless-files	🛑	N/A
no-with-statement	🌟	no-with
promise-must-complete	🛑	N/A
underscore-consistent-invocation	🔌	lodash/chaining
use-named-parameter	🛑	N/A
use-simple-attributes	🛑	N/A

^[1] Enforces blank lines both at the beginning and end of a block
^[2] Recommended config: ["error", "ForInStatement"]
^[3] Recommended config: ["error", "declaration", { "allowArrowFunctions": true }]
^[4] Recommended config: ["error", { "terms": ["BUG", "HACK", "FIXME", "LATER", "LATER2", "TODO"], "location": "anywhere" }]
^[5] Does not check class fields.

Security

tslint-microsoft-contrib rule		ESLint rule
no-disable-auto-sanitization	🛑	N/A
no-document-domain	◐	Use no-restricted-syntax
no-function-constructor-with-string-args	🌟	no-new-func
no-http-string	🛑	N/A
no-inner-html	🛑	N/A
no-string-based-set-immediate	🛑	N/A
no-string-based-set-interval	🛑	N/A
no-string-based-set-timeout	🛑	N/A
react-iframe-missing-sandbox	🛑	N/A
react-no-dangerous-html	🔌	react/no-danger
non-literal-fs-path	🔌	security/detect-non-literal-fs-filename
non-literal-require	🔌	security/detect-non-literal-require
possible-timing-attack	🔌	security/detect-possible-timing-attacks

Browser

tslint-microsoft-contrib rule		ESLint rule
jquery-deferred-must-complete	🛑	N/A
no-backbone-get-set-outside-model	🛑	N/A
no-cookies	◐	Use no-restricted-syntax
no-document-write	◐	Use no-restricted-syntax
no-exec-script	◐	Use no-restricted-syntax
no-jquery-raw-elements	🛑	N/A
no-unsupported-browser-code	🔌	eslint-plugin-compat
react-this-binding-issue	🛑
react-tsx-curly-spacing	🔌	react/jsx-curly-spacing
react-unused-props-and-state	◐	react/no-unused-state

React A11y

tslint-microsoft-contrib rule		ESLint rule
react-a11y-accessible-headings	◐	jsx-a11y/heading-has-content [1]
react-a11y-anchors	🔌	jsx-a11y/anchor-is-valid
react-a11y-aria-unsupported-elements	🔌	jsx-a11y/aria-unsupported-elements
react-a11y-event-has-role	◐	jsx-a11y/no-static-element-interactions [2]
react-a11y-image-button-has-alt	🔌	jsx-a11y/alt-text
react-a11y-img-has-alt	🔌	jsx-a11y/alt-text
react-a11y-input-elements	🛑	N/A
react-a11y-lang	🔌	jsx-a11y/html-has-lang & jsx-a11y/lang
react-a11y-meta	🛑	N/A
react-a11y-no-onchange	🔌	jsx-a11y/no-onchange
react-a11y-props	🔌	jsx-a11y/aria-props
react-a11y-proptypes	🔌	jsx-a11y/aria-proptypes
react-a11y-required	🛑	N/A
react-a11y-role-has-required-aria-props	🔌	jsx-a11y/role-has-required-aria-props
react-a11y-role-supports-aria-props	🔌	jsx-a11y/role-supports-aria-props
react-a11y-role	🔌	jsx-a11y/aria-role
react-a11y-tabindex-no-positive	🔌	jsx-a11y/tabindex-no-positive
react-a11y-titles	🛑	N/A
react-anchor-blank-noopener	🛑	N/A

^[1] TSLint rule is more strict
^[2] ESLint rule only reports for click handlers