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.
Range.setEnd()
Syntax
setEnd(endNode, endOffset)
Parameters
Return value
None.
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
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
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
setEnd |
1
|
12
|
1
|
9
|
9
|
1
|
1
|
18
|
4
|
10.1
|
1
|
1.0
|
See also
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Range/setEnd