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

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.

Fuentes