Range: setEnd() method

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.

The Range.setEnd() method sets the end position of a Range to be located at the given offset into the specified node x.Setting the end point above (higher in the document) than the start point will result in a collapsed range with the start and end points both set to the specified end position.

Syntax

js
setEnd(endNode, endOffset)

Parameters

endNode

The Node inside which the Range should end.

endOffset

An integer greater than or equal to zero representing the offset for the end of the Range from the start of endNode.

Return value

None (undefined).

Exceptions

InvalidNodeTypeError DOMException

The node specified by endNode is a doctype node; range endpoints cannot be located inside a doctype node.

IndexSizeError DOMException

The value specified by endOffset is either greater than or equal to the length of the node or is less than zero.

Usage notes

If the endNode is a Node of type Text, Comment, or CDataSection, then endOffset is the number of characters from the start of endNode. For other Node types, endOffset is the number of child nodes between the start of the endNode.

Examples

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

Note: setEnd() is commonly used in conjunction with setStart() to fully configure a range.

Specifications

Specification
DOM Standard
# dom-range-setend

Browser compatibility

BCD tables only load in the browser

See also