CKTIS / JavaScript
HTMLFormElement.checkValidity() — provjera valjanosti obrasca
Metoda form.checkValidity() provjerava ograničenja kontrola povezanih s obrascem i vraća Booleovu vrijednost. Ne šalje obrazac niti prikazuje standardne poruke preglednika za provjeru valjanosti.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
form.checkValidity()HTMLFormElement.checkValidity metoda je web API-ja preglednika, a ne funkcija definirana standardom ECMAScript. Poziv form.checkValidity() ne prima argumente i sinkrono vraća true ako svaka kontrola koja podliježe provjeri valjanosti zadovoljava svoja ograničenja; u suprotnom vraća false.
Provjera obuhvaća kontrole povezane s obrascem, a ne samo njegove potomke. Preskaču se kontrole onemogućene atributom disabled. Ako nijedna kontrola ne podliježe provjeri valjanosti, rezultat je true. Metoda pokreće događaj invalid na svakoj nevaljanoj kontroli; otkazivanje tog događaja ne mijenja rezultat u true.
Metoda ne šalje obrazac niti sama prikazuje standardno sučelje za pogreške. Upotrijebite form.reportValidity() za provjeru problema i njihovo prijavljivanje korisniku. Provjera valjanosti u pregledniku ne zamjenjuje provjeru na poslužiteljskoj strani.
Primjer stvara obrazac s obveznim tekstnim poljem. Prazno polje daje rezultat false i jedan događaj invalid; nakon dodjele vrijednosti Ada, rezultat je true. Pokrenite kod u pregledniku: samo okruženje Node.js 24 ne dokazuje da je ovaj API dostupan.
Primjeri
(() => {
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);
})();Rezultat
false true 1
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.