docs: Describe guard options for guard-for-in (#16986)

alope107 · web-flow · commit 5251a921866e · 2023-03-15T10:07:27.000+01:00
Describes the different checks that can be used to satisfy
guard-for-in and links prefer-object-has-own as a related rule.
diff --git a/docs/src/rules/guard-for-in.md b/docs/src/rules/guard-for-in.md
@@ -2,6 +2,7 @@
 title: guard-for-in
 rule_type: suggestion
 related_rules:
+- prefer-object-has-own
 - no-prototype-builtins
 further_reading:
 - https://javascriptweblog.wordpress.com/2011/01/04/exploring-javascript-for-in-loops/
@@ -17,6 +18,10 @@ for (key in foo) {
 }
 ```
 
+For codebases that do not support ES2022, `Object.prototype.hasOwnProperty.call(foo, key)` can be used as a check that the property is not inherited.
+
+For codebases that do support ES2022, `Object.hasOwn(foo, key)` can be used as a shorter alternative; see [prefer-object-has-own](prefer-object-has-own).
+
 Note that simply checking `foo.hasOwnProperty(key)` is likely to cause an error in some cases; see [no-prototype-builtins](no-prototype-builtins).
 
 ## Rule Details
