CKTIS / JavaScript
HTMLInputElement.checkValidity() — проверка на валидността на поле за въвеждане
Методът checkValidity() проверява ограниченията на едно поле input и връща булева стойност. Ако невалидно поле участва във валидацията, задейства invalid, но сам по себе си не показва съобщение за грешка.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
input.checkValidity()HTMLInputElement.checkValidity е метод на екземпляр, който се извиква без аргументи като input.checkValidity(). Връща false, когато полето участва във валидацията и нарушава ограниченията си; в противен случай връща true.
Ограниченията зависят от типа на полето и атрибути като required, pattern, min и max. Поле с disabled не участва във валидацията: следователно true не означава непременно, че стойността му е валидна. Свойството willValidate показва дали полето участва.
При резултат false методът задейства събитие invalid; отмяната му не променя резултата. За разлика от reportValidity(), той не показва съобщение за грешка. Не изпраща формуляра и не проверява останалите полета.
Този браузърен API е определен от HTML Living Standard, а не от ECMAScript. Поддържа се от съвременните браузърни енджини; наличието на Node 24 в хранилище не доказва поддръжка на този API.
Примери
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);Резултат
false true true 1
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.