CKTIS / JavaScript
HTMLFormElement.checkValidity() — formuliergeldigheid controleren
De methode form.checkValidity() controleert de beperkingen van besturingselementen die aan een formulier zijn gekoppeld en geeft een boolean terug. De methode verzendt het formulier niet en toont ook geen standaardvalidatiemeldingen van de browser.
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
form.checkValidity()HTMLFormElement.checkValidity is een methode van de Web API van de browser, geen functie die door ECMAScript is gedefinieerd. De aanroep form.checkValidity() heeft geen argumenten en geeft synchroon true terug als elk besturingselement dat voor validatie in aanmerking komt aan de beperkingen voldoet; anders geeft de methode false terug.
De controle omvat besturingselementen die aan het formulier zijn gekoppeld, niet alleen de afstammelingen ervan. Besturingselementen die met disabled zijn uitgeschakeld, worden overgeslagen. Als geen enkel besturingselement voor validatie in aanmerking komt, is het resultaat true. De methode verstuurt een invalid-gebeurtenis op elk ongeldig besturingselement; het annuleren van die gebeurtenis verandert het resultaat niet in true.
De methode verzendt het formulier niet en toont zelf ook niet de standaardfoutinterface. Gebruik form.reportValidity() om problemen te controleren en aan de gebruiker te melden. Validatie in de browser vervangt validatie aan de serverkant niet.
Het voorbeeld maakt een formulier met een verplicht tekstveld. Het lege veld levert false en één invalid-gebeurtenis op; na toewijzing van Ada is het resultaat true. Voer de code uit in een browser: een Node.js 24-omgeving alleen bewijst niet dat deze API beschikbaar is.
Voorbeelden
(() => {
const form = document.createElement('form');
const input = document.createElement('input');
input.required = true;
form.append(input);
let invalidEvents = 0;
input.addEventListener('invalid', () => { invalidEvents += 1; });
console.log(form.checkValidity());
input.value = 'Ada';
console.log(form.checkValidity());
console.log(invalidEvents);
})();Resultaat
false 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.