babel/eslint/babel-eslint-parser

babel-eslint Build Status

babel-eslint allows you to lint ALL valid Babel code with the fantastic ESLint.

NOTE: Please note that this is experimental and may have numerous bugs. It is however successfuly linting the babel core.

If there is an issue, first check if it can be reproduced with the regular parser and with the latest versions of eslint and babel-eslint.

For questions and support please visit the #linting babel slack channel!

Known Issues

  • no-undef for global flow types: ReactElement, ReactClass #130
    • Workaround: define types as globals in .eslintrc or define types and import them import type ReactElement from './types'
  • no-unused-vars/no-undef with Flow declarations (declare module A {}) #132
  • no-unused-vars: [2, {vars: local}] #136

Please check out eslint-plugin-react for react/jsx issues

  • no-unused-vars with jsx

Please check out eslint-plugin-babel for the issues below:

  • generator-star with async/await functions #78
  • object-shorthand with spread operator #131

How does it work?

ESLint allows custom parsers. This is great but some of the syntax nodes that Babel supports aren't supported by ESLint. When using this plugin, ESLint is monkeypatched and your code is transformed into code that ESLint can understand. All location info such as line numbers, columns is also retained so you can track down errors with ease.

Usage

Install

$ npm install -g eslint babel-eslint

Setup

.eslintrc

{
  "parser": "babel-eslint",
  "rules": {
    "strict": 0
  }
}

Check out the ESLint docs for all possible rules.

Run

$ eslint your-files-here