Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje