Fred Tingaud 16f6c0aecf
Inline adoc when include has no additional value (#1940)
Inline adoc files when they are included exactly once.

Also fix language tags because this inlining gives us better information
on what language the code is written in.
2023-05-25 14:18:12 +02:00

80 lines
2.0 KiB
Plaintext

== Why is this an issue?
The unary operators ``+`` and ``++-++`` can be used to convert some value types to numeric values. But not every value can be converted to a ``++Number++`` type; use it with an object, and result will be ``++NaN++`` (Not A Number). This can be confusing to maintainers.
=== Noncompliant code example
[source,javascript]
----
var obj = {x : 1};
doSomethingWithNumber(+obj); // Noncompliant
function foo(){
return 1;
}
doSomethingWithNumber(-foo); // Noncompliant
----
=== Compliant solution
[source,javascript]
----
var obj = {x : 1};
doSomethingWithNumber(+obj.x);
function foo(){
return 1;
}
doSomethingWithNumber(-foo());
var str = '42';
doSomethingWithNumber(+str);
----
=== Exceptions
Unary ``{plus}`` and ``++-++`` can be used with objects corresponding to primitive types, and ``{plus}`` can be used with ``++Date++``.
[source,javascript]
----
var b = new Boolean(true);
doSomethingWithNumber(-b); // Compliant
var timestamp = +new Date(); // Compliant
----
ifdef::env-github,rspecator-view[]
'''
== Implementation Specification
(visible only on this page)
=== Message
Remove this use of unary {0}.
'''
== Comments And Links
(visible only on this page)
=== on 4 Jun 2015, 12:42:37 Elena Vilchik wrote:
\[~ann.campbell.2] Assign to you for validation and completion (labels, SQALE). CC [~linda.martin]
=== on 4 Jun 2015, 14:21:18 Ann Campbell wrote:
Please double-check my changes [~elena.vilchik]
=== on 4 Jun 2015, 15:36:58 Elena Vilchik wrote:
\[~ann.campbell.2] I added "Exceptions". Check it, please.
=== on 4 Jun 2015, 18:35:32 Ann Campbell wrote:
\[~elena.vilchik] the exceptions look fine, but w/r/t the code samples, we can't just introduce something totally new in the Compliant Solution. The compliant solution shows the Noncompliant example in a "fixed" state. That's why I had added the string example to the Noncompliant solution, marked "compliant".
=== on 16 Jan 2020, 14:18:03 Elena Vilchik wrote:
Deprecated (see details \https://github.com/SonarSource/SonarJS/issues/1810)
endif::env-github,rspecator-view[]