Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

window.getSelection() — odabir u dokumentu

window.getSelection() omogućuje pristup objektu Selection trenutačnog dokumenta, pa se odabir može čitati i mijenjati.

Verzija: 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 prima argumente i delegira poziv na document.getSelection(). Prema specifikaciji vraća objekt Selection ili null ako dokument nema kontekst pregledavanja. Firefox može vratiti null i za element iframe s postavkom display:none, iako njegov dokument ima kontekst pregledavanja. Prije upotrebe rezultata provjerite je li null. Objekt Selection nije niz znakova; tekst pročitajte pomoću selection.toString().

To što nema odabira ne znači da je rezultat null: provjerite rangeCount prije poziva getRangeAt(0) kako biste izbjegli IndexSizeError. isCollapsed pokazuje podudaraju li se krajnje točke; to može značiti pokazivač ili prazan odabir. Range opisuje granice, dok Selection predstavlja odabir dokumenta.

Ovo je web API preglednika, a ne značajka ECMAScripta. Sama prisutnost Nodea 24 ne dokazuje podršku. Specifikacija Selection API-ja radni je nacrt, a ne tablica kompatibilnosti preglednika.

Primjeri

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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori