Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes