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 setzt die Endposition eines Range an den angegebenen Offset innerhalb des spezifizierten Knotens. Das Setzen des Endpunkts oberhalb (weiter oben im Dokument) als der Startpunkt führt zu einem zusammengeklappten Bereich, bei dem Start- und Endpunkt beide auf die angegebene Endposition gesetzt werden.

Syntax

js
setEnd(endNode, endOffset)

Parameter

endNode

Der Node innerhalb dessen der Range enden soll.

endOffset

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

Rückgabewert

Keiner (undefined).

Ausnahmen

InvalidNodeTypeError DOMException

Der durch endNode angegebene Knoten ist ein Doctype-Knoten; Bereichsendpunkte können nicht innerhalb eines Doctype-Knotens festgelegt werden.

IndexSizeError DOMException

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

Verwendungshinweise

Wenn der endNode ein Node vom Typ 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 Kindknoten 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