WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

HTMLFormElement.reset() — den Standardzustand eines Formulars wiederherstellen

HTMLFormElement.reset() stellt den Standardzustand der einem Formular zugeordneten Steuerelemente wieder her, statt sie einfach zu leeren. Zuerst wird ein abbrechbares reset-Ereignis ausgelöst; preventDefault() verhindert die Wiederherstellung.

Version: 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 ist eine Methode der Browser-DOM-API und gehört nicht zu ECMAScript selbst. Der Aufruf form.reset() benötigt keine Argumente und gibt undefined zurück. Alle aktuellen großen Browser-Engines unterstützen die Methode; eine Node.js-Version allein belegt nicht, dass diese API verfügbar ist.

Der Reset betrifft zurücksetzbare Steuerelemente, deren Formularbesitzer das Zielformular ist, nicht nur dessen Nachfahren. Bei einem Text-input stellt er den Standardwert wieder her, bei einer Checkbox den standardmäßigen Auswahlzustand. Er bedeutet also nicht „alles leeren“. Eine Änderung von defaultValue ändert den Wert, der beim nächsten Reset verwendet wird; es handelt sich nicht um eine unveränderliche Momentaufnahme des Zustands beim Laden der Seite. Der Reset entfernt nicht das Attribut disabled.

Bevor Steuerelemente geändert werden, löst das Formular ein bubblendes, abbrechbares reset-Ereignis aus. Ein Aufruf von event.preventDefault() im Handler verhindert den Reset. Werte, die in einem synchronen Handler dieses Ereignisses gelesen werden, werden vor der Wiederherstellung erfasst. Durch den Reset vorgenommene Änderungen lösen keine input-Ereignisse aus.

Vermeide Steuerelemente mit name="reset" oder id="reset": Sie können die Methode überschreiben, sodass form.reset() nicht mehr aufrufbar ist. Bei einer solchen Kollision kannst du HTMLFormElement.prototype.reset.call(form) verwenden. Das Beispiel zeigt sowohl einen normalen Reset als auch dessen Abbruch.

Beispiele

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);

Ergebnis

before reset: Grace
after reset: Ada
before reset: Lin
after canceled reset: Lin

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen