rspec/rules/S1535/javascript/rule.adoc

== Why is this an issue?

The ``++for...in++`` statement allows you to loop through the names of all of the properties of an object. The list of properties includes all those properties that were inherited through the prototype chain. This has the side effect of serving up functions when the interest is in data properties. Programs that don't take this into account can fail.


Therefore, the body of every ``++for...in++`` statement should be wrapped in an ``++if++`` statement that filters which properties are acted upon. It can select for a particular type or range of values, or it can exclude functions, or it can exclude properties from the prototype.


=== Noncompliant code example

[source,javascript]
----
for (name in object) {
    doSomething(name);  // Noncompliant
}
----


=== Compliant solution

[source,javascript]
----
for (name in object) {
  if (object.hasOwnProperty(name)) {
    doSomething(name);
  }
}
----


=== Exceptions

Loops used to clone objects are ignored.

[source,javascript]
----
for (prop in obj) {
  a[prop] = obj[prop];  // Compliant by exception
}
----

ifdef::env-github,rspecator-view[]

'''
== Implementation Specification
(visible only on this page)

=== Message

Restrict what this loop acts on by testing each property.


endif::env-github,rspecator-view[]