CKTIS / JavaScript
Selection.removeAllRanges() — czyszczenie zaznaczenia
Selection.removeAllRanges() opróżnia zaznaczenie dokumentu, ale nie usuwa tekstu ani węzłów. Metoda nie przyjmuje argumentów i zwraca undefined.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
selection.removeAllRanges()Selection.removeAllRanges() odłącza zakres od zaznaczenia. Po wywołaniu rangeCount wynosi 0, a anchorNode i focusNode mają wartość null. Ponowne wywołanie dla pustego zaznaczenia niczego nie zmienia.
Nie usuwa treści ani zachowanego obiektu Range. W przeciwieństwie do collapseToStart() nie pozostawia zakresu zwiniętego do kursora. empty() jest aliasem tej metody.
To interfejs przeglądarkowy Selection API, nie funkcja ECMAScript; Node 24 nie potwierdza jego dostępności. Sprawdź obsługę w docelowej przeglądarce. Przykład porównuje puste zaznaczenie z niezmienionym tekstem i zachowanym zakresem.
Przykłady
(() => {
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();
})();Wynik
{"rangeCount":0,"anchorNode":null,"focusNode":null,"text":"Hello","savedRange":"Hello"}Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.