gulp-html-linter v1.0.0

gulp-html-linter

This is a gulp plugin for HTMLLint. Its interface was created to be similar to gulp-eslint.

Intallation

yarn add gulp-html-linter

or

npm install --save gulp-html-linter

Sample usage

const gulp = require('gulp'),
	htmlLint = require('gulp-html-linter');

gulp.task('html', () =>
    gulp.src('site/**/*.html')
        .pipe(htmlLint())
        .pipe(htmlLint.format())
        .pipe(htmlLint.failOnError())
);

API

Functions

• htmlLint(opts) - Adds htmlLint property to every file in a stream that is incorrect. Handles options.
• htmlLint.failOnError() - Fail when an HtmlLint error is found in HtmlLint results.
• htmlLint.failAfterError() - Fail when the stream ends and if any HtmlLint error(s) occurred. failOnError failed immediately - did not wait for the stream to end.
• htmlLint.format(formatter) - Formats all HtmlLint issues using given formatter or a default one.
• htmlLint.formatEach(formatter) - Format the results of each file individually.
• htmlLint.result(action) - Handle each HtmlLint result as it passes through the stream.
• htmlLint.results(action) - Handle all HtmlLint results at the end of the stream.

Options

• htmllintrc - (String, default: ".htmllintrc") htmllintrc configuration file.
• useHtmllintrc - (Boolean, default: true) if false does not load htmllintrc configuration file.
• rules - (Object, default: {}) Additional htmllint rules.
• plugins - (String, default: []) List of htmllint plugins.
• limitFiles - (Number, default: Number.MAX_VALUE) Stops linter after defined number of invalid files.
• limitIssuesPerFile - (Number, default: Number.MAX_VALUE) Stops linter after defined number of linter issues in one file.
• limitIssues - (Number, default: Number.MAX_VALUE) Stops linter after defined number of linter issues.

Default opts values:

{
    htmllintrc: ".htmllintrc",
    useHtmllintrc: true,
    rules: {},
    plugins: [],
    limitFiles: `Number.MAX_VALUE`,
    limitIssuesPerFile: `Number.MAX_VALUE`,
    limitIssues: `Number.MAX_VALUE`,
}

License

MIT © Paweł Mendelski