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.