W3cubDocs

/Web APIs

Range: collapse() 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 collapse() method of the Range interface 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

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

const range = document.createRange();

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

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet WebView Android WebView on iOS
collapse 1 12 1 9 1 18 4 10.1 1 1.0 4.4 1
toStart_parameter_optional 1 16 25 15 1 18 25 14 1 1.0 4.4 1

See also

© 2005–2025 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