CKTIS / JavaScript
window.getSelection() — Dokumentauswahl
window.getSelection() stellt das Selection-Objekt des aktuellen Dokuments bereit, mit dem sich die Auswahl lesen und ändern lässt.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
window.getSelection()window.getSelection() nimmt keine Argumente entgegen und delegiert an document.getSelection(). Laut Spezifikation gibt die Methode ein Selection-Objekt zurück oder null, wenn das Dokument keinen Browsing-Kontext hat. Firefox kann aber auch bei einem iframe mit display:none null zurückgeben, obwohl dessen Dokument einen Browsing-Kontext hat. Prüfe vor der Verwendung, ob das Ergebnis null ist. Ein Selection-Objekt ist kein String; den Text liest du mit selection.toString() aus.
Keine Auswahl bedeutet nicht null: Prüfe rangeCount, bevor du getRangeAt(0) aufrufst, um IndexSizeError zu vermeiden. isCollapsed gibt an, ob die Endpunkte zusammenfallen; das kann einen Caret oder eine leere Auswahl bedeuten. Ein Range beschreibt Grenzen, während Selection die Auswahl des Dokuments repräsentiert.
Dies ist eine browserbasierte Web API, kein ECMAScript-Feature. Dass Node 24 vorhanden ist, belegt keine Unterstützung. Die Spezifikation der Selection API ist ein Arbeitsentwurf und keine Browser-Kompatibilitätstabelle.
Beispiele
(() => {
const selection = window.getSelection();
if (!selection) throw new Error("Selection unavailable");
const paragraph = document.createElement("p");
paragraph.textContent = "Hello selection";
document.body.append(paragraph);
const range = document.createRange();
range.selectNodeContents(paragraph);
selection.removeAllRanges();
selection.addRange(range);
console.log(selection.toString());
console.log(selection.isCollapsed);
selection.removeAllRanges();
paragraph.remove();
})();Ergebnis
Hello selection false
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.