KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

ValidityState — validatiestatus van een formulierveld

ValidityState biedt alleen-lezen foutvlaggen voor een formulierveld. Hiermee kun je een ontbrekende verplichte waarde, een onjuist formaat en tekst die te kort is onderscheiden, met een belangrijke uitzondering voor waarden die door scripts zijn ingesteld.

Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

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

ValidityState is een interface van de HTML Web API en geen onderdeel van ECMAScript. Het object dat beschikbaar is via input.validity wordt voortdurend bijgewerkt; de booleaanse vlaggen zijn alleen-lezen. ValidityState.valid is true wanneer geen van de andere foutvlaggen is ingesteld.

ValidityState.valueMissing geeft aan dat niet aan de beperking required is voldaan: bij een tekstveld betekent dit dat de waarde leeg is. ValidityState.typeMismatch betekent dat een waarde niet voldoet aan de regels voor het type email of url, niet aan die voor een JavaScript-gegevenstype. Een leeg e-mailadres veroorzaakt deze fout niet op zichzelf.

ValidityState.tooShort geldt voor een niet-lege waarde die korter is dan minlength in een veld dat deze beperking ondersteunt. De dirty value-vlag moet zijn ingesteld en de laatste wijziging van de waarde moet door de gebruiker zijn gedaan. Een toewijzing aan .value activeert deze lengtetest niet; minlength vereist op zichzelf geen waarde.

Het voorbeeld behoudt één statusobject en leest dat na wijzigingen uit. Voor 'x' blijft tooShort false, omdat een script de waarde instelt. Voer het uit in een browser; de aanwezigheid van Node 24 in de repository bewijst niet dat deze API wordt ondersteund.

Voorbeelden

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

Resultaat

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

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen