CKTIS / JavaScript
HTMLTextAreaElement.selectionEnd — fim da seleção
HTMLTextAreaElement.selectionEnd permite ler ou definir o limite final de uma seleção num textarea. É um deslocamento iniciado em zero, medido em unidades de código UTF-16; a posição final não está incluída na 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
textarea.selectionEnd
textarea.selectionEnd = endHTMLTextAreaElement.selectionEnd é uma propriedade de leitura e escrita. Indica a posição imediatamente a seguir ao texto selecionado em textarea.value. selectionStart e selectionEnd descrevem um início incluído e um fim excluído. Quando não existe seleção, ambos os valores representam a posição do cursor.
Os deslocamentos contam unidades de código UTF-16, não caracteres visíveis: alguns emojis ocupam duas unidades. Em textarea, a API utiliza o valor com as terminações de linha normalizadas, e não o texto bruto que contém CR.
A atribuição altera o limite da seleção, não o texto. Web IDL começa por converter o valor atribuído para o tipo unsigned long. Se o valor obtido exceder o comprimento do texto, é limitado a esse comprimento. Por exemplo, 2 ** 32 é convertido em 0, pelo que atribuir esse valor define o fim como 0, e não como o comprimento do texto de um textarea não vazio. Se o novo fim ficar antes de selectionStart, o início também se desloca para o novo fim, anulando a seleção. Utilize setSelectionRange(start, end) para definir os dois limites em conjunto.
O estado da seleção existe mesmo num elemento que não esteja apresentado; por isso, o exemplo não adiciona o controlo ao documento. Esta é uma API do browser definida pelo HTML Standard, não uma funcionalidade da linguagem ECMAScript; a existência do Node 24 não comprova a sua disponibilidade.
Exemplos
const textarea = document.createElement('textarea');
textarea.value = 'Hello world';
textarea.setSelectionRange(0, 5);
console.log(textarea.selectionEnd);
console.log(textarea.value.slice(textarea.selectionStart, textarea.selectionEnd));
textarea.selectionEnd = 3;
console.log(textarea.value.slice(textarea.selectionStart, textarea.selectionEnd));Resultado
5 Hello Hel
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.