From 0751cd80b1bf9e3fbbb757fd4f6d9c2d2a5e899b Mon Sep 17 00:00:00 2001
From: jGowgiel <jroddg@gmail.com>
Date: Sat, 2 Dec 2023 00:04:16 -0800
Subject: [PATCH] Extend the getTargetRanges method documentation (#30718)

---
 .../api/inputevent/gettargetranges/index.md   | 38 +++++++++++++++++++
 1 file changed, 38 insertions(+)

diff --git a/files/en-us/web/api/inputevent/gettargetranges/index.md b/files/en-us/web/api/inputevent/gettargetranges/index.md
index d975078c4da2492..8cfe5ae723ed2ec 100644
--- a/files/en-us/web/api/inputevent/gettargetranges/index.md
+++ b/files/en-us/web/api/inputevent/gettargetranges/index.md
@@ -12,6 +12,44 @@ The **`getTargetRanges()`** method of the {{domxref("InputEvent")}} interface re
 
 This allows web apps to override text edit behavior before the browser modifies the DOM tree, and provides more control over input events to improve performance.
 
+Depending on the value of `inputType` and the current editing host, the expected return value of this method varies:
+
+<table>
+  <thead>
+    <tr>
+      <th>inputType</th>
+      <th>Editing host</th>
+      <th>Response of <code>getTargetRanges()</code></th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td><code>"historyUndo"</code> or <code>"historyRedo"</code></td>
+      <td>Any</td>
+      <td>empty Array</td>
+    </tr>
+    <tr>
+      <td>All remaining</td>
+      <td><code>contenteditable</code></td>
+      <td>
+        an Array of
+        {{domxref("StaticRange")}}
+        objects associated with event
+      </td>
+    </tr>
+    <tr>
+      <td>All remaining</td>
+      <td>
+        <a href="/en-US/docs/Web/HTML/Element/input"><code>input</code></a>
+        or <a href="/en-US/docs/Web/HTML/Element/textarea"><code>textarea</code></a>
+      </td>
+      <td>
+        an empty Array
+      </td>
+    </tr>
+  </tbody>
+</table>
+
 ## Syntax
 
 ```js-nolint