Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti