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

CKTIS / JavaScript

Selection — selección del documento

Selection representa la selección del documento. Aprende sobre rangeCount y cómo añadir un rango mediante addRange.

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

const selection = window.getSelection();
selection.rangeCount;
selection.removeAllRanges();
selection.addRange(range);

Selection representa la selección del documento; Range define sus límites. Obtenla mediante window.getSelection() y comprueba si el resultado es null. Es una API web, no una característica de ECMAScript; Node 24 no demuestra compatibilidad con navegadores.

Selection.rangeCount es de solo lectura: la especificación exige el valor 0 si la selección está vacía o sus límites quedan fuera del árbol del documento, y 1 en los demás casos. Un rango contraído también puede dar 1: esto no implica que haya texto seleccionado.

Cuando Selection.addRange(range) añade un rango, conserva una referencia, no una copia. Según la especificación, el método no hace nada si el rango está fuera del árbol del documento o si Selection.rangeCount es distinto de 0. Sin embargo, Firefox permite añadir varios rangos, por lo que Selection.rangeCount puede superar 1 en ese navegador. No des por hecho que todos los navegadores admiten varios rangos. Para sustituir la selección, llama a removeAllRanges() antes de añadir el nuevo rango.

Ejemplos

(() => {
  const selection = window.getSelection();
  if (!selection || !document.body) {
    throw new Error('An active browser document with a body is required.');
  }

  const paragraph = document.createElement('p');
  paragraph.textContent = 'Hello Selection';
  document.body.append(paragraph);

  const range = document.createRange();
  range.setStart(paragraph.firstChild, 6);
  range.setEnd(paragraph.firstChild, 15);

  try {
    selection.removeAllRanges();
    selection.addRange(range);
    console.log(selection.rangeCount + ': ' + selection.toString());

    range.collapse(true);
    console.log(selection.rangeCount + ': ' + selection.isCollapsed);
  } finally {
    selection.removeAllRanges();
    paragraph.remove();
  }
})();

Resultado

1: Selection
1: true

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