Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

window.getSelection() — zaznaczenie dokumentu

window.getSelection() udostępnia obiekt Selection bieżącego dokumentu, pozwalając odczytywać i zmieniać zaznaczenie.

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

window.getSelection()

window.getSelection() nie przyjmuje argumentów i deleguje do document.getSelection(). Zgodnie ze specyfikacją metoda zwraca Selection, a jeśli dokument nie ma kontekstu przeglądania, zwraca null. Firefox może jednak zwrócić null również dla elementu iframe z display:none, mimo że jego dokument ma kontekst przeglądania. Zanim użyjesz wyniku, sprawdź, czy nie jest to null. Obiekt Selection nie jest napisem; tekst odczytasz przez selection.toString().

Brak zaznaczenia nie oznacza null: sprawdź rangeCount przed getRangeAt(0), aby uniknąć IndexSizeError. isCollapsed wskazuje zbieżność końców; może oznaczać kursor albo puste zaznaczenie. Range opisuje granice, a Selection reprezentuje zaznaczenie dokumentu.

To przeglądarkowe Web API, nie funkcja ECMAScript. Obecność Node 24 nie dowodzi obsługi. Specyfikacja Selection API jest dokumentem roboczym; nie stanowi tabeli zgodności przeglądarek.

Przykłady

(() => {
  const selection = window.getSelection();
  if (!selection) throw new Error("Selection unavailable");

  const paragraph = document.createElement("p");
  paragraph.textContent = "Hello selection";
  document.body.append(paragraph);

  const range = document.createRange();
  range.selectNodeContents(paragraph);
  selection.removeAllRanges();
  selection.addRange(range);

  console.log(selection.toString());
  console.log(selection.isCollapsed);

  selection.removeAllRanges();
  paragraph.remove();
})();

Wynik

Hello selection
false

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła