CKTIS / JavaScript
HTMLInputElement.value — leer y establecer el valor de un campo
HTMLInputElement.value permite leer o establecer un valor como cadena. Su comportamiento depende de type; en un campo de texto, el valor actual puede diferir del valor predeterminado.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
input.value
input.value = "new value";HTMLInputElement.value es una propiedad de la API Web, no de ECMAScript en sí. Devuelve una cadena, incluso con type="number"; usa valueAsNumber para leer un número. Requiere un entorno DOM de navegador; Node.js por sí solo no es suficiente.
En un campo de texto, .value representa el valor actual. defaultValue refleja el atributo HTML value. Asignar un valor a .value activa una marca interna de valor modificado: los cambios posteriores en el atributo ya no actualizan el valor actual hasta que se restablezca esa marca, por ejemplo, al restablecer el formulario. La asignación no dispara automáticamente los eventos input ni change.
El navegador aplica reglas de saneamiento según el type: un valor numérico no válido puede convertirse en "". En las casillas de verificación y los botones de opción, .value especifica el valor enviado, que por defecto es "on", no si el control está seleccionado; para eso, consulta checked.
Para type="file", usa files para acceder a los archivos. .value no revela la ruta real; asignar una cadena no vacía lanza InvalidStateError, mientras que "" borra la selección.
Ejemplos
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"}El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.