1. Web
  2. Web APIs
  3. Range
  4. setEnd()

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 ⁨July 2015⁩.

The Range.setEnd() method sets the end position of a Range to be located at the given offset into the specified node. 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
# dom-range-setend

Browser compatibility

See also

Help improve MDN

Learn how to contribute

This page was last modified on by MDN contributors.

View this page on GitHub • Report a problem with this content