Lint JavaScript with ESLint as part of your Broccoli build pipeline.
Most of the test setup and the build configuration is based on sindresorhus/grunt-eslint. The internal validation is heavily inspired by eslint cli.js.
As of 3.0.0
, broccoli-lint-eslint
uses versions of eslint
greater than 3.0.0
. Because eslint@3.0.0
dropped support for Node versions below 4, you may need to use the latest 2.x
version of broccoli-lint-eslint
(which uses eslint@2.13.1
), if your support needs also fall below Node v4:
npm install --save broccoli-lint-eslint@2
If versions of Node >= 4 suit your needs, you can safely install the latest version of broccoli-lint-eslint
:
npm install --save broccoli-lint-eslint
var eslint = require('broccoli-lint-eslint');
var outputNode = eslint(inputNode, options);
-
inputNode
A Broccoli node -
options
{Object}: Options to control howbroccoli-lint-eslint
is run.-
format
{string|function}: The path, or function reference, to a custom formatter (See eslint/tree/master/lib/formatters for alternatives).Default:
'eslint/lib/formatters/stylish'
-
testGenerator
{function(relativePath, errors), returns reporter output string
}: The function used to generate test modules. You can provide a custom function for your client side testing framework of choice.Default:
null
- relativePath - The relative path to the file being tested.
- errors - An array of eslint error objects found.
If you provide a
string
one of the predefined test generators is used. Currently supported arequnit
andmocha
.Example usage:
var path = require('path'); function testGenerator(relativePath, errors) { return "module('" + path.dirname(relativePath) + "');\n"; "test('" + relativePath + "' should pass ESLint', function() {\n" + " ok(" + passed + ", '" + moduleName + " should pass ESLint." + (errors ? "\\n" + errors : '') + "');\n" + "});\n"; }; return eslint(inputNode, { options: { configFile: this.eslintrc.app + '/eslint.json', rulesdir: this.eslintrc.app }, testGenerator: testGenerator });
-
throwOnError
{boolean}: Cause exception error on first violation witherror
-level severity.Default:
false
-
throwOnWarn
{boolean}: Cause exception error on first violation withwarn
-level severity. NOTE: Setting this to true will automatically enablethrowOnError
behavior.Default:
false
-
persist
{boolean}: Persist the state of filter output across restartsDefault:
false
-
console
: {Object}: A custom console object with alog
method forbroccoli-lint-eslint
to use when logging formatter output.Default: The global
console
object -
options
{options}: Options native to ESLint CLI. While all options will be passed to the ESLint CLIEngine, these are the ones thatbroccoli-lint-eslint
makes use of in particular:-
configFile
{string}: Path to eslint configuration file.Default:
./eslintrc
-
rulePaths
{Array}: Paths to a directory with custom rules. Your custom rules will be used in addition to the built-in ones. Recommended read: Working with Rules.Default: built-in rules directory
-
ignore
{boolean}:false
disables use of.eslintignore
,ignorePath
andignorePattern
Default:
true
-
-
extensions
{Array}: File extensions to lint. NOTE: If you add Typescript filestypescript-eslint-parser
has to be installed and specified as the parser. For more information take a look at thetypescript-eslint-parser
Default:
['js']
-