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

CKTIS / JavaScript

window.getSelection() — selección del documento

window.getSelection() expone el objeto Selection del documento actual para leer y modificar su selección.

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

window.getSelection()

window.getSelection() no acepta argumentos y delega en document.getSelection(). Según la especificación, devuelve un objeto Selection o null si el documento no tiene un contexto de navegación. Firefox también puede devolver null en un iframe con display:none, aunque su documento tenga un contexto de navegación. Antes de usar el resultado, comprueba que no sea null. Un objeto Selection no es una cadena; lee su texto con selection.toString().

Que no haya una selección no significa que el resultado sea null: comprueba rangeCount antes de llamar a getRangeAt(0) para evitar IndexSizeError. isCollapsed indica que los extremos coinciden; esto puede significar que hay un cursor o una selección vacía. Un Range describe los límites, mientras que Selection representa la selección del documento.

Es una API Web del navegador, no una característica de ECMAScript. Tener Node 24 no demuestra que sea compatible. La especificación de Selection API es un borrador de trabajo, no una tabla de compatibilidad de navegadores.

Ejemplos

(() => {
  const selection = window.getSelection();
  if (!selection) throw new Error("Selection unavailable");

  const paragraph = document.createElement("p");
  paragraph.textContent = "Hello selection";
  document.body.append(paragraph);

  const range = document.createRange();
  range.selectNodeContents(paragraph);
  selection.removeAllRanges();
  selection.addRange(range);

  console.log(selection.toString());
  console.log(selection.isCollapsed);

  selection.removeAllRanges();
  paragraph.remove();
})();

Resultado

Hello selection
false

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