Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

window.getSelection() — seleção do documento

window.getSelection() disponibiliza o objeto Selection do documento atual, permitindo ler e alterar a seleção.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

window.getSelection()

window.getSelection() não recebe argumentos e delega em document.getSelection(). Segundo a especificação, devolve um objeto Selection ou null se o documento não tiver um contexto de navegação. O Firefox também pode devolver null num iframe com display:none, mesmo que o documento desse elemento tenha um contexto de navegação. Antes de utilizares o resultado, verifica se não é null. Um objeto Selection não é uma cadeia de caracteres; lê o texto com selection.toString().

A ausência de uma seleção não significa que o resultado seja null: verifica rangeCount antes de chamar getRangeAt(0) para evitar IndexSizeError. isCollapsed indica que os extremos coincidem; isso pode significar que existe um cursor ou uma seleção vazia. Um Range descreve limites, enquanto Selection representa a seleção do documento.

Esta é uma Web API do navegador, não uma funcionalidade de ECMAScript. A presença do Node 24 não comprova que exista suporte. A especificação da Selection API é um rascunho de trabalho, não uma tabela de compatibilidade dos navegadores.

Exemplos

(() => {
  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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes