Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

ValidityState — stanje provjere valjanosti polja obrasca

ValidityState izlaže zastavice pogrešaka polja obrasca samo za čitanje. Omogućuje razlikovanje nedostajuće obavezne vrijednosti, neispravnog formata i prekratkog teksta, uz važnu iznimku za vrijednosti koje postavljaju skripte.

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

const state = input.validity;
state.valid;
state.valueMissing;
state.typeMismatch;
state.tooShort;

ValidityState je sučelje HTML Web API-ja, a ne dio ECMAScripta. Objekt dostupan putem input.validity ažurira se u stvarnom vremenu; njegove Booleove zastavice samo su za čitanje. ValidityState.valid ima vrijednost true kada nije postavljena nijedna od ostalih zastavica pogreške.

ValidityState.valueMissing označava da ograničenje required nije ispunjeno: u tekstualnom polju to znači da je vrijednost prazna. ValidityState.typeMismatch znači da vrijednost ne odgovara pravilima vrste email ili url, a ne vrsti podataka JavaScripta. Prazna adresa e-pošte sama po sebi ne uzrokuje tu pogrešku.

ValidityState.tooShort odnosi se na nepraznu vrijednost kraću od minlength u polju koje podržava to ograničenje. Zastavica dirty value mora biti postavljena, a posljednju promjenu vrijednosti morao je napraviti korisnik. Dodjela vrijednosti u .value ne pokreće tu provjeru duljine; sam minlength ne zahtijeva unos vrijednosti.

Primjer zadržava jedan objekt stanja i čita ga nakon promjena. Za 'x' tooShort ostaje false jer vrijednost postavlja skripta. Pokrenite ga u pregledniku; prisutnost Nodea 24 u repozitoriju ne dokazuje podršku za ovaj API.

Primjeri

(() => {
  const input = document.createElement('input');
  input.type = 'email';
  input.required = true;
  input.minLength = 8;
  const state = input.validity;

  const show = () => console.log(JSON.stringify({
    valid: state.valid,
    valueMissing: state.valueMissing,
    typeMismatch: state.typeMismatch,
    tooShort: state.tooShort
  }));

  show();
  input.value = 'x';
  show();
  input.value = 'a@example.com';
  show();
})();

Rezultat

{"valid":false,"valueMissing":true,"typeMismatch":false,"tooShort":false}
{"valid":false,"valueMissing":false,"typeMismatch":true,"tooShort":false}
{"valid":true,"valueMissing":false,"typeMismatch":false,"tooShort":false}

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori