1.0.0 • Published 7 years ago

gulp-html-linter v1.0.0

Weekly downloads
8
License
MIT
Repository
github
Last release
7 years ago

gulp-html-linter

NPM info

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

1.0.0

7 years ago