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.