CKTIS / JavaScript
Selection.getRangeAt — obtener un rango de selección
Selection.getRangeAt(0) devuelve el objeto Range asociado a la selección del documento, no una copia.
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.getRangeAt(index)selection.getRangeAt(index) proporciona el rango de la selección. Es una API web del navegador, no una característica de ECMAScript; Node 24 no confirma que esté disponible.
Antes de llamar al método con el índice 0, comprueba que selection !== null y selection.rangeCount > 0. La especificación exige que se lance IndexSizeError si el índice no es 0, la selección está vacía o cualquiera de sus extremos se encuentra fuera del árbol del documento. Los navegadores no siempre siguen esta regla: Firefox puede exponer varios rangos de selección, por lo que un índice distinto de 0 puede funcionar. Si un extremo está en un árbol del Shadow DOM, no des por hecho que el navegador lanzará esa excepción. Una selección reducida a la posición del cursor todavía puede tener un rango.
El resultado es una referencia: modificar el rango afecta a la selección mientras ambos sigan asociados. Las llamadas repetidas con el mismo índice devuelven el mismo objeto, a menos que el rango se sustituya o se elimine. La especificación es un Working Draft, no una tabla de compatibilidad de navegadores.
Ejemplos
(() => {
const selection = window.getSelection();
if (!selection || !document.body) {
throw new Error("An active browser document is required.");
}
const element = document.createElement("p");
element.textContent = "Hello world";
document.body.append(element);
try {
selection.removeAllRanges();
const range = document.createRange();
range.setStart(element.firstChild, 0);
range.setEnd(element.firstChild, 5);
selection.addRange(range);
if (selection.rangeCount === 0) {
throw new Error("No selection range is available.");
}
const selectedRange = selection.getRangeAt(0);
console.log(selectedRange.toString());
console.log(selectedRange === selection.getRangeAt(0));
} finally {
selection.removeAllRanges();
element.remove();
}
})();Resultado
Hello true
El código y el resultado se verificaron en un entorno aislado de Chromium. El ejemplo obtiene el único rango con el índice `0` y comprueba que una segunda llamada devuelve el mismo objeto. No prueba índices distintos de `0` ni extremos en un árbol del Shadow DOM.