CKTIS / JavaScript
Selection.getRangeAt — získání rozsahu výběru
Selection.getRangeAt(0) vrací objekt Range spojený s výběrem v dokumentu, nikoli jeho kopii.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
selection.getRangeAt(index)selection.getRangeAt(index) zpřístupňuje rozsah výběru. Jde o webové API prohlížeče, nikoli o funkci ECMAScriptu; Node 24 nepotvrzuje jeho podporu.
Před voláním s indexem 0 ověřte, že platí selection !== null a selection.rangeCount > 0. Podle specifikace musí metoda vyvolat výjimku IndexSizeError, pokud index není 0, výběr je prázdný nebo některý z jeho hraničních bodů leží mimo strom dokumentu. Prohlížeče toto pravidlo nedodržují vždy: Firefox může zpřístupnit více rozsahů výběru, takže může fungovat i nenulový index. Pokud hraniční bod leží ve stromu Shadow DOM, nespoléhejte na to, že prohlížeč tuto výjimku vyvolá. I výběr sbalený na pozici textového kurzoru může mít rozsah.
Výsledkem je reference: změna rozsahu ovlivňuje výběr, dokud zůstávají propojené. Opakovaná volání se stejným indexem vracejí stejný objekt, pokud rozsah nebyl nahrazen nebo odstraněn. Specifikace má status Working Draft; nejde o tabulku kompatibility prohlížečů.
Příklady
(() => {
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();
}
})();Výsledek
Hello true
Kód a výstup byly ověřeny v izolovaném prostředí prohlížeče Chromium. Příklad získá jediný rozsah s indexem `0` a ověří, že druhé volání vrátí stejný objekt. Netestuje nenulové indexy ani hraniční body ve stromu Shadow DOM.