Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Selection.removeAllRanges() — borrar la selección

Selection.removeAllRanges() vacía la selección del documento sin borrar texto ni nodos. El método no recibe argumentos y devuelve undefined.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

selection.removeAllRanges()

Selection.removeAllRanges() desvincula el rango de la selección. Después de llamarlo, rangeCount vale 0, y anchorNode y focusNode valen null. Volver a llamarlo con la selección vacía no cambia nada.

No elimina ni el contenido ni un objeto Range guardado. A diferencia de collapseToStart(), no deja ningún rango reducido a un cursor. empty() es un alias de este método.

Esta es una interfaz de la Selection API del navegador, no una característica de ECMAScript; Node 24 no confirma que esté disponible. Comprueba la compatibilidad en el navegador de destino. El ejemplo contrasta la selección vacía con el texto sin cambios y el rango conservado.

Ejemplos

(() => {
  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"}

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes