CKTIS / JavaScript
ValidityState: Gesamtstatus und einzelne Validierungsfehler
Mit `element.validity` unterscheidest du einen gültigen Feldzustand von einer fehlenden Pflichtangabe, einem falschen Format oder einer zu kurzen Benutzereingabe.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
const state = input.validity;
state.valid;
state.valueMissing;
state.typeMismatch;
state.tooShort;element.validity liefert für ein Formularfeld ein ValidityState-Objekt. Seine booleschen Eigenschaften sind schreibgeschützt und zeigen den aktuellen Zustand an: Eine gespeicherte Referenz ist keine Momentaufnahme. Es handelt sich um eine Web-API, nicht um einen Bestandteil von ECMAScript.
valid ist nur dann true, wenn kein Fehlerkennzeichen gesetzt ist. Dazu zählen auch hier nicht behandelte Kennzeichen wie customError. Mehrere Fehlerkennzeichen können gleichzeitig true sein. valueMissing ist true, wenn die durch required verlangte Angabe fehlt, etwa bei einem leeren E-Mail-Pflichtfeld.
typeMismatch ist true, wenn ein nicht leerer Wert die HTML-Syntaxregeln für type="email" oder type="url" nicht erfüllt. Bei E-Mail erlaubt multiple eine kommagetrennte Adressliste. Ein leeres E-Mail-Pflichtfeld hat valueMissing, nicht typeMismatch. Die Syntaxprüfung bestätigt nicht, dass eine Adresse existiert.
tooShort ist true, wenn minlength für ein input- oder textarea-Element gilt, das Änderungskennzeichen (dirty value flag) gesetzt ist, die letzte Wertänderung durch den Benutzer erfolgte und der nicht leere API-Wert in UTF-16-Codeeinheiten kürzer als das Minimum ist. minlength allein macht ein Feld nicht zum Pflichtfeld. Eine Zuweisung an .value löst diesen Fehler nicht aus, auch nicht mit anschließendem checkValidity() oder reportValidity().
Prüfe mit valid den Gesamtzustand und wähle anhand der Fehlerkennzeichen eine Rückmeldung. Prüfe übermittelte Daten auch auf dem Server: Die Browservalidierung lässt sich umgehen.
Beispiele
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>ValidityState example</title>
</head>
<body>
<label for="email">Email:</label>
<input id="email" type="email" required minlength="8" autocomplete="off">
<button type="button">Next</button>
<script>
(() => {
const input = document.getElementById('email');
const state = input.validity;
const log = (step) => console.log([
step, state.valid, state.valueMissing, state.typeMismatch, state.tooShort
].join(' '));
input.value = '';
log('empty');
input.value = 'not-an-email';
log('wrong-format');
input.value = 'a@b.co';
log('scripted-short');
input.value = '';
input.addEventListener('change', () => log('user-short'), { once: true });
})();
</script>
</body>
</html>Ergebnis
empty false true false false wrong-format false false true false scripted-short true false false false user-short false false false true
Öffne das Beispiel als HTML-Seite im Browser und sieh dir die Ausgabe in der Browserkonsole an. Tippe nach den ersten drei Zeilen `a@b.co` in das Feld und drücke Tab. Nach der Schrittbezeichnung folgen `valid`, `valueMissing`, `typeMismatch` und `tooShort`. Dieselbe Adresse mit sechs Codeeinheiten ist in beiden Fällen syntaktisch gültig, verletzt `minLength = 8` aber erst nach der manuellen Eingabe.
Zugehörige Lektionen
- JavaScript · Lektion 22 · Mittlere Stufe · Version: 3