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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
getSelection

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
Has more compatibility info.