Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori