# grunt-jscs-checker

> Grunt task for checking JavaScript Code Style with jscs.

Latest version **0.8.1** (published 2014-10-24) · MIT license · 0 weekly downloads

> **Deprecated.** This package is deprecated.

## Install

```sh
npm install grunt-jscs-checker
pnpm add grunt-jscs-checker
yarn add grunt-jscs-checker
bun add grunt-jscs-checker
```

## Health

**Score 10/100 (F)** — status: deprecated.

Negative: deprecated.

## Facts

| | |
|---|---|
| Version | 0.8.1 |
| Published | 2014-10-24 |
| First published | 2013-07-12 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >= 0.10.0 |
| Dependencies | 4 |
| Known vulnerabilities | 0 (+5 in 1 direct dependencies) |
| Install scripts | no |
| GitHub stars | 238 |
| Author | Gustavo Henke |
| Maintainers | gustavohenke |
| Keywords | gruntplugin, jscs, code style, checker |

## Links

- npm: https://www.npmjs.com/package/grunt-jscs-checker
- Repository: https://github.com/jscs-dev/grunt-jscs
- Issues: https://github.com/jscs-dev/grunt-jscs/issues
- npm.io page: https://npm.io/package/grunt-jscs-checker

## Dependencies (4)

- [vow](https://npm.io/package/vow.md) ~0.4.1
- [jscs](https://npm.io/package/jscs.md) ~1.7.2
- [hooker](https://npm.io/package/hooker.md) ~0.2.3
- [lodash](https://npm.io/package/lodash.md) ~2.4.1

## Recent versions

- 0.8.1 (latest) — 2014-10-24
- 0.8.0 — 2014-10-17
- 0.7.1 — 2014-09-02
- 0.7.0 — 2014-08-29
- 0.6.2 — 2014-07-30
- 0.6.1 — 2014-06-30
- 0.6.0 — 2014-06-23
- 0.5.1 — 2014-06-17
- 0.5.0 — 2014-06-17
- 0.4.4 — 2014-05-14
- 0.4.3 — 2014-05-06
- 0.4.2 — 2014-04-30
- 0.4.1 — 2014-03-18
- 0.4.0 — 2014-02-25
- 0.3.2 — 2014-01-10
- … 16 more at https://npm.io/package/grunt-jscs-checker/versions

## README

# grunt-jscs
> Task for checking JavaScript Code Style with [jscs](https://github.com/jscs-dev/node-jscs).

[![Build Status](https://travis-ci.org/jscs-dev/grunt-jscs.svg?branch=master)](https://travis-ci.org/jscs-dev/grunt-jscs)
[![Dependency Status](https://david-dm.org/jscs-dev/grunt-jscs.svg)](https://david-dm.org/jscs-dev/grunt-jscs)
[![devDependency Status](https://david-dm.org/jscs-dev/grunt-jscs/dev-status.svg)](https://david-dm.org/jscs-dev/grunt-jscs#info=devDependencies)
[![NPM version](https://badge.fury.io/js/grunt-jscs.svg)](http://badge.fury.io/js/grunt-jscs)

## Getting started
This plugin requires Grunt `~0.4.2`

If you haven't used [Grunt](http://gruntjs.com/) before, be sure to check out the [Getting Started](http://gruntjs.com/getting-started) guide, as it explains how to create a [Gruntfile](http://gruntjs.com/sample-gruntfile) as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

```shell
npm install grunt-jscs --save-dev
```

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:

```js
grunt.loadNpmTasks("grunt-jscs");
```

## jscs task
_Run this task with the `grunt jscs` command._

Task targets, files and options may be specified according to the grunt [Configuring tasks](http://gruntjs.com/configuring-tasks) guide.

### Options
Any specified option will be passed through directly to JSCS, plus this plugin has additional options:

#### config
Type: `String`, `Boolean`
Default value: `true`

Defines how to externally load a JSCS configuration via the [JSCS config loader](https://github.com/jscs-dev/node-jscs#--config).
The following is the behavior of this option:

- If set to a file path, then this file will be used;
- If set to `true`, JSCS will use its default config loading behavior;
- If set to `true` or to a file path with JSCS options specified in the grunt task, then they will be merged.

```js
jscs: {
    src: "path/to/files/*.js",
    options: {
        config: ".jscsrc",
        requireCurlyBraces: [ "if" ]
    }
}
```

#### force
Type: `Boolean`
Default value: `false`

Set `force` to `true` to report JSCS errors but not fail the task.

#### reporter
Type: `String`
Default value: `null`

Allows you to modify the output. By default it will use a built-in `grunt` reporter. Set the path to your own custom reporter or to one of the built-in JSCS [reporters](https://github.com/jscs-dev/node-jscs/tree/master/lib/reporters).

#### reporterOutput
Type: `String`
Default value: `null`

Specify a filepath to output the results of a reporter. If `reporterOutput` is specified then all output will be written to the given filepath instead of printed to stdout.

### Usage examples
```js
jscs: {
    main: [ "path/to/files/*.js" ],
    secondary: {
        options: {
            config: ".jscs-secondary",
        },
        files: {
            src: [ "path/to/more/files/**/*.js", "my-plugin.js" ]
        }
    },
    ternary: {
        options: {
            requireCurlyBraces: [ "if" ]
        },
        files: {
            src: "happy-hippo.js"
        }
    }
}
```

## Release History
See the [releases page](https://github.com/jscs-dev/grunt-jscs/releases).

---
_Source: https://npm.io/package/grunt-jscs-checker · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
