KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

ValidityState: geldigheid en specifieke validatiefouten

Lees `element.validity` om een geldig veld te onderscheiden van een ontbrekende verplichte waarde, een onjuist formaat of te korte gebruikersinvoer.

Versie: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

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

element.validity geeft het ValidityState-object van een formulierveld terug. De booleaanse eigenschappen zijn alleen-lezen en weerspiegelen de actuele toestand: een bewaarde referentie is geen momentopname. Dit is een webplatform-API, geen onderdeel van ECMAScript.

valid is alleen true als geen enkele foutvlag is ingesteld, ook geen vlag die hier niet wordt behandeld, zoals customError. Meerdere foutvlaggen kunnen tegelijk true zijn. valueMissing is true als de door required vereiste waarde ontbreekt, bijvoorbeeld bij een leeg verplicht e-mailveld.

typeMismatch is true als een niet-lege waarde niet voldoet aan de HTML-syntaxis voor type="email" of type="url". Voor e-mail staat multiple een lijst met door komma’s gescheiden adressen toe. Een leeg verplicht e-mailveld heeft valueMissing, niet typeMismatch. Een syntaxiscontrole bevestigt niet dat een adres bestaat.

tooShort is true als minlength van toepassing is op een input of textarea, de wijzigingsvlag (dirty value flag) is ingesteld, de gebruiker de waarde als laatste heeft gewijzigd en de niet-lege API-waarde minder UTF-16-code-eenheden telt dan het minimum. minlength alleen maakt een veld niet verplicht. Een toekenning aan .value veroorzaakt deze fout niet, ook niet als je vervolgens checkValidity() of reportValidity() aanroept.

Gebruik valid om de algemene toestand van het veld te controleren en de foutvlaggen om een passende melding te kiezen. Valideer verzonden gegevens ook op de server: browservalidatie kan worden omzeild.

Voorbeelden

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>ValidityState example</title>
</head>
<body>
  <label for="email">Email:</label>
  <input id="email" type="email" required minlength="8" autocomplete="off">
  <button type="button">Next</button>

  <script>
    (() => {
      const input = document.getElementById('email');
      const state = input.validity;
      const log = (step) => console.log([
        step, state.valid, state.valueMissing, state.typeMismatch, state.tooShort
      ].join(' '));

      input.value = '';
      log('empty');
      input.value = 'not-an-email';
      log('wrong-format');
      input.value = 'a@b.co';
      log('scripted-short');

      input.value = '';
      input.addEventListener('change', () => log('user-short'), { once: true });
    })();
  </script>
</body>
</html>

Resultaat

empty false true false false
wrong-format false false true false
scripted-short true false false false
user-short false false false true

Open het voorbeeld als HTML-pagina in een browser en bekijk de uitvoer in de browserconsole. Typ na de eerste drie regels `a@b.co` in het veld en druk op Tab. Na het staplabel volgen `valid`, `valueMissing`, `typeMismatch` en `tooShort`. Hetzelfde adres van zes code-eenheden is in beide gevallen syntactisch geldig, maar voldoet pas na handmatige invoer niet aan `minLength = 8`.

Gerelateerde lessen

  • JavaScript · Les 22 · Gemiddeld · Versie: 3

Bronnen