CKTIS / JavaScript
HTMLFormElement.reportValidity() — convalidare un modulo e segnalare gli errori
HTMLFormElement.reportValidity() verifica i vincoli di convalida dei controlli associati a un modulo e può segnalare gli errori all’utente. Restituisce un booleano e non invia il modulo autonomamente.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
form.reportValidity()HTMLFormElement.reportValidity è un metodo dell’interfaccia dei moduli definito dall’HTML Living Standard, non da ECMAScript. La chiamata form.reportValidity() non accetta argomenti e restituisce sincronicamente true se tutti i controlli soggetti a convalida sono validi, oppure false se almeno uno non lo è.
Il metodo esegue la convalida interattiva di vincoli come required. Attiva eventi invalid sui controlli non validi. Il browser può segnalare gli errori la cui gestione non è stata annullata; aspetto e testo dei messaggi dipendono dal browser. Chiamare event.preventDefault() in un gestore invalid impedisce la segnalazione nativa di quell’errore, ma non modifica il risultato false.
A differenza di reportValidity(), checkValidity() verifica i vincoli senza segnalare gli errori in modo interattivo, ma attiva anch’esso invalid. Nessuno dei due metodi invia il modulo. I controlli disabilitati tramite disabled sono esclusi dalla convalida; la convalida lato client non sostituisce i controlli dei dati lato server.
Questa è un’API del browser: la presenza di Node 24 non ne dimostra la disponibilità. Nell’ambiente di destinazione, controlla typeof HTMLFormElement !== 'undefined' && typeof HTMLFormElement.prototype.reportValidity === 'function'. L’esempio annulla intenzionalmente invalid per verificare i risultati booleani senza dipendere dall’interfaccia dei messaggi di convalida.
Esempi
(() => {
const form = document.createElement('form');
const input = document.createElement('input');
input.required = true;
input.setAttribute('aria-label', 'Name');
form.append(input);
document.body.append(form);
// Suppress native validation UI for deterministic console checks.
input.addEventListener('invalid', event => event.preventDefault());
console.log(form.reportValidity());
input.value = 'Ada';
console.log(form.reportValidity());
form.remove();
})();Risultato
false true
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.