Description / Features

The plugin enables analysis of JavaScript projects within Sonar.

Installation

1. Install the JavaScript plugin through the Update Center or download it into the SONAR_HOME/extensions/plugins directory
2. Restart the Sonar server

Usage

You can analyze your project with the different analyzers. Here are properties files examples for the Sonar Runner and Maven.

A list of sample projects is available on github that can be browsed or downloaded:

1. JavaScript project analyzed with the Sonar Runner: /projects/languages/javascript/javascript-sonar-runner.
2. JavaScript project analyzed with the Sonar Runner reusing unit tests and code coverage reports generated with JsTestDriver: /projects/languages/javascript/javascript-sonar-runner-JsTestDriver
3. JavaScript project analyzed with Maven reusing unit tests and code coverage reports generated with JsTestDriver (integrated through jstd-maven-plugin): /projects/languages/javascript/javascript-maven-JsTestDriver

Extending Coding Rules using XPath

New coding rules can be added using XPath. See the related documentation.

To navigate the AST, download the SSLR JavaScript Toolkit.

Changelog

Release 1.1 (20 issues)
Type	Key	Summary	Priority	Status	Resolution
	SONARPLUGINS-2047	Upgrade to SSLR 1.14		Closed	Fixed
	SONARPLUGINS-2045	When a JavaScript file starts with the BOM(Byte Order Mark) character, the source code can't be parsed		Closed	Fixed
	SONARPLUGINS-2043	The Javascript analyser doesn't support the HTML comment embedded into the javascript source code		Closed	Fixed
	SONARPLUGINS-2079	Rule AlwaysUseCurlyBracesCheck should not produce false-positive in case of 'if-else-if'		Closed	Fixed
	SONARPLUGINS-1957	Compound and labelled statements should not be included into metric 'statements'		Closed	Fixed
	SONARPLUGINS-1955	Improve performance of parser by refactoring of grammar		Closed	Fixed
	SONARPLUGINS-1951	Follow best-practice: replace NOK by Non-Compliant and OK by Compliant in descriptions of rules		Closed	Fixed
	SONARPLUGINS-1949	Unable to lex regular expression literal which contains "/"		Closed	Fixed
	SONARPLUGINS-2183	Make the Javascript plugin support the Developer Cockpit plugin by providing the measures comments and loc by line		Closed	Fixed
	SONARPLUGINS-2235	Rule: Avoid switch without default clause		Closed	Fixed
	SONARPLUGINS-2213	Prevent conflicts in l10n of description for JavaScript rules		Closed	Fixed
	SONARPLUGINS-2208	Embed the sonar-common-rules library		Closed	Fixed
	SONARPLUGINS-2200	Misleading position of violation for rule AlwaysUseCurlyBraces		Closed	Fixed
	SONARPLUGINS-2197	Remove metric comment_blank_lines		Closed	Fixed
	SONARPLUGINS-2292	Rule CommentedCode should not produce false-positive in JSDoc comments		Closed	Fixed
	SONARPLUGINS-2290	Rule: Do not use HTML comments, because they are not part of EcmaScript specification		Closed	Fixed
	SONARPLUGINS-2282	Rule: Avoid using 'continue' branching statement		Closed	Fixed
	SONARPLUGINS-2249	Provide new version of sslr-javascript-toolkit instead of javascript-devkit		Closed	Fixed
	SONARPLUGINS-2236	Rule: An unconditional break statement shall terminate every non-empty switch-clause		Closed	Fixed
	SONARPLUGINS-2178	Rule NestedIfDepthCheck should not produce false-positive in case of 'if-else-if'		Closed	Fixed

Release 1.0 (36 issues)
Type	Key	Summary	Priority	Status	Resolution
	SONARPLUGINS-1842	Rule: Avoid use of parentheses where not required by syntax or semantics		Closed	Fixed
	SONARPLUGINS-1841	Rule: Detect conditional operators		Closed	Fixed
	SONARPLUGINS-1840	Rule: "UnreachableCore" - return, break, continue, or throw statements should be followed by a } or case or default.		Closed	Fixed
	SONARPLUGINS-1829	Do not use jslint4java		Closed	Fixed
	SONARPLUGINS-1828	Rule: Avoid trailing comma in array and object literals		Closed	Fixed
	SONARPLUGINS-1826	Rule: Avoid doing assignments in the condition part of if/while/for statements		Closed	Fixed
	SONARPLUGINS-1827	Rule: Only while/do/for statements can be labelled		Closed	Fixed
	SONARPLUGINS-1823	Rule: Use single quote for string literals		Closed	Fixed
	SONARPLUGINS-1822	Rule: Do not allow function declarations within blocks		Closed	Fixed
	SONARPLUGINS-1820	Rule: Do not use wrapper objects for primitive types		Closed	Fixed
	SONARPLUGINS-1817	Rule: Do not use Array and Object constructors		Closed	Fixed
	SONARPLUGINS-1816	Rule: Avoid multiline string literals		Closed	Fixed
	SONARPLUGINS-1819	Rule: For-in statement must filter items		Closed	Fixed
	SONARPLUGINS-1818	Rule: Avoid usage of bitwise operators		Closed	Fixed
	SONARPLUGINS-1814	Rule: Each statement must end with a semicolon		Closed	Fixed
	SONARPLUGINS-1815	Rule: Always use curly braces for if/else/for/while/do statements		Closed	Fixed
	SONARPLUGINS-1813	Rule: Avoid usage of with statement		Closed	Fixed
	SONARPLUGINS-1812	Rule: One statement per line		Closed	Fixed
	SONARPLUGINS-1811	Rule: Regular expression on comment		Closed	Fixed
	SONARPLUGINS-1808	Rule: Avoid usage of == and !=		Closed	Fixed
	SONARPLUGINS-1806	Rule: Avoid usage of eval		Closed	Fixed
	SONARPLUGINS-1809	Rule: Line too long		Closed	Fixed
	SONARPLUGINS-1807	Rule: Avoid usage of debugger statement		Closed	Fixed
	SONARPLUGINS-1799	Rule: Avoid too complex function		Closed	Fixed
	SONARPLUGINS-1855	Rule: Avoid deeply nested if statements		Closed	Fixed
	SONARPLUGINS-1703	Problem in the calculation of cyclomatic complexity		Closed	Fixed
	SONARPLUGINS-1702	Support for JsTest unit test execution and code coverage reports should be added		Closed	Fixed
	SONARPLUGINS-1794	Rule: When there is a parsing error, this error should be added like a violation on that JavaScript file		Closed	Fixed
	SONARPLUGINS-1795	Rule: Detect commented-out lines of code		Closed	Fixed
	SONARPLUGINS-1790	Metric: blank comments		Closed	Fixed
	SONARPLUGINS-1792	Provide "Sonar Way" profile for JavaScript		Closed	Fixed
	SONARPLUGINS-1791	Metric: statements		Closed	Fixed
	SONARPLUGINS-1793	Rule: Generic JavaScript rule to define some homemade checks with an XPath expression		Closed	Fixed
	SONARPLUGINS-1789	Integrate JavaScript parser based on SSLR		Closed	Fixed
	SONARPLUGINS-1788	Provide JavaScript rule engine based on SSLR		Closed	Fixed
	SONARPLUGINS-1796	Provide a default SQALE mapping for the JavaScript rules		Closed	Fixed

Release 0.4 (5 issues)
Type	Key	Summary	Priority	Status	Resolution
	SONARPLUGINS-1625	NullPointer on loading test file		Closed	Fixed
	SONARPLUGINS-1587	Support of JsTestDriver unit test execution and code coverage reports should be added		Closed	Fixed
	SONARPLUGINS-1319	Doesn't work with SCM Plugin		Closed	Fixed
	SONARPLUGINS-1295	Cannot specify sonar.javascript.lslint.predef in POM		Closed	Fixed
	SONARPLUGINS-1139	Cannot define multiple predefined variables		Closed	Fixed

Release 0.3 (1 issues)
Type	Key	Summary	Priority	Status	Resolution
	SONARPLUGINS-1006	Migrate JavaScript plugin from code.google.com to Codehaus		Closed	Fixed

Roadmap Ideas

• Add support for Jasmine