CKTIS / JavaScript
HTMLSelectElement.value — valor da opção selecionada
HTMLSelectElement.value lê o valor da primeira opção selecionada ou altera a seleção ao procurar uma opção com um determinado valor.
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
select.value
select.value = "value"HTMLSelectElement.value devolve uma cadeia de caracteres: o valor da primeira opção selecionada pela ordem da árvore, ou "" quando nenhuma opção está selecionada. O valor de uma opção vem do seu atributo value ou, se esse atributo não existir, do respetivo texto.
A atribuição seleciona apenas a primeira opção correspondente e desseleciona as restantes, mesmo com multiple. Se não houver correspondência, a seleção é limpa: value passa a "" e selectedIndex passa a -1.
Com multiple, a leitura continua a devolver um único valor, não um array; selectedOptions dá acesso a todas as opções selecionadas. O valor "", por si só, não permite distinguir entre não haver seleção e haver uma opção selecionada com um valor vazio.
Exemplos
const select = document.createElement("select");
select.add(new Option("Alpha", "a"));
select.add(new Option("Beta", "b"));
select.value = "b";
console.log(JSON.stringify(select.value));
select.value = "missing";
console.log(JSON.stringify(select.value));
console.log(select.selectedIndex);Resultado
"b" "" -1
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.