CKTIS / JavaScript
Selection.getRangeAt — een selectiebereik ophalen
Selection.getRangeAt(0) retourneert het Range-object dat bij de documentselectie hoort, niet een kopie.
Versie: 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)Met selection.getRangeAt(index) haal je een bereik van de selectie op. Dit is een web-API van de browser, geen ECMAScript-functie; Node 24 toont niet aan dat deze wordt ondersteund.
Controleer vóór een aanroep met index 0 of selection !== null en selection.rangeCount > 0 gelden. Volgens de specificatie moet de methode een IndexSizeError geven als de index niet 0 is, de selectie leeg is of een van de grenspunten buiten de documentboom ligt. Browsers volgen die regel niet altijd: Firefox kan meerdere selectiebereiken beschikbaar stellen, waardoor ook een index anders dan 0 kan werken. Ligt een grenspunt in een shadow tree, ga er dan niet van uit dat de browser deze uitzondering genereert. Ook een selectie die tot de cursorpositie is gereduceerd, kan een bereik hebben.
Het resultaat is een verwijzing: wijzigingen aan het bereik beïnvloeden de selectie zolang ze gekoppeld blijven. Herhaalde aanroepen met dezelfde index retourneren hetzelfde object, tenzij het bereik is vervangen of verwijderd. De specificatie is een Working Draft, geen compatibiliteitstabel voor browsers.
Voorbeelden
(() => {
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();
}
})();Resultaat
Hello true
De code en de uitvoer zijn gecontroleerd in een geïsoleerde Chromium-omgeving. Het voorbeeld haalt het enige bereik op met index `0` en controleert of een tweede aanroep hetzelfde object retourneert. Het test geen andere indexen of grenspunten in een shadow tree.