Selection: collapse() method

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 setPosition() method.

Syntax

collapse(node)
collapse(node, offset)

Parameters

• 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 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.

Return value

None (undefined).

Examples

// Place the caret at the beginning of an HTML document's body.
const body = document.querySelector("body");
window.getSelection().collapse(body, 0);

Specifications

Browser compatibility

See also

• setPosition()