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.