v2.3.3

Version 2.3.3 (10-16-2015):

Bug Fixes

• Fixed an error with disallowUnusedParams and es6 imports 63526b7 #1875
• Fixed an autofix issue with all function spacing rules and not accounting for the async keyword cf134a1 #1873

v2.3.2

Version 2.3.2 (10-14-2015):

Fix an issue with --extract option being true by default

v2.3.1

Version 2.3.1 (10-14-2015):

A bunch of bug fixes in this release!

The Future

We are probably going to start 3.0 for the next release (mainly integrating CST into JSCS). If you want to know more about CST check out the previous changelog.

Our current plan is to move our 3.0/cst branch to master and then create a 2.x branch to continue to release bug fixes / contributer PRs. The core team will be mainly focused on tackling issues on our 3.0 roadmap (which we are still planning). We would love to hear your feedback on what you think should be in 3.0 and beyond!

Bug Fixes:

• disallowMultipleVarDecl - improve {"allExcept": ["require"]} logic (ValYouW)

// Allow MemberExpressions: require('a').b.c;
var fs = require('fs');
var Emitter = require('events').EventEmitter;

• disallowSpaceAfterObjectKeys - Allow no space after key with align option. (Andrey Ermakov)

// this should be allowed
var f = {
    "name": 1,
    "x": 2
};

• disallowUnusedParams - correctly output unused param name (Oleg Gaidarenko)

// Should output:
// Param unusedParam is not used at input
var a = function(unusedParam) {}

• requireDollarBeforejQueryAssignment - validate all keys (Brian Dixon)

// check all keys
var x = {
  bar: 1,
  foo: $(".foo") // error here
};

• requireDollarBeforejQueryAssignment - Ignore array
  destructuring (Simen Bekkhus)

// Don't error with this
const [beep, boop] = meep;
var $s = $("#id")

• CLI - "auto-configure" argument should always be at the end
  (Oleg Gaidarenko)

// correct autoconfigure args
jscs --autoconfigure ./files/here

• js-file - make parser not confuse token types (Oleg Gaidarenko)

// Fixes issues with keywords like with
class A {
  catch() {}
}

Again, a big thanks to everything using JSCS! Definitely continue to report any bugs and new ideas! We always appreciate any help/PRs!

We'll probably be moving more of the new rule/option issues to orphaned which just means that they are on hold but anyone can still PR it or reopen it later. Remember to tweet at us at @jscs_dev and chat with us on our gitter room!

v2.3.0

Version 2.3.0 (10-07-2015):

A quick update! A few more rules, preset updates, and bug fixes!

If anyone missed it from the previous minor release, we've been working on https://github.com/cst/cst. This will help us continue to autofix more complex rules in the future. If you want to know more about it check out the changelog.

Now that we're done implementing all of ES6 the next major thing we'll be working on is intergrating CST into JSCS.

New Rules:

disallowIdenticalDestructuringNames (ES6) (Henry Zhu)

// Valid for "disallowIdenticalDestructuringNames": true
var {left, top} = obj; // shorthand
var {left, top: topper} = obj; // different identifier
let { [key]: key } = obj; // computed property

// Invalid for "disallowIdenticalDestructuringNames": true
var {left: left, top: top} = obj;

disallowNestedTernaries (Brian Dixon)

// Valid for "disallowNestedTernaries": "true"
// Valid for "disallowNestedTernaries": { "maxLevel": 0 }
var foo = (a === b) ? 1 : 2;

// Invalid for "disallowNestedTernaries": true
// Valid for "disallowNestedTernaries": { "maxLevel": 0 }
var foo = (a === b)
  ? (a === c)
    ? 1
    : 2
  : (b === c)
    ? 3
    : 4;

requireSpaceAfterComma (Brian Dixon)

To match requireSpaceBeforeComma

// Valid for "requireSpaceAfterComma": true
var a, b;

// Invalid for "requireSpaceAfterComma": true
var a,b;

Preset Updates:

• Preset: add more comma rules to jquery and airbnb presets (Oleg Gaidarenko) 94f175e
• Preset: wordpress - change requireCamelCaseOrUpperCaseIdentifiers from true to ignoreProperties 58ba037

Bug Fixes:

• Fix: disallowParenthesesAroundArrowParam - account for non-identifiers (RestElement, ArrayPattern) correctly (Henry Zhu) bcfaa51 #1831
• Fix: disallowCommaBeforeLineBreak correctly handle empty object (Oleg Gaidarenko)
  6571ebb #1841

Again, a big thanks to everything using JSCS! Definitely continue to report any bugs and new ideas! We always appreciate any help/PRs as we don't have that many resources!

Other

• disallowDanglingUnderscores: correct documentation (Oleg Gaidarenko)
• Docs: disallowMultipleVarDecl typo (ValYouW)
• Docs: couple small fixes (Oleg Gaidarenko)
• Internal: Checker - return correct arguments for excluded files (Oleg Gaidarenko)
• Misc: remove babelType and just use node.type (Henry Zhu)
• Misc: Update CHANGELOG.md (Craig Klementowski)
• Misc: Use Chai (Marat Dulin)

v2.2.1

Version 2.2.1 (09-29-2015):

Bug Fix:

Quick fix related to checker not returning correctly with excluded files.

• f12830a #1816
  • Internal: Checker - return correct arguments for excluded files (markelog)

v2.2.0

Version 2.2.0 (09-28-2015):

Again, it's been way too long since the last version; we're going to be releasing more often in the future!

In this release, we have a nicer homepage, 5 new rules, 4 more autofixable rules, many new rule options/bug fixes, and a [email protected] update.

We also added support for using YAML in config files, checking JS style in HTML files, and are trying out some non-stylistic rules (like disallowUnusedParams)!

Be on the look out for https://github.com/cst/cst (just finished ES6 support this weekend) if you haven't already.

Autofixing: Support for 4 more rules!

Thanks to @markelog, we also have autofix support for the following rules:

• disallowSemicolons
• requireSemicolons
• disallowQuotedKeysInObjects
• requireCapitalizedComments

We will also be labeling which rules don't support autofixing (only a few).

Configuration: YAML support, and linting JS in HTML files

We weren't even thinking about different config formats, but @ronkorving stepped in and added support for using YAML as a config format!

So now you can use a .jscsrc / jscs.json (JSON) file or a .jscs.yaml (YAML) file.

@lahmatiy has landed support for linting javascript in HTML files with the extract option! Thanks so much for sticking with us for that PR.

Example usage:

jscs ./hello.html --extract *.html 

New Rules

disallowMultiLineTernary (Brian Dixon)

// Valid for "disallowMultiLineTernary": true
var foo = (a === b) ? 1 : 2;

requireMultiLineTernary (Brian Dixon)

// Valid for "requireMultiLineTernary": true
var foo = (a === b)
  ? 1
  : 2;

disallowTabs (Mike Ottum)

It disallows tab characters everywhere!

disallowUnusedParams (Oleg Gaidarenko)

Another cool rule @markelog added is actually a non-stylistic rule with autofixing support! It checks to make sure you use the parameters in function declarations and function expressions!

// Invalid since test is unused
function x(test) {
}
var x = function(test) {
}

validateCommentPosition (Brian Dixon)

Comments that start with keywords like eslint, jscs, jshint are ignored by default.

/* Valid for "validateCommentPosition": { position: `above`, allExcept: [`pragma`] } */
// This is a valid comment
1 + 1; // pragma (this comment is fine)

/* Valid for "validateCommentPosition": { position: `beside` } */
1 + 1; // This is a valid comment

Just as a reminder, you can disable certain AST node types with the disallowNodeTypes rule which takes in an array of node types.

For example: if you want to disable arrow functions for some reason, you could do

"disallowNodeTypes": ['ArrowFunctionExpression'].

Presets: Idiomatic.js and other updates

We finally added support for Idiomatic.js! There are a few more rules we still need to add, so leave a comment in the issue or create a new one.

• Google: remove capitalizedNativeCase option in the JSDoc checkTypes rule (Sam Thorogood)
• Idiomatic: add initial preset (Henry Zhu)
• jQuery: add disallowSpacesInCallExpression rule to (Oleg Gaidarenko)
• jQuery: use ignoreIfInTheMiddle value for requireCapitalizedComments rule (Oleg Gaidarenko)
• jQuery: add validateIndentation rule (Oleg Gaidarenko)
• Wikimedia: enable es3 (James Forrester)

Rule Options/Changes

• requireSpacesInsideParentheses: ignoreParenthesizedExpression option (Oleg Gaidarenko)
• disallowSpaceAfterObjectKeys: add method exception option (Alexander Zeilmann)
• disallowSpaceBeforeSemicolon: add allExcept option (Oleg Gaidarenko)
• requireCapitalizedComments: add ignoreIfInTheMiddle option (Oleg Gaidarenko)
• disallowSpacesInsideParentheses: add quotes option (Oleg Gaidarenko)
• requireSpacesInsideParentheses: add quotes option (Oleg Gaidarenko)
• requireCapitalizedComments: add default exceptions (alawatthe)
• requireArrowFunctions: create an error on function bind (Henry Zhu)
• Misc: Bucket all rules into groups, test case to ensure new rules have a group (indexzero)

Bug Fixes

We fixed a bug with exit codes not matching the wiki (Oleg Gaidarenko).

• disallowParenthesesAroundArrowParam: fix check for params (Henry Zhu)
• spacesInsideBrackets: account for block comments (Oleg Gaidarenko)
• disallowSemicolons: ignore needed exceptions (Oleg Gaidarenko)
• spacesInFunctionExpression: account for async functions (MikeMac)
• disallowSpaceBeforeSemicolon: do not trigger error if it's first token (Oleg Gaidarenko)
• requireCapitalizedComments: consider edge cases (Oleg Gaidarenko)
• requireSemicolons: handle phantom cases (Oleg Gaidarenko)
• spaceAfterObjectKeys: fix for computed properties with more than one token (Henry Zhu)
• Exclude .git folder by default (Vladimir Starkov)

JSDoc updates

• New Rule: checkParamExistence
• New Rule: requireReturnDescription
• enforceExistence add paramless-procedures exception

What's JSCS?

The homepage now showcases what JSCS actually does. We were missing a 🐱 picture as well so ...

If you have any feedback on the site, leave a comment at our website repo.

༼ つ ◕_◕ ༽つ GIVE CST!

We've also been busy working on https://github.com/cst/cst.

CST stands for Concrete Syntax Tree, as opposed to AST which stands for Abstract Syntax Tree. CST uses a regular AST but adds support for information that you normally don't care about but is vital for a style checker, e.g. spaces, newlines, comments, semicolons, etc. Using a CST will allow us to support more complex autofixing such as adding curly braces while retaining other formatting or much larger transformations.

We just finished supporting all of ES6 this past weekend. ES6+ and JSX support is also in progress! We'll be integrating CST into JSCS in the 3.0 branch, so look out for that soon (CST uses babel as its AST parser).

If you're interested, there was a lot of discussion on CSTs at the ESTree repo.

---

Hopefully we can get more community help for JSCS! (check out CONTRIBUTING.md if you're interested)

We have a beginner-friendly tag for people to get started on issues.

Small personal sidenote

Thanks to everyone who has been submitting issues/PRs!

It's been almost a year since I (hzoo) really started contributing to open source. It's still crazy to me that my first pull request was just adding the table of contents. I was so excited to contribute that day!

Little did I know I would slowly do more and more - typo fixes, docs changes, bugfixes, rules, and then eventually become part of the team! I've become a better communicator and become more confident to give and take constructive feedback. I'm currently still figuring out how to review PRs, label issues, do changelogs (like right now), release, etc.

So much has happened after starting that one simple contribution! Even though I know a lot more about ASTs, javascript/node, and programming style, it all adds up to much more than that technical knowledge.

Contributing here helped me make PRs to a lot of other projects (in my case babel, eslint, and others). I understand more that it doesn't take a special person to start helping out. I really hope to encourage others to join our awesome open source community at large!

hzoo

Other Awesome Changes!

• CLI: correct describe description (Roman Dvornov)
• ClI: move handleMaxErrors helper to the more appropriate place (Oleg Gaidarenko)
• CLI: set maxErrors to Infinity for autoconfigure (Henry Zhu)
• disallowSemicolons: simplify disallowSemicolons rule (Oleg Gaidarenko)
• Docs: another portion of changelog fixes (Oleg Gaidarenko)
• Docs: Correct documentation for requireCapitalizedComments (Alexander Zeilmann)
• Docs: disallowParenthesesAroundArrowParam (Samuel Lindblom)
• Docs: fix markdown for disallowMultipleSpaces (Marián Rusnák)
• Docs: fix markdown in requireBlocksOnNewline (Marián Rusnák)
• Docs: fix markdown in requireCapitalizedComments (Marián Rusnák)
• Docs: fixup broken links (Henry Zhu)
• Docs: improve documentation for various rules (oredi)
• Docs: improve documentation for various rules (oredi)
• Docs: remove unnecessary paragraph, use js syntax highlighting (Dennis Wissel)
• Docs: small cha...

2.1.1

Version 2.1.1

Overview

This release consists mostly of bug-fixes. Check them out – there are a lot of them!

We also managed to squeeze two new rules - requireSpacesInsideParenthesizedExpression and disallowSpacesInsideParenthesizedExpression, increase performance, and improve ES6 support.

Fix regarding global jscs installs and plugins

One of the biggest issues fixed: a global jscs install can finally load local extensions (à la gulp style) like error-filters, plugins, additional rules, and presets.

This will fix issues with using a custom preset with something like SublimeLinter which uses the global jscs install.

• To make a custom preset, you need to publish a npm package with a jscs config file
• We recommend the package name starts with jscs-preset- or with jscs-config- to help with searching for presets on npm and defining it in your config
• This would allow you to specify your preset more succinctly: ”preset”: “awesome” instead of ”preset”: “jscs-preset-awesome”
• You can also share multiple presets in one package with ”preset”: “awesome/super-awesome”, provided that you have super-awesome.{json, js} in your package root directory
• Create a jscs.json file to store your jscs config
• In your package.json, set the main field to jscs.json

// example package.json in `jscs-config-awesome`
{
  “name”: “jscs-config-awesome”,
  “version”: “1.0.0”,
  “main”: “jscs.json”
}

// example .jscsrc using a custom preset
// assuming the preset package name is `jscs-config-awesome`
{
  “preset”: “awesome”,
  “disallowEmptyBlocks”: false // example of disabling a preset rule with false
}

We will add more comprehensive documentation for this feature a bit later, so stay tuned.

Disable a rule with false or null

You can use false (instead of only null) to disable a rule (such as in a preset). This was a point of confusion for newer users. To disable a rule you can do:

{
  “preset”: “airbnb”,
  “disallowEmptyBlocks”: null // disabling a rule with null
  “disallowSpacesInCallExpression”: false // disabling a rule with false
}

New Rules

• New Rule: SpacesInsideParenthesizedExpression (Richard Gibson)

Enhancements

• Configuration: disable any rule if its value equals to "false” (Oleg Gaidarenko)

Bug Fixes

• requireDollarBeforejQueryAssignment: Ignore destructuring assignment (Simen Bekkhus)
• validateIdentation: fix on empty switch blocks (Henry Zhu)
• disallowQuotedKeysInObjects: fix allowing quoted non-reserved keys (Alexej Yaroshevich)
• disallowParenthesesAroundArrowParam: allow destructuring of param (Henry Zhu)
• requireTrailingComma: correct error message (monk-time)
• requirePaddingNewLinesAfterBlocks: do not report arrow fn chaining (Oleg Gaidarenko)
• safeContextKeyword: miss destructuring assignment (Oleg Gaidarenko)
• disallowNodeTypes: correct configure error (Alexander Zeilmann)
• requireDollarBeforejQueryAssignment: Ignore destructuring assignment (Simen Bekkhus)
• paddingNewlinesInBlocks: add exceptions and open/close options (Kai Cataldo)
• requireSpacesInAnonymousFunctionExpression: add allExcept option (Ken Sheedlo)
• curlyBraces: support for..of statements (regseb)

Misc

• Configuration: allow load of external entities from external preset (Oleg Gaidarenko)
• CLI:Configuration: load local jscs modules if present (Oleg Gaidarenko)
• JsFile: Improve getNodeByRange performance (Richard Gibson)
• disallowQuotedKeysInObjects: rework tests and deprecate allButReserved value (Alexej Yaroshevich)

Docs

• Docs: update examples on how to disable (Oleg Gaidarenko)
• Docs: improve documentation for various rules (oredi)
• Docs: fix typos in examples for disallowSpaceAfterObjectKeys (Yoni Medoff)
• Docs: improve documentation for various rules (oredi)
• Docs: small changelog corrections (Oleg Gaidarenko)
• Docs: make it clearer node_modules is excluded, and ! can be used to include (Henry Zhu)

2.1.0

Version 2.1.0

Overview

In this release, we added three more rules: two of them are ES6-only, they "protect" you
from the downside of arrow functions (see 1 and 2 for an explanation of why you might want to enable them) and another universal one if you like to keep your object neat and tidy.

Airbnb, jQuery, and Wordpress presets are now using some of the new rules we added in the previous release. Whereas, the wikimedia preset is now less strict for JSDoc comments.

This release also includes a JSON reporter, lots of bug fixes and enhancements, plus couple new rule values for your linting pleasure.

Presets

• Preset: define exclusions for wordpress preset (Weston Ruter)
• Preset: add couple new rules to airbnb preset (Christophe Hurpeau)
• Preset: Set jsDoc.checkTypes to "strictNativeCase" for Wikimedia (Timo Tijhof)
• Preset: add "disallowSpaceBeforeComma" rule to jquery preset (Oleg Gaidarenko)

New rules

• New Rule: disallowShorthandArrowFunctions (Jackson Ray Hamilton)
• New Rule: disallowArrowFunctions (Jackson Ray Hamilton)
• New Rule: validateOrderInObjectKeys (Rui Marinho)

New rule values

• disallowEmptyBlocks: allow blocks with comments (Michael Robinson)
• requirePaddingNewlinesAfterUseStrict: allow immediate "require" (Michael Robinson)
• requireAnonymousFunctions: Add exception for function declarations (Kai Cataldo)
• requireBlocksOnNewline: Add object option to handle comments (oredi)
• requireTemplateString: string and template string concatentation support (Michelle Bu)

Enhancements

• Configuration: allow load configs with ".jscsrc" extension (Oleg Gaidarenko)
• Reporters: add new JSON reporter (Roman Blanco)
• Configuration: extend and improve default value of array options (Oleg Gaidarenko)
• SpaceBeforeObject(Keys|Values): support spread in object literals (Ronn Ross)
• SpacesInAnonymousFunctionExpression: consider ES6 "constructor" method (Oleg Gaidarenko)
• validateIndentation: reduce RegExp create count (optimization) (Roman Dvornov)
• validateAlignedFunctionParameters: small simplification (Oleg Gaidarenko)
• disallowEmptyBlocks: should not report empty arrow blocks (Jake Zatecky)
• validateAlignedFunctionParameters: account for arrow functions (Jake Zatecky)
• requirePaddingNewlinesAfterBlocks: ignore parentheses of last item (Christophe Hurpeau)

Bugs

• requireMatchingFunctionName: fix critical bug and add tests (Alexej Yaroshevich)
• disallowSpacesInCallExpression: report only on a node's round brace (Joel Kemp)
• disallowSpacesInCallExpression: consider fitting parentheses case (Oleg Gaidarenko)
• CLI: correct reporter error (Roman Dvornov)
• SpacesIn*: fix for shorthand methods/class methods, update tests (Henry Zhu)
• requireAlignedObjectValues: fix computed keys with MemberExpressions (Henry Zhu)
• requireParenthesesAroundArrowParam: account for a single rest parameter (Henry Zhu)
• requirePaddingNewLinesBeforeLineComments: fix for newlines above comment (Henry Zhu)

Docs

• Docs: Fix a typo in requireVarDeclFirst (Chayoung You)
• Docs: point to jscs.info for the list of maintainers (Oleg Gaidarenko)
• Docs: improve preset documentation (Oleg Gaidarenko)
• Docs: Fix typos in requireCapitalizedComments (Chayoung You)
• Docs: Fix a typo in maximumNumberOfLines (Chayoung You)
• Docs: Add justifications for arrow function rules (Jackson Ray Hamilton)
• Docs: correct docs for the" disallowNodeTypes" rule (Dmitry Semigradsky)
• Docs: Fixed typo, update link for clarity/correct URL (Kai Cataldo)
• Docs: Fixed typo in disallowSpaceAfterObjectKeys (Brian Ng)
• Docs: use correct links to new rules (Pavel Zubkou)
• Docs: bring back coveralls badge (Oleg Gaidarenko)
• Docs: Error 404 on the requireObjectKeysOnNewLine link (Roman Nuritdinov)
• Docs: Link to built-in JSCS plugin for JetBrains IDEs (Simen Bekkhus)
• Docs: improve and correct the changelog (Oleg Gaidarenko)
• Docs: small example improvement for "disallowSpaceBeforeComma" rule (Oleg Gaidarenko)

Misc

• requireLineFeedAtFileEnd: Test to ensure IIFE case still reports (Joel Kemp)
• Misc: add Henry to list of maintainers (Oleg Gaidarenko)
• Misc: make jshint happy (Oleg Gaidarenko)
• Misc: exclude only problematic module from coverage (Oleg Gaidarenko)
• Misc: once again hide coverage status (Oleg Gaidarenko)
• Misc: correct merge artefact (Oleg Gaidarenko)
• Misc: support spread in object literals (Henry Zhu)
• Misc: update Esprima to 2.5.0 (Henry Zhu)
• Misc: cache node_modules dir in travis CI (Oleg Gaidarenko)
• AutoConfigure: Tests now depend on a preset clone (Joel Kemp)
• Revert "Changelog: use conventional-change..." (Oleg Gaidarenko)
• Changelog: use conventional-changelog and conventional-github-releaser (Steve Mao)

2.0.0

Version 2.0.0

Overview

Gosh! We haven’t released a new version in more than two months! What have we done all this time?
Well, we were working hard on the next big step - 2.0!

And we’re finally ready to show it to you. We’ve improved JSCS all over the place!

esnext

It was a big pain to check ES6/JSX code with JSCS, since you had to install special extensions or different parsers. Well, no more of that! Thanks to all the hard work of the @hzoo, now you can just write "esnext": true in your config or execute JSCS from the CLI with the --esnext flag.
Now all that new fancy code will be examined without any hassle, as decorators, function bind (::) operator, and all valid babel code can be checked by JSCS.

We also added seven ES6-only rules; see below for more information.

Autofixing

We really want to support autofixing for as many rules as possible. But as it turns out, we are at forefront of this problem; it’s really hard to change the code without affecting unrelated instructions.

What we need is a Concrete Syntax Tree, instead of the AST + tokens structures that we use now. Unfortunately, there is no CST standard for JavaScript at the moment – this is why we decided to step up and come up with our vision of a CST - https://github.com/mdevils/cst. Currently, we are working with the estree team on this proposal – hoping the development of this crucial part of JavaScript parsing will move faster.

Meanwhile, using some workarounds and hacks, we managed to support autofixing for 4 more rules:

• requireTrailingComma
• disallowTrailingComma
• disallowTrallingWhitespace
• validateQuoteMarks

New rules

There are 31 new rules, including 16 rules for JSDoc validation, and 7 ES6-only rules:

• requireSpaceBeforeComma
  Require spaces before commas
• disallowSpaceBeforeComma
  Disallow spaces before commas
• requireVarDeclFirst
  Requires var declaration to be on the top of an enclosing scope
• disallowSpaceBeforeSemicolon
  Disallows spaces before semicolons.
• requireMatchingFunctionName
  Requires function names to match member and property names.
• disallowNodeTypes
  Disallow use of certain node types (from Esprima/ESTree).
• requireObjectKeysOnNewLine
  Requires placing object keys on new line
• disallowObjectKeysOnNewLine
  Disallows placing object keys on new line

New ES6-only rules

• disallowParenthesesAroundArrowParam
  Disallows parentheses around arrow function expressions with a single parameter.
• requireArrowFunctions
  Requires that arrow functions are used instead of anonymous function expressions in callbacks.
• requireNumericLiterals
  Requires use of binary, hexadecimal, and octal literals instead of parseInt.
• requireParenthesesAroundArrowParam
  Requires parentheses around arrow function expressions with a single parameter.
• requireShorthandArrowFunctions
  Require arrow functions to use an expression body when returning a single statement
• requireSpread
  Disallows using .apply in favor of the spread operator
• requireTemplateStrings
  Requires the use of template strings instead of string concatenation.

There are also a lot of new rule values (see the "Changelog" section) which makes a lot of rules more flexible.

We also added new rules and values to some presets. If you feel that we’ve missed something, don't be quiet! Send us a PR and we will surely add the needed rules to your favorite preset.

Simplified inclusion of plugins, presets, and custom rules

Since every possible JSCS extension can now be loaded without defining its full path, it is enough to just specify the needed dependency to your project so it can be found by JSCS.

{
  "plugins": ["./your-local-package"], // Same with `additionalRules` and `preset` options
  "plugins": ["jscs-your-npm-package"],
  "plugins": ["your-npm-package"], // can omit “jscs-” prefix if you want
}

Other

• Support for disabling rules on a single line -

if (x) y(); // jscs:ignore requireCurlyBraces
if (z) a(); // will show the error with `requireCurlyBraces`

• Two new reporters - summary (could be very helpful to acquire full overview of all possible errors in your project) and unix. You could enable them by providing --reporter=<reporter name> flag.
• node_modules path is included by default to excludeFiles
• For every possible error, like missing or corrupted config, JSCS now provides different exit-codes. We believe it might be useful for piping, editors plugins, etc.
• JSCS (like any good unix program) now obeys the rule of silence.

And of course, a lot of bug-fixes, improved ES6 support of existing rules, docs, infrastructure changes, etc.

Although this is major version, we didn't remove deprecated rule values or changed config format, we expecting to do this in the 3.0 version while switching to CST and fully refactor JSCS code-base.

Changelog

Backward incompatible changes

• Utils: remove comma from list of binary operators (Oleg Gaidarenko)
• Checker: remove deprecated constructor options (Oleg Gaidarenko)
• Obey the Rule of Silence (Feross Aboukhadijeh)
• Configuration: add ability to load external presets (Oleg Gaidarenko)
• Configuration: small corrections to JSDoc of "node-configuration" module (Oleg Gaidarenko)
• Configuration: small refactoring of the configuration module (Oleg Gaidarenko)
• Configuration: allow "getReporter" method to require node modules (Oleg Gaidarenko)
• Configuration: initial pass on the polymorphic require (Oleg Gaidarenko)
• Checker: more API changes for 2.0 (Oleg Gaidarenko)
• CLI: Differentiate exit codes (Oleg Gaidarenko)
• Misc: set default value of maxErrors option to 50 (Oleg Gaidarenko)
• yodaConditions: remove comparison operators from default set (Oleg Gaidarenko)
• Misc: remove all deprecated rules/tests (Henry Zhu)
• API: allow external entities to be defined without "jscs" prefix (Oleg Gaidarenko)
• Configuration: exclude node_modules/ by default (Louis Pilfold)
• CLI: set "maxErrors" to Infinity with enabled "fix" option (Oleg Gaidarenko)
• Misc: change default dialect to es5 and make appropriate changes (Alexej Yaroshevich)

Autofix

• Autofix: remove merge artefact (Oleg Gaidarenko)
• Autofix: support disallowTrailingComma rule (Oleg Gaidarenko)
• Autofix: support trailing whitespaces and missing commas (Andrzej Wamicz)
• validateQuoteMarks: try out "fix" field (Oleg Gaidarenko)

Preset

• Preset: requireSemicolons = true for google preset (BigBlueHat)
• Preset: add jsDoc rules to relevant presets (Oleg Gaidarenko)
• Preset: add disallowTrailingWhitespace to MDCS (Joshua Koo)
• Preset: add requireVarDeclFirst rule to the relevant presets (Oleg Gaidarenko)
• Preset: update Wordpress preset (Ivo Julca)
• Preset: add requireCapitalizedComments to jquery and wordpress presets (Oleg Gaidarenko)
• Preset: update mdcs (Joshua Koo)
• Preset: require trailing comma in airbnb preset (Christophe Hurpeau)
• Preset: add missing rules to google preset (Christophe Hurpeau)
• Preset: update airbnb preset (Craig Jennings)
• Preset: update jquery and dependant presets (Oleg Gaidarenko)
• Preset: require spaces in anonymous FE for crockford style (Oleg Gaidarenko)
• Preset: fix requireDotNotation rule value according to es3 changes (Alexej Yaroshevich)
• Preset: remove jsdoc rules from yandex preset (Oleg Gaidarenko)

New rules

• New rules: add SpaceBeforeComma rules (shashanka)
• New Rule: requireVarDeclFirst (oredi)
• New Rule: add JSDoc rules (Oleg Gaidarenko)
• New Rule: (disallow|require)SpaceBeforeSemicolon (Richard Munroe)
• New Rule: requireMatchingFunctionName (Pavel Strashkin)
• New Rule: requireTemplateStrings (Henry Zhu)
• New Rule: (require|disallow)ParenthesesAroundArrowParam (Henry Zhu)
• New Rule: requireSpread (Henry Zhu)
• New Rule: requireShorthandArrowFunctions (Henry Zhu)
• New Rule: requireArrowFunctions (Henry Zhu)
• New Rule: disallowNodeTypes (Henry Zhu)
• New Rule: requireNumericLiterals (Henry Zhu)
• New Rule: (disallow|require)ObjectKeysOnNewLine (Eli White)

New rule values

• requireYodaConditions: support an array of operators (Ivo Julca)
• ...

v1.13.1

Version 1.13.1

Overview

Small update for fix distribution of the --esnext CLI option (#1321)

Bug fixes

• CLI: use "esnext" cli option in the configuration module (Oleg Gaidarenko)
• CLI: ensure options to path.resolve are strings (Jason Karns)
• disallowMultipleSpaces: fix configuration error message (Marc Knaup)

Docs

• Docs: correct example for the "requireCapitalizedComments" rule (XhmikosR)
• Docs: Update mixup between rules in docstring example (Jérémie Astori)
• Docs: Fix missing quotes in a docstring example (Jérémie Astori)