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

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.

Fontes