W3cubDocs

/Web APIs

Range: collapse() method

The Range.collapse() method collapses the Range to one of its boundary points.

A collapsed Range is empty, containing no content, specifying a single-point in a DOM tree. To determine if a Range is already collapsed, see the Range.collapsed property.

Syntax

js

collapse()
collapse(toStart)

Parameters

toStart Optional

A boolean value: true collapses the Range to its start, false to its end. If omitted, it defaults to false .

Return value

None (undefined).

Examples

js

const range = document.createRange();

const referenceNode = document.getElementsByTagName("div").item(0);
range.selectNode(referenceNode);
range.collapse(true);

Specifications

Specification
DOM Standard
# dom-range-collapse

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
collapse 1 12 1 9 9 1 4.4 18 4 10.1 1 1.0
toStart_parameter_optional 1 ≤79 25
NoOptional but defaults to true.
 15 1 4.4 18 25 14 1 1.0

See also

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Range/collapse