CKTIS / JavaScript
HTMLFormElement.reset() — restaurar el estado predeterminado de un formulario
HTMLFormElement.reset() restaura el estado predeterminado de los controles asociados a un formulario, en lugar de limitarse a vaciarlos. Primero emite un evento reset cancelable; preventDefault() detiene la restauración.
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
form.reset()HTMLFormElement.reset es un método de la API DOM del navegador, no forma parte de ECMAScript. La llamada form.reset() no recibe argumentos y devuelve undefined. Todos los principales motores de navegador actuales lo admiten; la versión de Node.js por sí sola no demuestra que esta API esté disponible.
El restablecimiento afecta a los controles restablecibles cuyo propietario de formulario es el formulario indicado, no solo a sus descendientes. En un input de texto, restaura el valor predeterminado; en una casilla, restaura el estado marcado predeterminado. Por tanto, no significa «vaciarlo todo». Cambiar defaultValue modifica el valor que se usará en el siguiente restablecimiento; no es una instantánea inmutable del estado al cargar la página. El restablecimiento no elimina el atributo disabled.
Antes de cambiar los controles, el formulario emite un evento reset que se propaga y puede cancelarse. Llamar a event.preventDefault() en su controlador detiene el restablecimiento. La lectura de valores en un controlador síncrono de este evento ocurre antes de la restauración. Los cambios realizados por el restablecimiento no generan eventos input.
Evita controles con name="reset" o id="reset": pueden ocultar el método e impedir que se pueda llamar a form.reset(). Si se produce esa colisión, usa HTMLFormElement.prototype.reset.call(form). El ejemplo muestra tanto un restablecimiento normal como su cancelación.
Ejemplos
const form = document.createElement('form');
const input = document.createElement('input');
input.defaultValue = 'Ada';
form.append(input);
input.value = 'Grace';
form.addEventListener('reset', () => {
console.log('before reset: ' + input.value);
});
form.reset();
console.log('after reset: ' + input.value);
input.value = 'Lin';
form.addEventListener('reset', event => event.preventDefault(), { once: true });
form.reset();
console.log('after canceled reset: ' + input.value);Resultado
before reset: Grace after reset: Ada before reset: Lin after canceled reset: Lin
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.