Selection: toString() method

{{ ApiRef("DOM") }}

The Selection.toString() method returns a string currently being represented by the selection object, i.e., the currently selected text.

Syntax

toString()

Parameters

None.

Return value

A string representing the selection.

Description

This method returns the currently selected text.

In JavaScript, this method is called automatically when a function the selection object is passed to requires a string:

alert(window.getSelection()); // What is called
alert(window.getSelection().toString()); // What is actually being effectively called.

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

• {{domxref("Selection")}}, the interface it belongs to.