CKTIS / JavaScript
HTMLInputElement.value — ler e definir o valor de um campo
HTMLInputElement.value permite ler ou definir um valor como cadeia de caracteres. O comportamento depende de type; num campo de texto, o valor atual pode ser diferente do valor predefinido.
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
input.value
input.value = "new value";HTMLInputElement.value é uma propriedade da Web API, não do próprio ECMAScript. Devolve uma cadeia de caracteres, mesmo com type="number"; para ler um número, utilize valueAsNumber. Requer um ambiente DOM de navegador; o Node.js, por si só, não é suficiente.
Num campo de texto, .value representa o valor atual. defaultValue reflete o atributo HTML value. Atribuir um valor a .value ativa uma indicação interna de valor alterado: as alterações posteriores ao atributo deixam de atualizar o valor atual até essa indicação ser reposta, por exemplo, ao repor o formulário. A atribuição não ativa automaticamente os eventos input ou change.
O navegador aplica regras de limpeza específicas de cada type: um valor numérico inválido pode passar a "". Nas caixas de verificação e nos botões de opção, .value indica o valor enviado, que por predefinição é "on", e não se o controlo está selecionado — para isso, leia checked.
Para type="file", utilize files para aceder aos ficheiros. .value não revela o caminho real; atribuir uma cadeia não vazia lança InvalidStateError, enquanto "" limpa a seleção.
Exemplos
const input = document.createElement("input");
input.type = "text";
input.defaultValue = "Ada";
input.value = "Lin";
console.log(JSON.stringify({
value: input.value,
defaultValue: input.defaultValue,
attribute: input.getAttribute("value")
}));Resultado
{"value":"Lin","defaultValue":"Ada","attribute":"Ada"}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.