CKTIS / JavaScript
Selection.getRangeAt — získanie rozsahu výberu
Selection.getRangeAt(0) vracia objekt Range spojený s výberom v dokumente, nie jeho kópiu.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
selection.getRangeAt(index)selection.getRangeAt(index) sprístupňuje rozsah výberu. Je to webové API prehliadača, nie funkcia ECMAScriptu; Node 24 nepotvrdzuje jeho podporu.
Pred volaním s indexom 0 skontrolujte, či platí selection !== null a selection.rangeCount > 0. Podľa špecifikácie musí metóda vyvolať výnimku IndexSizeError, ak index nie je 0, výber je prázdny alebo niektorý z jeho hraničných bodov leží mimo stromu dokumentu. Prehliadače toto pravidlo nedodržiavajú vždy: Firefox môže sprístupniť viac rozsahov výberu, takže môže fungovať aj nenulový index. Ak hraničný bod leží v strome Shadow DOM, nespoliehajte sa na to, že prehliadač túto výnimku vyvolá. Aj výber zbalený na pozíciu textového kurzora môže mať rozsah.
Výsledkom je referencia: zmena rozsahu ovplyvňuje výber, kým zostávajú prepojené. Opakované volania s rovnakým indexom vracajú ten istý objekt, pokiaľ rozsah nebol nahradený alebo odstránený. Špecifikácia má status Working Draft; nejde o tabuľku kompatibility prehliadačov.
Prí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ýsledok
Hello true
Kód a výstup boli overené v izolovanom prostredí prehliadača Chromium. Príklad získa jediný rozsah s indexom `0` a overí, že druhé volanie vráti ten istý objekt. Netestuje nenulové indexy ani hraničné body v strome Shadow DOM.