Adding upstream version 115.7.0esr.upstream/115.7.0esrupstream

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 33 insertions, 0 deletions

diff --git a/docs/code-quality/lint/linters/eslint-plugin-mozilla/use-chromeutils-generateqi.rst b/docs/code-quality/lint/linters/eslint-plugin-mozilla/use-chromeutils-generateqi.rst
new file mode 100644
index 0000000000..3da22e139a
--- /dev/null
+++ b/docs/code-quality/lint/linters/eslint-plugin-mozilla/use-chromeutils-generateqi.rst
@@ -0,0 +1,33 @@
+use-chromeutils-generateqi
+==========================
+
+Reject use of ``XPCOMUtils.generateQI`` and JS-implemented QueryInterface
+methods in favor of ``ChromeUtils``.
+
+Examples of incorrect code for this rule:
+-----------------------------------------
+
+.. code-block:: js
+
+    X.prototype.QueryInterface = XPCOMUtils.generateQI(["nsIMeh"]);
+    X.prototype = { QueryInterface: XPCOMUtils.generateQI(["nsIMeh"]) };
+    X.prototype = { QueryInterface: function QueryInterface(iid) {
+      if (
+        iid.equals(Ci.nsISupports) ||
+        iid.equals(Ci.nsIMeh) ||
+        iid.equals(nsIFlug) ||
+        iid.equals(Ci.amIFoo)
+      ) {
+        return this;
+      }
+      throw Components.Exception("", Cr.NS_ERROR_NO_INTERFACE);
+    } };
+
+
+Examples of correct code for this rule:
+---------------------------------------
+
+.. code-block:: js
+
+    X.prototype.QueryInterface = ChromeUtils.generateQI(["nsIMeh"]);
+    X.prototype = { QueryInterface: ChromeUtils.generateQI(["nsIMeh"]) }