2022.1

What if there are no siblings?
If you call prev() or next() on a collection of elements (either "results" on page1509 or the
result set of "query()" on page1379), the function will return a collection of siblings. If none of
the elements has a previous or next sibling, the collection will be empty. Actions performed on
an empty collection will simply have no effect.
If you call prev() or next() on a single element (this in an 'Each matched element' script), and
the element has no previous or next sibling, the function returns null. Performing an operation
on a null value will result in an error, which means that the rest of the script won't be executed.
In this case, it is useful to check the return value, unless it's certain that it will never be null.
Example
Assume that there are three consecutive paragraphs in a Box and that the second of those
paragraphs has an ID that matches the selector of this script. The paragraph is stored in the
results object (see "results" on page1509). The following script changes the font-weight of the
previous paragraph - the first paragraph in the Box - to bold.
results.prev().css("font-weight", "bold");
If the elements in results don't have siblings, this line of code will have no effect. It also won't
result in an error.
In an 'Each matched element' script you would first need to check the return value of this.prev
():
var prevSibling = this.prev();
if prevSibling != null { prevSibling.css("font-weight", "bold"); }
remove()
Removes the current element or each element in a set from the DOM.
This function returns a new result set containing each removed element. These can be
changed and inserted in the document. This could be beneficial in terms of performance, as
manipulating elements inside the DOM is relatively time consuming.
Examples
This script removes all Span elements found in the template.
Page 1459