docs: add known limitations for no-self-compare (#19612)

snitin315 · web-flow · commit f80b746d8500 · 2025-04-09T14:15:26.000+02:00
diff --git a/docs/src/rules/no-self-compare.md b/docs/src/rules/no-self-compare.md
@@ -26,3 +26,32 @@ if (x === x) {
 ```
 
 :::
+
+## Known Limitations
+
+This rule works by directly comparing the tokens on both sides of the operator. It flags them as problematic if they are structurally identical. However, it doesn't consider possible side effects or that functions may return different objects even when called with the same arguments. As a result, it can produce false positives in some cases, such as:
+
+::: incorrect
+
+```js
+/*eslint no-self-compare: "error"*/
+
+function parseDate(dateStr) {
+  return new Date(dateStr);
+}
+
+if (parseDate('December 17, 1995 03:24:00') === parseDate('December 17, 1995 03:24:00')) {
+  // do something
+}
+
+let counter = 0;
+function incrementUnlessReachedMaximum() {
+  return Math.min(counter += 1, 10);
+}
+
+if (incrementUnlessReachedMaximum() === incrementUnlessReachedMaximum()) {
+  // ...
+}
+```
+
+:::
