webhint
Quick start user guide
webhint is a customizable linting tool that helps you improve your site's accessibility, speed, cross-browser compatibility, and more by checking your code for best practices and common errors.
It can be run from the command line (CLI), via a browser extension, and as a VS Code extension.
To use it from the CLI you will need to install Node.js
(v14.x or later) on your machine, and you can use npx to test it.
Testing with npx
Run the following command:
npx hint https://example.comThis will analyze https://example.com using the default configuration.
Installing webhint locally
Install webhint as a devDependency of your project:
npm install hint --save-devAnd then add a script task to your package.json:
{
...
"scripts": {
"webhint": "hint"
}
}And run it via:
npm run webhint -- http://localhost:8080Or if you are using yarn you can skip the step to create a task and
run directly:
yarn hint http://localhost:8080To know more about webhint, how to configure it, etc. see the online user guide, or the local version for the most recent content.
Contributing to webhint
This project follows a monorepo pattern. That means that the code for all the webhint flavors (CLI, browser and VS Code extension, hints, formatters, etc.) are in here and are published as separate npm packages.
To build the project from the source you will need to install a recent version of node and yarn. Once you've done this run the following from the root of your cloned version:
yarn
yarn buildThis can take a bit so please be patient.
To learn more about the internals of webhint, the structure of the
project, how to create new hints, parsers, formatters, etc, take
a look at the online contributor guide (or the
local version).
Contributing to the browser and VS Code extensions
To learn about how to build one of the extensions please check
the CONTRIBUTING.md files for each of these packages:
packages/extension-browser/CONTRIBUTING.mdfor the browser extension.packages/extension-vscode/CONTRIBUTING.mdfor the VS Code extension.
Code of Conduct
All projects in the webhintio organization follow this CoC
which adheres to the OpenJS Foundation Code of Conduct.
Other important links
License
The code is available under the Apache 2.0 license.
