База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници