CKTIS / JavaScript
Selection: contar rangos con rangeCount y añadirlos con addRange()
`rangeCount` indica cuántos rangos contiene la selección del documento y `addRange()` añade un rango del DOM. Para sustituir la selección por un solo rango independientemente del navegador, bórrala primero.
Versión: Current web platform; runtime support varies
Sintaxis
// Web platform: Selection API (not part of ECMAScript).
const selection = window.getSelection(); // Selection | null
if (selection !== null) {
const count = selection.rangeCount; // read-only number
selection.addRange(range); // takes a Range; returns undefined
}Selection representa la selección del documento o la posición del cursor de texto. Obtén el objeto con window.getSelection() y comprueba si el resultado es null. Esta API pertenece a la plataforma web, no a ECMAScript 2024. Para el texto de un textarea o de un tipo de input compatible, usa el método setSelectionRange() del elemento.
rangeCount es una propiedad numérica de solo lectura. Cuenta objetos Range, no caracteres. 0 significa que no hay ningún rango. Puede cumplirse rangeCount === 1 sin texto resaltado: un rango colapsado en un solo punto también cuenta. Comprueba que rangeCount > 0 antes de llamar a getRangeAt(0), porque un índice fuera de los límites provoca una excepción.
addRange(range) recibe un objeto Range y devuelve undefined, por lo que su valor de retorno no indica si se añadió el rango. Crea un rango con document.createRange() y establece sus límites, por ejemplo con range.selectNodeContents(node) sobre un nodo conectado al mismo documento. Un Range es dinámico: los cambios en el DOM pueden ajustar sus límites.
La especificación permite como máximo un rango por selección, pero Firefox admite varios. Un navegador limitado a un rango puede ignorar otra llamada a addRange() en vez de sustituir el rango existente. Para establecer un solo rango nuevo de forma fiable, llama primero a removeAllRanges(). Esto elimina la selección anterior, no el contenido del documento.
Ejemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Selection API example</title>
</head>
<body>
<script>
(() => {
const selection = window.getSelection();
if (selection === null) throw new Error("No document selection available");
const paragraph = document.createElement("p");
paragraph.textContent = "CKTIS";
document.body.append(paragraph);
try {
const range = document.createRange();
range.selectNodeContents(paragraph);
selection.removeAllRanges();
console.log(selection.rangeCount);
selection.addRange(range);
console.log(selection.rangeCount);
console.log(selection.toString());
} finally {
selection.removeAllRanges();
paragraph.remove();
}
})();
</script>
</body>
</html>Resultado
0 1 CKTIS
Guarda el ejemplo como archivo `.html`, ábrelo en una pestaña aparte del navegador y consulta la consola de desarrollo. El código muestra `0` tras borrar la selección y luego `1` y `CKTIS` tras añadir el rango. Al final, borra la selección y elimina el párrafo temporal, sin restaurar la selección anterior.
Lecciones relacionadas
- JavaScript · Lección 33 · Intermedio · Versión: 3