CKTIS / JavaScript
Selection.getRangeAt — dohvaćanje raspona odabira
Selection.getRangeAt(0) vraća objekt Range povezan s odabirom u dokumentu, a ne njegovu kopiju.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
selection.getRangeAt(index)selection.getRangeAt(index) daje pristup rasponu odabira. To je web-API preglednika, a ne značajka ECMAScripta; Node 24 ne potvrđuje njegovu podršku.
Prije poziva s indeksom 0 provjerite vrijede li uvjeti selection !== null i selection.rangeCount > 0. Prema specifikaciji metoda mora izazvati iznimku IndexSizeError ako indeks nije 0, ako je odabir prazan ili ako je bilo koja od njegovih graničnih točaka izvan stabla dokumenta. Preglednici se ne pridržavaju uvijek tog pravila: Firefox može omogućiti pristup većem broju raspona odabira, pa može funkcionirati i indeks različit od 0. Ako se granična točka nalazi u stablu Shadow DOM-a, ne pretpostavljajte da će preglednik izazvati tu iznimku. Odabir sveden na položaj tekstnog pokazivača i dalje može imati raspon.
Rezultat je referenca: promjena raspona utječe na odabir dok god su povezani. Ponovljeni pozivi s istim indeksom vraćaju isti objekt, osim ako je raspon zamijenjen ili uklonjen. Specifikacija ima status Working Draft; nije tablica kompatibilnosti preglednika.
Primjeri
(() => {
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();
}
})();Rezultat
Hello true
Kôd i ispis provjereni su u izoliranom okruženju preglednika Chromium. Primjer dohvaća jedini raspon s indeksom `0` i provjerava vraća li drugi poziv isti objekt. Ne ispituje indekse različite od `0` ni granične točke u stablu Shadow DOM-a.