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.