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
range.collapse(toStart);
Parameters
- toStart Optional
- A boolean value:
truecollapses theRangeto its start,falseto its end. If omitted, it defaults tofalse.
Example
var range = document.createRange();
referenceNode = document.getElementsByTagName("div").item(0);
range.selectNode(referenceNode);
range.collapse(true);
Specifications
| Specification | Status | Comment |
|---|---|---|
| DOM The definition of 'Range.collapse()' in that specification. |
Living Standard | The parameter is now optional and default to false. |
| Document Object Model (DOM) Level 2 Traversal and Range Specification The definition of 'Range.collapse()' in that specification. |
Recommendation | Initial specification. |
Browser compatibility
| Feature | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|---|
| Basic support | (Yes) | (Yes) | 1.0 (1.7 or earlier) | 9.0 | 9.0 | (Yes) |
| Parameter optional | (Yes) | ? | 25 (25) | No support[1] | 15.0 | (Yes) |
| Feature | Android | Edge | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|
| Basic support | (Yes) | (Yes) | 1.0 (1.0) | 9.0 | 9.0 | (Yes) |
| Parameter optional | (Yes) | ? | 25 (25) | No support[1] | 15.0 | (Yes) |
[1] Optional but defaults to true.