JSHint

Making it easy to lint your JavaScript assets in any Rails 3.1+ application.

Add this line to your Rails application's Gemfile:

group :development, :test do
  gem 'jshint'
end

And then execute:

$ bundle

Run the generator:

bundle exec rake jshint:install_config

To start using JSHint simply run the Rake task:

bundle exec rake jshint

This Rake task runs JSHint across any JavaScript files contained within the following three folders in your Rails application to ensure that they're lint free. Using that data it builds a report which is shown in STDOUT.

your-rails-project/app/assets/javascripts
your-rails-project/vendor/assets/javascripts
your-rails-project/lib/assets/javascripts

JSHint has some configuration options. You can read the default configuration created by JSHint in config/jshint.yml within your application.

# your-rails-project/config/jshint.yml
files: ['**/*.js']
exclude_paths: []
exclude_files: []
options:
  boss: true
  browser: true
  ...
  globals:
    jQuery: true
    $: true

For more configuration options see the JSHint documentation.

You can specify an other path to your configuration file via:

bundle exec rake jshint:lint['path/to/your/config.yml']

To add folders outside of the standard Rails asset paths, you can define an array of include_paths within your configuration file.

files: ['**/*.js']
include_paths: ['spec/javascripts']
...

To exclude a folder from being linted you can define an array of exclude_paths within your configuration file.

files: ['**/*.js']
exclude_paths: ['vendor', 'app/assets/javascripts/tests/']
...

To exclude a file from being linted you can define an array of exclude_files within your configuration file.

files: ['**/*.js']
exclude_files: ['**/*test.js']
...

To use jshint in your default Rake config, just add it to the list of default tasks. For example, this configuration will run jshint in development or test environments.

# your-rails-project/Rakefile
if %w(development test).include? Rails.env
  task default: :jshint
end

You can view the changelog here.

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request