Added Elements.deselectAll(), like clear() but no DOM impact

Fixes #2100

Also added see references

Author: jhy

CHANGES.md

@@ -8,7 +8,8 @@
 
 * `Element.cssSelector()` will prefer to return shorter selectors by using ancestor IDs when available and unique. E.g.
   `#id > div > p` instead of  `html > body > div > div > p` [#2283](https://github.com/jhy/jsoup/pull/2283).
-* Added `Elements.deselect(int index)` and `Elements.deselect(Object o)` methods to remove elements from the `Elements`
+* Added `Elements.deselect(int index)`, `Elements.deselect(Object o)`, and `Elements.deselectAll()` methods to remove
+  elements from the `Elements`
   list without affecting the DOM. And added `Elements.asList()` method to get a modifiable list of elements without
   affecting the DOM. (Each Element is still connected to the DOM.) [#2100](https://github.com/jhy/jsoup/issues/2100).
 

src/main/java/org/jsoup/select/Elements.java

@@ -732,9 +732,10 @@ private <T extends Node> List<T> childNodesOfType(Class<T> tClass) {
 
     /**
      Remove the Element at the specified index in this ist, and from the DOM.
-     * @param index the index of the element to be removed
-     * @return the old element at this index
-     * @since 1.17.1
+     @param index the index of the element to be removed
+     @return the old element at this index
+     @see #deselect(int)
+     @since 1.17.1
      */
     @Override public Element remove(int index) {
         Element old = super.remove(index);
@@ -744,9 +745,10 @@ private <T extends Node> List<T> childNodesOfType(Class<T> tClass) {
 
     /**
      Remove the specified Element from this list, and from the DOM.
-     * @param o element to be removed from this list, if present
-     * @return if this list contained the Element
-     * @since 1.17.1
+     @param o element to be removed from this list, if present
+     @return if this list contained the Element
+     @see #deselect(Object)
+     @since 1.17.1
      */
     @Override public boolean remove(Object o) {
         int index = super.indexOf(o);
@@ -759,35 +761,46 @@ private <T extends Node> List<T> childNodesOfType(Class<T> tClass) {
     }
 
     /**
-     * Remove the Element at the specified index in this list, but not from the DOM.
-     * @param index the index of the element to be removed
-     * @return the old element at this index
-     * @since 1.19.2
+     Remove the Element at the specified index in this list, but not from the DOM.
+     @param index the index of the element to be removed
+     @return the old element at this index
+     @see #remove(int) 
+     @since 1.19.2
      */
     public Element deselect(int index) {
         return super.remove(index);
     }
 
     /**
-     * Remove the specified Element from this list, but not from the DOM.
-     * @param o element to be removed from this list, if present
-     * @return if this list contained the Element
-     * @since 1.19.2
+     Remove the specified Element from this list, but not from the DOM.
+     @param o element to be removed from this list, if present
+     @return if this list contained the Element
+     @see #remove(Object) 
+     @since 1.19.2
      */
     public boolean deselect(Object o) {
         return super.remove(o);
     }
 
     /**
      Removes all the elements from this list, and each of them from the DOM.
-     * @since 1.17.1
-     * @see #remove()
+     @since 1.17.1
+     @see #deselectAll()
      */
     @Override public void clear() {
         remove();
         super.clear();
     }
 
+    /**
+     Like {@link #clear()}, removes all the elements from this list, but not from the DOM.
+     @see #clear()
+     @since 1.19.2
+     */
+    public void deselectAll() {
+        super.clear();
+    }
+
     /**
      Removes from this list, and from the DOM, each of the elements that are contained in the specified collection and
      are in this list.

src/test/java/org/jsoup/nodes/ElementTest.java

@@ -3097,4 +3097,15 @@ public void deselect() {
         assertEquals(1, els.size());
         assertEquals(3, parent.childrenSize());
     }
+
+    @Test
+    public void deselectAll() {
+        Document doc = Jsoup.parse("<div><p>One</p><p>Two</p><p>Three</p></div>");
+        Elements els = doc.select("p");
+        Element parent = doc.expectFirst("div");
+
+        els.deselectAll();
+        assertEquals(0, els.size());
+        assertEquals(3, parent.childrenSize());
+    }
 }