gulp-tslint
TypeScript linter plugin for Gulp.
First install gulp-tslint
npm install --save-dev gulp-tslint
Peer dependencies
The tslint
module is a peer dependency of gulp-tslint
, which allows you to update tslint independently from gulp-tslint.
Usage:
import tslint from "gulp-tslint";
var tslint = require("gulp-tslint");
gulp.task("tslint", () =>
gulp.src("source.ts")
.pipe(tslint())
.pipe(tslint.report("verbose"))
);
Types should work automatically with TypeScript 1.6 or newer when used in TypeScript.
tslint.json is attempted to be read from near the input file.
It must be available or supplied directly through the options.
The output (stringified JSON) is added to file.tslint.output.
You can output the errors by using reporters.
There are five default reporters:
- "json" prints stringified JSON to console.log.
- "prose" prints short human-readable failures to console.log.
- "verbose" prints longer human-readable failures to console.log.
- "full" is like verbose, but displays full path to the file
- "msbuild" for Visual Studio
Reporters are executed only if there is at least one failure.
If there is at least one failure a PluginError is
emitted after execution of the reporters:
[gulp] Error in plugin 'gulp-tslint': Failed to lint: input.ts
You can prevent emiting the error by setting emitError in report options to false.
gulp.task("invalid-noemit", () =>
gulp.src("input.ts")
.pipe(tslint())
.pipe(tslint.report("prose", {
emitError: false
}))
);
You can summarize the gulp error message to the number of errors by setting summarizeFailureOutput in report options.
gulp.task("invalid-noemit", () =>
gulp.src("input.ts")
.pipe(tslint())
.pipe(tslint.report("prose", {
summarizeFailureOutput: true
}))
);
You can use your own reporter by supplying a function.
const testReporter = function (output, file, options) {
console.log("Found " + output.length + " errors in " + file.path);
};
gulp.task("invalid-custom", () =>
gulp.src("input.ts")
.pipe(tslint())
.pipe(tslint.report(testReporter))
);
tslint.json can be supplied as a parameter by setting the configuration property.
gulp.task("tslint-json", () =>
gulp.src("input.ts")
.pipe(tslint({
configuration: {
rules: {
"class-name": true,
}
}
}))
.pipe(tslint.report("prose"))
);
You can also supply a file path to the configuration option, and the file name
doesn't need to be tslint.json.
.pipe(tslint({
configuration: "source/settings.json"
}))
Report limits
You can optionally specify a report limit in the .report options that will turn off reporting for files after the limit has been reached. If the limit is 0 or less, the limit is ignored, which is the default setting.
gulp.task("tslint", () =>
gulp.src(["input.ts",])
.pipe(tslint())
.pipe(tslint.report("prose", {
reportLimit: 2
}))
);
Specifying the tslint module
If you want to use a different version of tslint, you can supply it with the tslint
option.
npm install tslint@next
.pipe(tslint({
tslint: require("tslint")
}));
All default tslint options
const tslintOptions = {
configuration: {},
rulesDirectory: null,
tslint: null
};
All default report options
const reportOptions = {
emitError: true,
reportLimit: 0,
summarizeFailureOutput: false
};
Development
Fork this repository, run npm install and send pull requests. The project can be build with gulp
command.