gulp-byo-jslint
gulp-byo-jslint copied to clipboard
A bring-your-own JSLint plugin for Gulp.
gulp-byo-jslint
A bring-your-own JSLint plugin for Gulp.
Isn't there already a JSLint plugin for Gulp?
Yes there is, but it is not awesome. It breaks on the first violation instead of enumerating all warnings, hasn't been updated in a very long time and doesn't support the latest version of JSLint.
What do you mean "BYO"?
Bring-your-own copy of jslint.js
, quite literaly. This plugin wont work
without it.
The use of git submodules is highly
recommended for this. No need to to wait for updates to gulp-byo-jslint
for
new versions of JSLint. Just git pull
in the submodule directory. What better
way to stay on the bleeding edge?
md submodules
cd submodules
git submodule add https://github.com/douglascrockford/JSLint.git
Does it support "old" JSLint?
No editions prior to 2015-05-01 will work with this plugin. The JSLint interface changed significantly at that time (all for the better), so there is no going back.
Any current edition of JSLint should work fine.
Installation
npm install gulp-byo-jslint --save-dev
Usage
'use strict';
var gulp = require('gulp');
var jslint = require('gulp-byo-jslint');
var paths = [
'./**/*.js', // Include all JavaScript files
'./**/*.json', // Include all JSON files
'!./node_modules/**', // Exclude NPM
'!./bower_components/**', // Exclude Bower
'!./submodules/**' // Exclude Git submodules
];
function runJSLint(noFail) {
return gulp.src(paths)
.pipe(jslint({
// The file path to jslint.js.
jslint: './submodules/JSLint/jslint.js',
// The options to pass to JSLint.
options: {
browser: true
},
// The list of known global variables to pass to JSLint.
globals: ['define', 'require'],
// True to log all warnings without failing.
noFail: noFail
}));
}
gulp.task('lint', function () {
return runJSLint();
});
gulp.task('lint-watch', function () {
return runJSLint(true);
});
gulp.task('watch', function () {
gulp.watch(paths, ['lint-watch']);
});
For more information about the switches available on the options
property,
please see JSLint help.