CKTIS / JavaScript
Selection.removeAllRanges() — limpar a seleção
Selection.removeAllRanges() esvazia a seleção do documento sem eliminar texto nem nós. O método não recebe argumentos e devolve undefined.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
selection.removeAllRanges()Selection.removeAllRanges() desassocia o intervalo da seleção. Depois da chamada, rangeCount é 0, e anchorNode e focusNode são null. Chamá-lo novamente com a seleção vazia não altera nada.
O método não elimina o conteúdo nem um objeto Range guardado. Ao contrário de collapseToStart(), não deixa qualquer intervalo reduzido a um cursor. empty() é um alias deste método.
Esta é uma interface da Selection API do navegador, não uma funcionalidade ECMAScript; o Node 24 não confirma a sua disponibilidade. Verifique o suporte no navegador de destino. O exemplo compara a seleção vazia com o texto inalterado e o intervalo conservado.
Exemplos
(() => {
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();
})();Resultado
{"rangeCount":0,"anchorNode":null,"focusNode":null,"text":"Hello","savedRange":"Hello"}O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.