Range: Methode setEnd()

Baseline Widely available

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

Die Range.setEnd()-Methode setzt die Endposition eines Range auf die angegebene Verschiebung in den spezifizierten Knoten. Wenn der Endpunkt höher (weiter oben im Dokument) als der Startpunkt gesetzt wird, führt dies zu einem zusammengeklappten Bereich, bei dem die Start- und Endpunkte beide auf die angegebene Endposition gesetzt werden.

Syntax

js
setEnd(endNode, endOffset)

Parameter

endNode

Der Node, in dem der Range enden soll.

endOffset

Eine ganze Zahl, die größer als oder gleich null ist und den Versatz für das Ende des Range vom Start des endNode darstellt.

Rückgabewert

Keiner (undefined).

Ausnahmen

InvalidNodeTypeError DOMException

Der durch endNode angegebene Knoten ist ein Doctype-Knoten; Bereichs-Endpunkte können nicht innerhalb eines Doctype-Knotens liegen.

IndexSizeError DOMException

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

Gebrauchshinweise

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

Beispiele

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

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

Spezifikationen

Specification
DOM Standard
# dom-range-setend

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch