CKTIS / JavaScript
window.getSelection() — výber v dokumente
window.getSelection() sprístupňuje objekt Selection aktuálneho dokumentu, ktorý umožňuje výber čítať a meniť.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
window.getSelection()window.getSelection() neprijíma žiadne argumenty a deleguje na document.getSelection(). Podľa špecifikácie vracia objekt Selection alebo null, ak dokument nemá kontext prehliadania. Firefox však môže vrátiť null aj pri prvku iframe s display:none, hoci jeho dokument má kontext prehliadania. Pred použitím výsledku overte, že nie je null. Objekt Selection nie je reťazec; text získate pomocou selection.toString().
To, že nie je nič vybraté, neznamená, že výsledkom je null: pred volaním getRangeAt(0) skontrolujte rangeCount, aby ste predišli chybe IndexSizeError. isCollapsed označuje, či sa koncové body zhodujú; môže to znamenať kurzor alebo prázdny výber. Range opisuje hranice, zatiaľ čo Selection predstavuje výber v dokumente.
Ide o webové API prehliadača, nie o funkciu ECMAScriptu. Prítomnosť Node 24 nedokazuje, že je API podporované. Špecifikácia Selection API je pracovný návrh, nie tabuľka kompatibility prehliadačov.
Prí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ýsledok
Hello selection false
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.