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
# dom-range-setend

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
setEnd

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch