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. |
Obsolete | Initial specification. |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
| Feature | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|---|
| Basic support | Yes | Yes | 4 | 9 | 9 | Yes |
toStart parameter optional | Yes | ? | 25 | No1 | 15 | Yes |
| Feature | Android webview | Chrome for Android | Edge mobile | Firefox for Android | Opera Android | iOS Safari | Samsung Internet |
|---|---|---|---|---|---|---|---|
| Basic support | Yes | Yes | Yes | 4 | Yes | Yes | ? |
toStart parameter optional | Yes | Yes | ? | 25 | 15 | Yes | ? |
1. Optional but defaults to true.