Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Selection.removeAllRanges() — cancellare la selezione

Selection.removeAllRanges() svuota la selezione del documento senza eliminare testo o nodi. Il metodo non accetta argomenti e restituisce undefined.

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

selection.removeAllRanges()

Selection.removeAllRanges() dissocia il range dalla selezione. Dopo la chiamata, rangeCount è 0 e anchorNode e focusNode sono null. Richiamarlo su una selezione vuota non cambia nulla.

Non elimina né il contenuto né un oggetto Range salvato. A differenza di collapseToStart(), non lascia alcun range collassato su un punto di inserimento. empty() è un alias di questo metodo.

È un’interfaccia della Selection API del browser, non una funzionalità ECMAScript; Node 24 non ne conferma la disponibilità. Verifica il supporto nel browser di destinazione. L’esempio mette a confronto la selezione vuota con il testo invariato e il range conservato.

Esempi

(() => {
  const selection = window.getSelection();
  if (!selection || typeof selection.removeAllRanges !== "function") {
    throw new Error("Selection API unavailable");
  }

  const text = document.createTextNode("Hello");
  document.body.append(text);
  const range = document.createRange();
  range.selectNodeContents(text);

  selection.removeAllRanges();
  selection.addRange(range);
  selection.removeAllRanges();

  console.log(JSON.stringify({
    rangeCount: selection.rangeCount,
    anchorNode: selection.anchorNode,
    focusNode: selection.focusNode,
    text: text.data,
    savedRange: range.toString()
  }));
  text.remove();
})();

Risultato

{"rangeCount":0,"anchorNode":null,"focusNode":null,"text":"Hello","savedRange":"Hello"}

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