CKTIS / JavaScript
HTMLFormElement.reset() — възстановяване на състоянието по подразбиране на формуляр
HTMLFormElement.reset() възстановява състоянието по подразбиране на контролите, свързани с формуляр, вместо просто да ги изпразни. Първо изпраща отменяемо събитие reset; preventDefault() спира възстановяването.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
form.reset()HTMLFormElement.reset е метод от браузърния DOM API, а не част от самия ECMAScript. Извикването form.reset() не приема аргументи и връща undefined. Всички основни съвременни браузърни енджини го поддържат; само версията на Node.js не доказва наличието на този API.
Нулирането засяга контролите, които могат да се нулират и чийто собственик на формуляр е целевият формуляр, а не само неговите наследници. При текстов input то възстановява стойността по подразбиране, а при квадратче за отметка — състоянието на отметката по подразбиране. Следователно не означава „изпразни всичко“. Промяната на defaultValue променя стойността, използвана при следващо нулиране; това не е неизменна снимка на състоянието при зареждане на страницата. Нулирането не премахва атрибута disabled.
Преди да промени контролите, формулярът изпраща разпространяващо се и отменяемо събитие reset. Извикването на event.preventDefault() в обработчика му спира нулирането. Прочитането на стойностите в синхронен обработчик на това събитие се случва преди възстановяването. Промените, направени от нулирането, не задействат събития input.
Избягвай контроли с name="reset" или id="reset": те могат да засенчат метода и така form.reset() вече да не може да бъде извикан. При такъв конфликт използвай HTMLFormElement.prototype.reset.call(form). Примерът показва както обичайно нулиране, така и отмяната му.
Примери
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);Резултат
before reset: Grace after reset: Ada before reset: Lin after canceled reset: Lin
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.