MDN self-hosted library · e01.org

Selection: setPosition() method

DOM

DOM

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

Syntax

setPosition(node)
setPosition(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 Selection.removeAllRanges(), i.e., all ranges will be removed from the selection.
  • offset
  • : 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().setPosition(body, 0);

Specifications

Browser compatibility

See also

  • Selection.collapse()