Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje