• Home
• fr.sii.sonar
• sonar-web-frontend-js
• 2.0.0
• source code
• W068.html

×

Project download

Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance.
Project price only 1 $

You can buy this project and download/modify it how often you want.

rules.jshint.W068.html Maven / Gradle / Ivy

    
History
This warning has existed in two forms across the three main linters. It was
introduced in a very early version of JSLint and has remained in all three tools
ever since.

In JSLint and JSHint prior to version 1.0.0 the warning given is "Do not
wrap function literals in parens unless they are to be immediately invoked"

In JSHint since 1.0.0 the warning given is "Wrapping non-IIFE function
literals in parens is unnecessary."

In ESLint the warning has always been "Wrapping non-IIFE function literals
in parens is unnecessary."


The situations that produce the warning have not changed despite changes to the
text of the warning itself. If you have not come across the acronym "IIFE"
before, you may be interested in Ben Alman's article on the subject, in
which he coins the term to stand for "Immediately Invoked Function Expression".
When do I get this error?
The "Do not wrap function literals in parens unless they are to be immediately
invoked" error (and the alternative "Wrapping non-IIFE function literals in
parens is unnecessary" error) are thrown when JSLint, JSHint or ESLint
encounters a function expression wrapped in parentheses with no following
invoking parentheses. JSHint will throw this error in the same situation, but
only if the immed option is set to true. In the following example we assign
a function expression to a variable x:
​x
 
1
/*jshint immed: true */
2
var x = (function () {
3
    "use strict";
4
    return 10;
5
});
6
​
JSLint found 1 error
Which linter should be used for this code snippet:
 JSLint JSHint ESLint
Which version of the linter should be used:
Update
Version 2015-09-23
Line 1:
Don't wrap function literals in parens.

Why do I get this error?
This error is raised to highlight a potentially confusing piece of code. It
is common in JavaScript to see immediately invoked function expressions. Here's
the above snippet again, this time with the invoking parentheses. Notice how
subtle the difference is:
5
 
1
var x = (function () {
2
    "use strict";
3
    return 10;
4
}());
5
​
JSLint found no errors
Which linter should be used for this code snippet:
 JSLint JSHint ESLint
Which version of the linter should be used:
Update
Version 2015-09-23

While the difference may not look like much, the two snippets are completely
different in their behaviour. The first example (which does not pass JSLint)
will result in a function expression assigned to x. The second snippet will
result in the return value of that function assigned to x.
When you see a function expression wrapped in parentheses, you would usually
expect it to be an immediately invoked function expression. When it isn't, there
is greater potential for confusion and misunderstanding of your code.
In JSHint 1.0.0 and above you have the ability to ignore any warning with a
special option syntax. The identifier of this warning is W068.
This means you can tell JSHint to not issue this warning with the /*jshint
-W068 */ directive.
In ESLint the rule that generates this warning is named no-wrap-func. You can
disable it by setting it to 0, or enable it by setting it to 1.