WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen