CKTIS / JavaScript
HTMLFormElement.reset() — rétablir l’état par défaut d’un formulaire
HTMLFormElement.reset() rétablit l’état par défaut des contrôles associés à un formulaire, au lieu de simplement les vider. La méthode déclenche d’abord un événement reset annulable ; preventDefault() empêche le rétablissement.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
form.reset()HTMLFormElement.reset est une méthode de l’API DOM du navigateur, et non de l’ECMAScript lui-même. L’appel form.reset() ne prend aucun argument et renvoie undefined. Tous les principaux moteurs de navigateur actuels la prennent en charge ; la seule version de Node.js ne permet pas d’établir la disponibilité de cette API.
La réinitialisation concerne les contrôles réinitialisables dont le formulaire cible est le propriétaire, et pas seulement ses descendants. Pour un input de type texte, elle rétablit la valeur par défaut ; pour une case à cocher, elle rétablit son état coché par défaut. Cela ne signifie donc pas « tout vider ». Modifier defaultValue change la valeur utilisée lors d’une réinitialisation ultérieure ; ce n’est pas un instantané immuable de l’état au chargement de la page. La réinitialisation ne supprime pas l’attribut disabled.
Avant de modifier les contrôles, le formulaire déclenche un événement reset à propagation ascendante et annulable. Appeler event.preventDefault() dans son gestionnaire empêche la réinitialisation. La lecture des valeurs dans un gestionnaire synchrone de cet événement a lieu avant leur rétablissement. Les modifications effectuées par la réinitialisation ne déclenchent pas d’événements input.
Évite les contrôles ayant name="reset" ou id="reset" : ils peuvent masquer la méthode, rendant form.reset() impossible à appeler. En cas de collision, utilise HTMLFormElement.prototype.reset.call(form). L’exemple présente une réinitialisation normale ainsi que son annulation.
Exemples
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);Résultat
before reset: Grace after reset: Ada before reset: Lin after canceled reset: Lin
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.