The Selection.collapse() method collapses the current selection to a single point. The document is not modified. If the content is focused and editable, the caret will blink there.
Note: This method is an alias for the Selection.setPosition() method.
js
collapse(node)
collapse(node, offset)
node
The caret location will be within this node. This value can also be set to null — if null is specified, the method will behave like Selection.removeAllRanges(), i.e. all ranges will be removed from the selection.
offset Optional
The offset in node to which the selection will be collapsed. If not specified, the default value 0 is used.
None (undefined).
js
// Place the caret at the beginning of an HTML document's body.
const body = document.querySelector("body");
window.getSelection().collapse(body, 0);
| Specification |
|---|
| Selection API # dom-selection-collapse |
| 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 | ≤12.1 | 1.3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
node_parameter_nullable |
39 | ≤79 | 55 | No | 26 | 1.3 | 39 | 39 | 55 | 26 | 1 | 4.0 |
offset_parameter_optional |
1 | ≤79 | 55 | No | ≤15 | 1.3 | 4.4 | 18 | 55 | ≤14 | 1 | 1.0 |
© 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/Selection/collapse