CKTIS / JavaScript
window.getSelection() — selezione del documento
window.getSelection() espone l’oggetto Selection del documento corrente, che consente di leggere e modificare la selezione.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
window.getSelection()window.getSelection() non accetta argomenti e delega a document.getSelection(). Secondo la specifica, restituisce un oggetto Selection oppure null se il documento non ha un contesto di navigazione. Firefox può restituire null anche per un iframe con display:none, sebbene il suo documento abbia un contesto di navigazione. Prima di usare il risultato, controlla che non sia null. Un oggetto Selection non è una stringa; leggi il testo con selection.toString().
L’assenza di una selezione non significa che il risultato sia null: controlla rangeCount prima di chiamare getRangeAt(0) per evitare IndexSizeError. isCollapsed indica che gli estremi coincidono; può significare che c’è un cursore o una selezione vuota. Un Range descrive i limiti, mentre Selection rappresenta la selezione del documento.
È una Web API del browser, non una funzionalità di ECMAScript. La presenza di Node 24 non dimostra che sia supportata. La specifica della Selection API è una bozza di lavoro, non una tabella di compatibilità dei browser.
Esempi
(() => {
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();
})();Risultato
Hello selection false
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.