CKTIS / JavaScript
HTMLInputElement.validity — geldigheidsstatus van een invoerveld
HTMLInputElement.validity geeft de huidige status van de beperkingsvalidatie van een invoerveld weer als een ValidityState-object. De vlaggen geven specifieke problemen aan; valid laat zien of er geen foutvlag is ingesteld.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
input.validity
input.validity.valid
input.validity.valueMissingHTMLInputElement.validity is een alleen-lezen-eigenschap die een live ValidityState-object retourneert: een bewaarde verwijzing weerspiegelt latere wijzigingen aan het invoerveld. De vlaggen zijn ook alleen-lezen. Deze browser-API is gedefinieerd door HTML, niet door ECMAScript; de beschikbaarheid van Node.js alleen biedt geen garantie op ondersteuning.
valueMissing geeft aan dat een verplichte waarde ontbreekt, typeMismatch dat de indeling niet bij het type past en patternMismatch dat de waarde niet overeenkomt met pattern. De overige foutvlaggen zijn tooLong, tooShort, rangeUnderflow, rangeOverflow, stepMismatch, badInput en customError. Of ze van toepassing zijn, hangt af van het invoertype en de beperkingen. valid is true wanneer alle foutvlaggen false zijn.
Het uitlezen van validity toont geen melding en activeert geen invalid. checkValidity() controleert het element en kan invalid activeren; reportValidity() kan het probleem ook aan de gebruiker tonen. willValidate bepaalt of het element aan de validatie deelneemt: een uitgeschakeld invoerveld kan nog steeds foutvlaggen hebben, hoewel het niet aan de controle deelneemt.
setCustomValidity('Blocked') stelt customError in; wis deze met setCustomValidity(''). Alleen de waarde corrigeren wist de fout niet. Het voorbeeld laat zien hoe wijzigingen zichtbaar worden via het bewaarde object state, zonder input.validity opnieuw uit te lezen. Browservalidatie vervangt controles van gegevens aan de serverzijde niet.
Voorbeelden
const input = document.createElement('input');
input.type = 'email';
input.required = true;
const state = input.validity;
console.log(state.valueMissing, state.valid);
input.value = 'learner@example.com';
console.log(state.valueMissing, state.valid);
input.setCustomValidity('Blocked');
console.log(state.customError, state.valid);
input.setCustomValidity('');
console.log(state.customError, state.valid);Resultaat
true false false true true false false true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.