# jscheckstyle

> Static analysis tool for javascript - calculates cyclomatic complexity, amongst other things

Latest version **0.0.9** (published 2013-05-23) · 0 weekly downloads

## Install

```sh
npm install jscheckstyle
pnpm add jscheckstyle
yarn add jscheckstyle
bun add jscheckstyle
```

Provides the command `jscheckstyle`.

## Health

**Score 5/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: insecure dependencies; abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.0.9 |
| Published | 2013-05-23 |
| First published | 2011-09-15 |
| Weekly downloads | 0 |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 3 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 62 |
| Maintainers | csausdev |
| Keywords | static, analysis, cyclomatic, complexity |

## Links

- npm: https://www.npmjs.com/package/jscheckstyle
- Repository: https://github.com/nomiddlename/jscheckstyle
- npm.io page: https://npm.io/package/jscheckstyle

## Dependencies (3)

- [file](https://npm.io/package/file.md) >=0.1.1
- [burrito](https://npm.io/package/burrito.md) http://github.com/danbell/node-burrito/tarball/master
- [cli-table](https://npm.io/package/cli-table.md) >=0.2.0

## Recent versions

- 0.0.9 (latest) — 2013-05-23
- 0.0.8 — 2012-11-11
- 0.0.7 — 2012-08-23
- 0.0.6 — 2012-06-29
- 0.0.5 — 2012-03-08
- 0.0.4 — 2011-10-20
- 0.0.3 — 2011-10-20
- 0.0.2 — 2011-09-19
- 0.0.1 — 2011-09-15

## README

[![Build Status](https://secure.travis-ci.org/nomiddlename/jscheckstyle.png?branch=master)](http://travis-ci.org/nomiddlename/jscheckstyle)

# Purpose
A command-line tool for analysing javascript source, providing measurements of function length, number of arguments, and cyclomatic complexity.

NOTE: jshint now does most of these checks, http://www.elijahmanor.com/2012/09/control-complexity-of-your-javascript.html so you may not need this any more. Use jshint instead, it checks for a whole load of other things as well.

## Installation
    npm install jscheckstyle

## Usage
    jscheckstyle some-javascript.js some-other-javascript.js (default output as nice table on command line)
    jscheckstyle --violations some-javascript.js (will output rule-violating functions only)
    jscheckstyle --html some-javascript.js > output.html
    jscheckstyle --json some-javascript.js > output.json
    jscheckstyle --checkstyle some-javascript.js > output.xml (will output Java checkstyle-compatible output, useful for Jenkins)
    jscheckstyle --emacs some-javascript.js (produces output suitable for Emacs flymake - see flymake-jschecksyle.el)

## Rules
There are three rules at the moment which will be violated if:

* function length is greater than 30 lines
* number of arguments to a function is greater than 5
* cyclomatic complexity for a function is greater than 10

## Exclusion
To exclude certain directories or files from being checkstyled, simply create a .jscheckstyleignore file at current directory, and specify the directory or file name (relative to current directory) that you want to exclude.

## Configuration
It is possible to change the default rules by specifying different limits in comments before a function.

For example:

    /*
     * @jscheckstyle.functionLength=20
     * @jscheckstyle.numberOfArguments=10
     * @jscheckstyle.cyclomaticComplexity=30
     */
    function theFunction() {
        ...
    }


## History
Originally I started out modifying [jsmeter](http://jsmeter.info) to run as a command-line tool. Then I started hacking away, added some tests, the command-line interface, added the rules checking and the extra output types, replaced the parser with [node-burrito](https://github.com/substack/node-burrito) and then realised there wasn't much of jsmeter left. So this tool is inspired by, and owes a huge debt to, jsmeter - but there's very little of the original code to be found (possibly only the HTML output renderer).

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