JSHint, A Static Code Analysis Tool for JavaScript

JSHint is a community-driven tool to detect errors and potential problems in JavaScript code and to enforce your team's coding conventions.

IMPORTANT:

This README is for people who are thinking about contributing to JSHint. For general usage please refer to our website.
If you want to report a bug about the website, please go to the jshint/site repository.
If you want to report a bug or contribute to our NPM package, please go to the jshint/node-jshint repository.

Reporting a bug

To report a bug simply create a new GitHub Issue and describe your problem or suggestion. We welcome all kind of feedback regarding JSHint including but not limited to:

When JSHint doesn't work as expected
When JSHint complains about valid JavaScript code that works in all browsers
When you simply want a new option or feature

Please, before reporting a bug look around to see if there are any open or closed tickets that cover your issue. And remember the wisdom: pull request > bug report > tweet.

Submitting patches

The best way to make sure your issue is addressed is to submit a patch. GitHub provides a very nice interface--pull requests--for that but we accept patches through all mediums: email, issue comment, tweet with a link to a snippet, etc.

Before submitting a patch make sure that you comply to our style. We don't have specific style guide so just look around the code you are changing.

Also, make sure that you write tests for new features and make sure that all tests pass before submitting a patch. Patches that break the build will be rejected.

FEATURE FREEZE: Please note that we currently have a feature freeze on new environments and styling options. The only patches we accept at this time are for bug fixes.

Tests

To run tests you will need to install node.js and expresso. You can install the latter with npm:

npm install expresso

After that, running the unit tests is as easy as:

expresso tests/unit/*.js

Attribution

Core Team members:

Maintainer: Anton Kovalyov

License

JSHint is licensed under the same slightly modified MIT license that JSLint is. It stops evil-doers everywhere.

JSHint is a derivative work of JSLint:

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

The Software shall be used for Good, not Evil.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

JSHint was forked from the 2010-12-16 edition of JSLint.

Thank you!

We really appreciate all kind of feedback and contributions. Thanks for using and supporting JSHint!