CKTIS / JavaScript
Selection.removeAllRanges() — Auswahl löschen
Selection.removeAllRanges() leert die Dokumentauswahl, ohne Text oder Knoten zu löschen. Die Methode benötigt keine Argumente und gibt undefined zurück.
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
selection.removeAllRanges()Selection.removeAllRanges() löst den Bereich von der Auswahl. Danach ist rangeCount gleich 0, und anchorNode sowie focusNode sind null. Ein erneuter Aufruf bei einer leeren Auswahl ändert nichts.
Die Methode löscht weder Inhalte noch ein gespeichertes Range-Objekt. Anders als collapseToStart() lässt sie keinen Bereich an einer Einfügemarke zusammenfallen. empty() ist ein Alias für diese Methode.
Dies ist eine Schnittstelle der browserbasierten Selection API und kein ECMAScript-Feature; Node 24 belegt nicht, dass sie verfügbar ist. Prüfe die Unterstützung im Zielbrowser. Das Beispiel stellt der leeren Auswahl unveränderten Text und einen weiterhin vorhandenen Bereich gegenüber.
Beispiele
(() => {
const selection = window.getSelection();
if (!selection || typeof selection.removeAllRanges !== "function") {
throw new Error("Selection API unavailable");
}
const text = document.createTextNode("Hello");
document.body.append(text);
const range = document.createRange();
range.selectNodeContents(text);
selection.removeAllRanges();
selection.addRange(range);
selection.removeAllRanges();
console.log(JSON.stringify({
rangeCount: selection.rangeCount,
anchorNode: selection.anchorNode,
focusNode: selection.focusNode,
text: text.data,
savedRange: range.toString()
}));
text.remove();
})();Ergebnis
{"rangeCount":0,"anchorNode":null,"focusNode":null,"text":"Hello","savedRange":"Hello"}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.