{"id":25695,"library":"gulp-html5-lint","title":"gulp-html5-lint","description":"Gulp plugin for HTML5 linting using the Mozilla HTML5 validator API. Version 1.1.0 is the latest stable release. This plugin sends HTML files to the validator.nu API for validation and reports issues via gulp-notify. It is designed for use with gulp 3.x and wraps the html5-lint npm package. Key differentiators: leverages the official Mozilla validator API (requires internet connectivity), provides options for API timeout and error handling, and integrates seamlessly into gulp workflows. Alternatives: gulp-htmlhint, gulp-w3c-html-validator.","status":"maintenance","version":"1.1.0","language":"javascript","source_language":"en","source_url":"git@github.com:LiveSafe/gulp-html5-lint","tags":["javascript","gulp","html","html5","lint","gulpplugin"],"install":[{"cmd":"npm install gulp-html5-lint","lang":"bash","label":"npm"},{"cmd":"yarn add gulp-html5-lint","lang":"bash","label":"yarn"},{"cmd":"pnpm add gulp-html5-lint","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Core dependency providing HTML5 linting logic via validator.nu API","package":"html5-lint","optional":false},{"reason":"Peer dependency; plugin is a gulp plugin","package":"gulp","optional":false}],"imports":[{"note":"CommonJS module; no default ES import supported. Use require() in gulpfile.","wrong":"import html5Lint from 'gulp-html5-lint';","symbol":"default","correct":"const html5Lint = require('gulp-html5-lint');"},{"note":"Arrow functions may cause issues with 'this' in older gulp versions; use regular functions for gulp 3.x.","wrong":"gulp.task('lint', () => gulp.src('*.html').pipe(html5Lint()));","symbol":"gulp","correct":"gulp.task('lint', function() { return gulp.src('*.html').pipe(html5Lint()); });"},{"note":"Timeout option must be nested under apiCheck object.","wrong":"html5Lint({ timeout: 5000 })","symbol":"options","correct":"html5Lint({ apiCheck: { timeout: 5000 } })"}],"quickstart":{"code":"const gulp = require('gulp');\nconst html5Lint = require('gulp-html5-lint');\n\ngulp.task('html5-lint', function() {\n    return gulp.src('./src/*.html')\n        .pipe(html5Lint());\n});\n\ngulp.task('default', ['html5-lint']);","lang":"javascript","description":"Sets up a gulp task that lints all HTML files in ./src using the Mozilla validator API."},"warnings":[{"fix":"Ensure network connectivity or use a local validator instance.","message":"Requires internet access: the plugin sends HTML files to validator.nu for validation.","severity":"breaking","affected_versions":">=0.0.0"},{"fix":"Use gulp 3.x or wrap with appropriate gulp 4 task syntax.","message":"gulp 4.x compatibility not guaranteed: plugin uses gulp.src and gulp.task patterns from gulp 3.x.","severity":"deprecated","affected_versions":">=1.0.0"},{"fix":"Increase timeout via options.apiCheck.timeout.","message":"API timeout defaults to 10 seconds; large files may cause timeout increases.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Consider alternatives like gulp-htmlhint or gulp-w3c-html-validator.","message":"html5-lint package is no longer actively maintained, may break with API changes.","severity":"deprecated","affected_versions":">=1.0.0"},{"fix":"Use Node.js 0.10 to 10.x; may fail on Node 12+.","message":"Only supports Node.js 0.10+; not tested on newer Node versions.","severity":"breaking","affected_versions":">=1.0.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Specify a different port via options.port.","cause":"Defaults to port 80 for local server; conflicts with existing services.","error":"Error: listen EADDRINUSE :::80"},{"fix":"Check internet connection or firewall rules.","cause":"Cannot reach validator.nu API due to network issues.","error":"Error: connect ECONNREFUSED 64.34.119.12:80"},{"fix":"Use require() and gulp 3.x syntax, or use gulp.series for gulp 4.","cause":"Using ES6 import syntax or gulp 4 which requires gulp.task() to be called differently.","error":"TypeError: gulp.task is not a function"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}