CKTIS / JavaScript
window.getSelection() — výběr v dokumentu
window.getSelection() zpřístupňuje objekt Selection aktuálního dokumentu, který umožňuje výběr číst a měnit.
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
window.getSelection()window.getSelection() nepřijímá žádné argumenty a deleguje na document.getSelection(). Podle specifikace vrací objekt Selection, nebo null, pokud dokument nemá kontext prohlížení. Firefox ale může vrátit null i u prvku iframe s display:none, přestože jeho dokument kontext prohlížení má. Než výsledek použijete, ověřte, že není null. Objekt Selection není řetězec; text získáte pomocí selection.toString().
To, že není nic vybráno, neznamená, že je výsledkem null: před voláním getRangeAt(0) zkontrolujte rangeCount, abyste předešli chybě IndexSizeError. isCollapsed udává, zda se krajní body shodují; může to znamenat kurzor nebo prázdný výběr. Range popisuje hranice, zatímco Selection představuje výběr v dokumentu.
Jde o webové API prohlížeče, nikoli o funkci ECMAScriptu. Přítomnost Node 24 nedokazuje, že je API podporováno. Specifikace Selection API je pracovní návrh, nikoli tabulka kompatibility prohlížečů.
Příklady
(() => {
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();
})();Výsledek
Hello selection false
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.