Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

window.getSelection() — izbor v dokumentu

window.getSelection() omogoča dostop do objekta Selection trenutnega dokumenta, s katerim lahko izbor berete in spreminjate.

Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

window.getSelection()

window.getSelection() ne sprejema argumentov in preusmeri klic na document.getSelection(). Po specifikaciji vrne objekt Selection ali null, če dokument nima konteksta brskanja. Firefox pa lahko vrne null tudi pri elementu iframe z nastavitvijo display:none, čeprav ima njegov dokument kontekst brskanja. Pred uporabo rezultata preverite, da ni null. Objekt Selection ni niz; besedilo preberite z selection.toString().

Če ni izbora, to ne pomeni, da je rezultat null: pred klicem getRangeAt(0) preverite rangeCount, da se izognete napaki IndexSizeError. isCollapsed označuje, da se končni točki ujemata; to lahko pomeni kazalko ali prazen izbor. Range opisuje meje, medtem ko Selection predstavlja izbor dokumenta.

To je spletni API brskalnika, ne funkcionalnost ECMAScripta. Prisotnost Node 24 še ne dokazuje podpore. Specifikacija Selection API je delovni osnutek, ne preglednica združljivosti brskalnikov.

Primeri

(() => {
  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();
})();

Rezultat

Hello selection
false

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri