Document: Methode getSelection()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2017.

Die getSelection()-Methode des Document-Interfaces gibt das Selection-Objekt zurück, das mit diesem Dokument verbunden ist. Es repräsentiert den vom Benutzer ausgewählten Textbereich oder die aktuelle Position des Cursors.

Syntax

js
getSelection()

Parameter

Keine.

Rückgabewert

Ein Selection-Objekt oder null, wenn das Dokument keinen Browsing Context hat (zum Beispiel, wenn es sich um das Dokument eines nicht an ein Dokument angehängten <iframe> handelt).

Beispiele

Ein Selection-Objekt abrufen

js
const selection = document.getSelection();
const selRange = selection.getRangeAt(0);
// do stuff with the range

console.log(selection); // Selection object

Zeichenkettenrepräsentation des Selection-Objekts

Einige Funktionen (wie Window.alert()) rufen toString() automatisch auf und der zurückgegebene Wert wird an die Funktion übergeben. Folglich wird der ausgewählte Text zurückgegeben und nicht das Selection-Objekt:

js
alert(selection);

Allerdings rufen nicht alle Funktionen toString() automatisch auf. Um ein Selection-Objekt als Zeichenkette zu verwenden, rufen Sie direkt die toString()-Methode auf:

js
let selectedText = selection.toString();

Verwandte Objekte

Sie können Window.getSelection() aufrufen, welches identisch zu window.document.getSelection() ist.

Es ist zu beachten, dass getSelection() derzeit nicht bei den Inhalten von <input>-Elementen in Firefox funktioniert. HTMLInputElement.setSelectionRange()) könnte als Workaround verwendet werden.

Beachten Sie auch den Unterschied zwischen selection und focus. Document.activeElement gibt das fokussierte Element zurück.

Spezifikationen

Specification
Selection API
# dom-document-getselection

Browser-Kompatibilität

BCD tables only load in the browser