CKTIS / JavaScript
Selection.getRangeAt — pobieranie zakresu zaznaczenia
Selection.getRangeAt(0) zwraca obiekt Range powiązany z zaznaczeniem dokumentu, a nie jego kopię.
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.getRangeAt(index)selection.getRangeAt(index) udostępnia zakres zaznaczenia. To przeglądarkowe API, a nie funkcja ECMAScript; Node 24 nie potwierdza jego obsługi.
Przed wywołaniem z indeksem 0 sprawdź selection !== null i selection.rangeCount > 0. Zgodnie ze specyfikacją metoda ma zgłosić IndexSizeError, jeśli indeks jest inny niż 0, zaznaczenie jest puste lub którykolwiek z jego końców znajduje się poza drzewem dokumentu. Przeglądarki nie zawsze stosują tę regułę: Firefox może udostępniać kilka zakresów zaznaczenia, więc indeks inny niż 0 może zadziałać. Gdy koniec zaznaczenia znajduje się w drzewie shadow DOM, nie można zakładać, że przeglądarka zgłosi ten wyjątek. Zaznaczenie zwinięte do pozycji kursora nadal może mieć zakres.
Wynik jest referencją: zmiana zakresu wpływa na zaznaczenie, dopóki pozostają powiązane. Kolejne wywołania z tym samym indeksem zwracają ten sam obiekt, jeśli zakres nie został zastąpiony ani usunięty. Specyfikacja ma status Working Draft; nie jest tabelą zgodności przeglądarek.
Przykłady
(() => {
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();
}
})();Wynik
Hello true
Kod i wynik zweryfikowano w odizolowanym środowisku Chromium. Przykład pobiera jedyny zakres pod indeksem `0` i sprawdza, czy ponowne wywołanie zwraca ten sam obiekt. Nie sprawdza indeksów innych niż `0` ani końców zaznaczenia w drzewie shadow DOM.