CKTIS / JavaScript
HTMLFormElement.reset() — de standaardstatus van een formulier herstellen
HTMLFormElement.reset() herstelt de standaardstatus van de besturingselementen die bij een formulier horen, in plaats van ze alleen leeg te maken. Eerst wordt een annuleerbare reset-gebeurtenis verstuurd; preventDefault() voorkomt het herstel.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
form.reset()HTMLFormElement.reset is een methode van de DOM-API van de browser en maakt geen deel uit van ECMAScript zelf. De aanroep form.reset() heeft geen argumenten nodig en retourneert undefined. Alle huidige grote browserengines ondersteunen de methode; alleen de Node.js-versie toont niet aan dat deze API beschikbaar is.
De reset geldt voor resetbare besturingselementen waarvan het doel formulier de formuliereigenaar is, niet alleen voor de afstammelingen ervan. Bij een tekst-input wordt de standaardwaarde hersteld; bij een selectievakje de standaard aangevinkte status. Het betekent dus niet ‘alles leegmaken’. Een wijziging van defaultValue verandert de waarde die bij een volgende reset wordt gebruikt; het is geen onveranderlijke momentopname van de status bij het laden van de pagina. De reset verwijdert het attribuut disabled niet.
Voordat besturingselementen worden gewijzigd, verstuurt het formulier een bubbelende, annuleerbare reset-gebeurtenis. event.preventDefault() aanroepen in de handler stopt de reset. Waarden lezen in een synchrone handler voor deze gebeurtenis gebeurt vóór het herstel. Wijzigingen die door de reset worden uitgevoerd, veroorzaken geen input-gebeurtenissen.
Vermijd besturingselementen met name="reset" of id="reset": ze kunnen de methode overschaduwen, waardoor form.reset() niet meer aanroepbaar is. Gebruik bij zo’n conflict HTMLFormElement.prototype.reset.call(form). Het voorbeeld laat zowel een normale reset als het annuleren ervan zien.
Voorbeelden
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);Resultaat
before reset: Grace after reset: Ada before reset: Lin after canceled reset: Lin
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.