CKTIS / JavaScript
HTMLFormElement.reset() — przywracanie domyślnego stanu formularza
Metoda HTMLFormElement.reset() przywraca domyślny stan kontrolek powiązanych z formularzem, zamiast po prostu je opróżniać. Najpierw emituje anulowalne zdarzenie reset; preventDefault() zatrzymuje przywracanie wartości.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
form.reset()HTMLFormElement.reset to metoda przeglądarkowego API DOM, a nie samego ECMAScript. Wywołanie form.reset() nie przyjmuje argumentów i zwraca undefined. Jest obsługiwane przez wszystkie obecne główne silniki przeglądarek; sama wersja Node.js nie potwierdza dostępności tego API.
Reset dotyczy kontrolek podlegających resetowaniu, których właścicielem jest dany formularz, nie tylko jego potomków. Dla tekstowego input przywraca wartość domyślną, a dla pola wyboru — domyślny stan zaznaczenia. Nie oznacza więc „wyczyść wszystko”. Zmiana defaultValue zmienia wartość używaną przy kolejnym resecie; nie jest to niezmienny zapis stanu z chwili załadowania strony. Reset nie usuwa atrybutu disabled.
Przed zmianą kontrolek formularz emituje bąbelkujące, anulowalne zdarzenie reset. Wywołanie event.preventDefault() w jego obsłudze zatrzymuje reset. Odczyt wartości w synchronicznej obsłudze tego zdarzenia następuje przed przywróceniem stanu. Zmiany wykonane przez reset nie wywołują zdarzeń input.
Unikaj kontrolek z name="reset" lub id="reset": mogą przesłonić metodę, przez co form.reset() przestanie być wywoływalne. W razie takiej kolizji użyj HTMLFormElement.prototype.reset.call(form). Przykład pokazuje zwykły reset oraz jego anulowanie.
Przykłady
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);Wynik
before reset: Grace after reset: Ada before reset: Lin after canceled reset: Lin
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.