Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła