Please document no-restricted-syntax

After moving to eslint-config-airbnb-base from eslint-config-airbnb I am now getting warnings related to the no-restricted-syntax rule (specified here), but no documentation backing this up exists in README.md.

Can the documentation be updated explaining the reasoning behind the choices in this rule?

---

In my particular case this was triggered on a for...in loop, so I’m guessing that having ForInStatement in the list of forbidden nodes would fall into the Iterators and Generators section.

[ljharb]

@danez Object.keys(obj).forEach(key => { obj[key] }) - same works with Object.entries and Object.values, and with all the array iteration methods. There’s never a need to use a loop.

[lxcid]

Since async/await is stage 3 and there’s no way to async/await with higher-order functions like forEach, this is too restrictive for me.

for (const userProps in users) {
  await createUser(userProps);
}