CKTIS / JavaScript
Selection.getRangeAt — извличане на диапазон от селекцията
Selection.getRangeAt(0) връща обекта Range, свързан със селекцията в документа, а не негово копие.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
selection.getRangeAt(index)selection.getRangeAt(index) предоставя достъп до диапазона на селекцията. Това е браузърно Web API, а не функционалност на ECMAScript; Node 24 не потвърждава поддръжката му.
Преди извикване с индекс 0 проверете дали са изпълнени условията selection !== null и selection.rangeCount > 0. Според спецификацията методът трябва да хвърли изключение IndexSizeError, ако индексът е различен от 0, селекцията е празна или някоя от граничните ѝ точки е извън дървото на документа. Браузърите не винаги спазват това правило: Firefox може да предостави достъп до няколко диапазона в селекцията, така че ненулев индекс също може да сработи. Ако гранична точка се намира в дърво на Shadow DOM, не разчитайте, че браузърът ще хвърли това изключение. Селекция, свита до позицията на курсора, все пак може да има диапазон.
Резултатът е референция: промяната на диапазона влияе върху селекцията, докато остават свързани. Повторните извиквания с един и същ индекс връщат същия обект, освен ако диапазонът не е заменен или премахнат. Спецификацията е Working Draft, а не таблица за съвместимост на браузърите.
Примери
(() => {
const selection = window.getSelection();
if (!selection || !document.body) {
throw new Error("An active browser document is required.");
}
const element = document.createElement("p");
element.textContent = "Hello world";
document.body.append(element);
try {
selection.removeAllRanges();
const range = document.createRange();
range.setStart(element.firstChild, 0);
range.setEnd(element.firstChild, 5);
selection.addRange(range);
if (selection.rangeCount === 0) {
throw new Error("No selection range is available.");
}
const selectedRange = selection.getRangeAt(0);
console.log(selectedRange.toString());
console.log(selectedRange === selection.getRangeAt(0));
} finally {
selection.removeAllRanges();
element.remove();
}
})();Резултат
Hello true
Кодът и изходът са проверени в изолирана среда с Chromium. Примерът извлича единствения диапазон с индекс `0` и проверява дали второ извикване връща същия обект. Той не проверява ненулеви индекси или гранични точки в дърво на Shadow DOM.