CKTIS / JavaScript
HTMLInputElement.checkValidity() — de geldigheid van een invoerveld controleren
De methode checkValidity() controleert de beperkingen van één inputveld en geeft een boolean terug. Als een ongeldig veld aan de validatie deelneemt, activeert de methode invalid, maar toont ze zelf geen foutmelding.
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.checkValidity()HTMLInputElement.checkValidity is een instantiemethode die je zonder argumenten aanroept als input.checkValidity(). De methode geeft false terug als het veld aan validatie deelneemt en de beperkingen schendt; anders geeft ze true terug.
De beperkingen hangen af van het veldtype en attributen zoals required, pattern, min en max. Een disabled veld neemt niet deel aan validatie: true betekent dus niet noodzakelijk dat de waarde geldig is. De eigenschap willValidate geeft aan of het veld deelneemt.
Bij een resultaat van false activeert de methode een invalid-gebeurtenis; die annuleren verandert het resultaat niet. Anders dan reportValidity() toont de methode geen foutmelding. Ze verzendt het formulier niet en controleert geen andere velden.
Deze browser-API is vastgelegd in de HTML Living Standard, niet in ECMAScript. De API wordt ondersteund door huidige browser-engines; de aanwezigheid van Node 24 in een repository bewijst niet dat deze API wordt ondersteund.
Voorbeelden
const input = document.createElement('input');
input.type = 'text';
input.required = true;
let invalidEvents = 0;
input.addEventListener('invalid', () => { invalidEvents += 1; });
console.log(input.checkValidity());
input.value = 'Ada';
console.log(input.checkValidity());
input.value = '';
input.disabled = true;
console.log(input.checkValidity());
console.log(invalidEvents);Resultaat
false true true 1
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.