Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Selection.getRangeAt — pobieranie zakresu zaznaczenia

Selection.getRangeAt(0) zwraca obiekt Range powiązany z zaznaczeniem dokumentu, a nie jego kopię.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

selection.getRangeAt(index)

selection.getRangeAt(index) udostępnia zakres zaznaczenia. To przeglądarkowe API, a nie funkcja ECMAScript; Node 24 nie potwierdza jego obsługi.

Przed wywołaniem z indeksem 0 sprawdź selection !== null i selection.rangeCount > 0. Zgodnie ze specyfikacją metoda ma zgłosić IndexSizeError, jeśli indeks jest inny niż 0, zaznaczenie jest puste lub którykolwiek z jego końców znajduje się poza drzewem dokumentu. Przeglądarki nie zawsze stosują tę regułę: Firefox może udostępniać kilka zakresów zaznaczenia, więc indeks inny niż 0 może zadziałać. Gdy koniec zaznaczenia znajduje się w drzewie shadow DOM, nie można zakładać, że przeglądarka zgłosi ten wyjątek. Zaznaczenie zwinięte do pozycji kursora nadal może mieć zakres.

Wynik jest referencją: zmiana zakresu wpływa na zaznaczenie, dopóki pozostają powiązane. Kolejne wywołania z tym samym indeksem zwracają ten sam obiekt, jeśli zakres nie został zastąpiony ani usunięty. Specyfikacja ma status Working Draft; nie jest tabelą zgodności przeglądarek.

Przykłady

(() => {
  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();
  }
})();

Wynik

Hello
true

Kod i wynik zweryfikowano w odizolowanym środowisku Chromium. Przykład pobiera jedyny zakres pod indeksem `0` i sprawdza, czy ponowne wywołanie zwraca ten sam obiekt. Nie sprawdza indeksów innych niż `0` ani końców zaznaczenia w drzewie shadow DOM.

Źródła