CKTIS / JavaScript
Selection.removeAllRanges() — изчистване на селекцията
Selection.removeAllRanges() изпразва селекцията на документа, без да изтрива текст или възли. Методът не приема аргументи и връща undefined.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
selection.removeAllRanges()Selection.removeAllRanges() премахва диапазона от селекцията. След извикването rangeCount е 0, а anchorNode и focusNode са null. Повторното извикване при празна селекция не променя нищо.
Методът не изтрива нито съдържанието, нито запазен обект Range. За разлика от collapseToStart(), той не оставя диапазон, свит до позиция на курсора. empty() е псевдоним на този метод.
Това е интерфейс на браузърния Selection API, а не функция на ECMAScript; Node 24 не потвърждава наличността му. Проверете поддръжката в целевия браузър. Примерът противопоставя празната селекция на непроменения текст и запазения диапазон.
Примери
(() => {
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();
})();Резултат
{"rangeCount":0,"anchorNode":null,"focusNode":null,"text":"Hello","savedRange":"Hello"}Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.