Range: setEnd() Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die Range.setEnd()-Methode legt die Endposition eines Range an dem angegebenen Offset im angegebenen Knoten fest. Wenn der Endpunkt oberhalb (weiter oben im Dokument) als der Startpunkt gesetzt wird, resultiert dies in einem kollabierten Bereich, bei dem Start- und Endpunkte beide auf die angegebene Endposition gesetzt sind.

Syntax

js
setEnd(endNode, endOffset)

Parameter

endNode

Der Node, in dem der Range enden soll.

endOffset

Eine Ganzzahl größer oder gleich Null, die den Offset für das Ende des Range vom Anfang des endNode darstellt.

Rückgabewert

Keiner (undefined).

Ausnahmen

InvalidNodeTypeError DOMException

Der durch endNode angegebene Knoten ist ein Doctype-Knoten; Bereichs-Endpunkte können nicht in einem Doctype-Knoten positioniert werden.

IndexSizeError DOMException

Der durch endOffset angegebene Wert ist entweder größer oder gleich der Länge des Knotens oder kleiner als null.

Nutzungshinweise

Wenn endNode ein Node des Typs Text, Comment oder CDataSection ist, dann ist endOffset die Anzahl der Zeichen vom Anfang des endNode. Für andere Node-Typen ist endOffset die Anzahl der Knoten zwischen dem Anfang des endNode.

Beispiele

js
const range = document.createRange();
const endNode = document.getElementsByTagName("p").item(3);
const endOffset = endNode.childNodes.length;
range.setEnd(endNode, endOffset);

Hinweis: setEnd() wird häufig in Verbindung mit setStart() verwendet, um einen Bereich vollständig zu konfigurieren.

Spezifikationen

Specification
DOM
# dom-range-setend

Browser-Kompatibilität

Siehe auch