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.