Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

ValidityState: validez general y causas del error

Consulta `element.validity` para distinguir un campo válido de uno sin el valor obligatorio, con un formato incorrecto o con una entrada de usuario demasiado corta.

Versión: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxis

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

element.validity devuelve un objeto ValidityState asociado a un control de formulario. Sus propiedades booleanas son de solo lectura y reflejan el estado actual: conservar el objeto no congela sus valores. Es una API de la plataforma web, no de ECMAScript.

valid solo es true si no se activa ningún indicador de error, incluidos otros no descritos aquí, como customError. Varios indicadores pueden ser true a la vez. valueMissing es true cuando falta el valor exigido por required, como en un campo de correo electrónico obligatorio vacío.

typeMismatch es true si un valor no vacío incumple las reglas de sintaxis HTML de type="email" o type="url". En el tipo de correo, multiple permite una lista de direcciones separadas por comas. Un campo de correo obligatorio vacío tiene valueMissing, no typeMismatch. La comprobación de sintaxis no demuestra que la dirección exista.

tooShort es true cuando minlength se aplica a un input o textarea, está activo el indicador de modificación (dirty value flag), el último cambio del valor lo hizo el usuario y el valor no vacío expuesto por la API tiene menos unidades de código UTF-16 que el mínimo. minlength por sí solo no hace obligatorio el campo. Asignar .value no activa este error, aunque después llames a checkValidity() o reportValidity().

Usa valid para comprobar el estado general del campo y los indicadores de error para elegir el mensaje. Vuelve a validar los datos enviados en el servidor: la validación del navegador se puede eludir.

Ejemplos

<!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>

Resultado

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

Abre el ejemplo como página HTML en un navegador y consulta la salida en la consola del navegador. Tras las tres primeras líneas, escribe `a@b.co` en el campo y pulsa Tab. Después de la etiqueta del paso aparecen `valid`, `valueMissing`, `typeMismatch` y `tooShort`, en ese orden. La misma dirección de seis unidades de código es sintácticamente válida en ambos casos, pero incumple `minLength = 8` solo tras introducirla a mano.

Lecciones relacionadas

  • JavaScript · Lección 22 · Intermedio · Versión: 3

Fuentes