Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

ValidityState — stanje preverjanja veljavnosti polja obrazca

ValidityState ponuja zastavice napak polja obrazca, ki so samo za branje. Omogoča razlikovanje med manjkajočo obvezno vrednostjo, neustrezno obliko in prekratkim besedilom, pri čemer velja pomembna izjema za vrednosti, ki jih nastavijo skripti.

Različica: 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 vmesnik HTML Web API, ne del ECMAScript. Objekt, dostopen prek input.validity, se sproti posodablja; njegove logične zastavice so samo za branje. ValidityState.valid ima vrednost true, kadar ni nastavljena nobena od drugih zastavic napak.

ValidityState.valueMissing označuje, da omejitev required ni izpolnjena: pri besedilnem polju to pomeni prazno vrednost. ValidityState.typeMismatch pomeni, da vrednost ne ustreza pravilom za tip email ali url, ne pa pravilom za podatkovni tip JavaScript. Prazen e-poštni naslov sam po sebi ne povzroči te napake.

ValidityState.tooShort velja za neprazno vrednost, krajšo od minlength, v polju, ki to omejitev podpira. Nastavljena mora biti zastavica dirty value, zadnjo spremembo vrednosti pa mora opraviti uporabnik. Dodelitev vrednosti v .value tega preverjanja dolžine ne sproži; samo minlength ne zahteva vnosa vrednosti.

Primer ohrani en objekt stanja in ga prebere po spremembah. Pri 'x' ostane tooShort enak false, ker vrednost nastavi skript. Zaženi ga v brskalniku; prisotnost Node 24 v repozitoriju ne dokazuje podpore za ta API.

Primeri

(() => {
  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}

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri