Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje