FormData e Validação no DOM: Constraint Validation no JS
⚡ Curso de DOM • Web-ZoneWare

FormData API & Constraint Validation API: Formulários Reativos e Validação no DOM

Lição 43 de 50

FormData API & Constraint Validation API: Formulários Reativos e Validação no DOM

Formulários corporativos em sistemas modernos vão muito além de simples caixas de texto com envio síncrono. Eles exigem upload de múltiplos arquivos binários (fotos, PDFs, contratos), validações contextuais ricas de regras de negócio em tempo real (como algoritmos de CPF/CNPJ ou confirmação de senhas idênticas) e mensagens de erro nativas perfeitamente acessíveis em conformidade com leitores de tela.

Encerrando o Módulo 5: Geometria, Rolagem, Observadores & APIs Modernas do DOM, esta lição aprofundada examina a fundo o poder total da interface FormData para construção e mutação programática de payloads multipart/form-data. Você também desvendará a Constraint Validation API nativa do navegador: aprenderá a dissecar as 9 flags booleanas do objeto validity, dominará mensagens em português customizadas com setCustomValidity() e utilizará os modernos seletores CSS :user-valid e :user-invalid para uma experiência do usuário impecável.


1. Manipulação Programática Avançada com a Interface `FormData`

A interface FormData não serve apenas para extrair valores de formulários estáticos; ela é uma estrutura de dados mutável para compor requisições HTTP multipart diretamente no JavaScript:

JavaScript (Métodos CRUD do FormData)
JavaScript 24 linhas
const payload = new FormData();
 
// 1. append(chave, valor): Adiciona um novo par (permite chaves duplicadas para múltiplos anexos)
payload.append('usuarioId', '804');
payload.append('tags', 'javascript');
payload.append('tags', 'dom');
 
// 2. set(chave, valor): Define ou substitui o valor da chave existente
payload.set('usuarioId', '905');
 
// 3. append com arquivo binário (File ou Blob)
const arquivoPdf = inputArquivo.files[0];
payload.append('documento', arquivoPdf, 'relatorio-anual.pdf');
 
// 4. delete(chave) e has(chave)
if (payload.has('tempData')) {
    payload.delete('tempData');
}
 
// 5. Envio assíncrono direto via fetch (o navegador gera o boundary multipart automaticamente!)
await fetch('/api/upload', {
    method: 'POST',
    body: payload // NUNCA defina o cabeçalho ___WZW_STR_0___ manualmente ao enviar FormData!
});

2. A Constraint Validation API e o Objeto `ValidityState`

Todo elemento de formulário HTML (<input>, <select>, <textarea>) disponibiliza a propriedade input.validity, que retorna um objeto ValidityState com 9 flags booleanas de diagnóstico:

Propriedade de `validity` Causa do Erro Atributo HTML Relacionado
validity.valueMissing Campo obrigatório deixado em branco pelo usuário. required
validity.typeMismatch Sintaxe incorreta para o tipo de campo (ex: texto sem arroba em email). type="email", type="url"
validity.patternMismatch O valor não satisfaz a expressão regular exigida. pattern="[0-9]{5}-[0-9]{3}"
validity.tooShort / tooLong Quantidade de caracteres abaixo do mínimo ou acima do máximo. minlength, maxlength
validity.rangeUnderflow / rangeOverflow Valor numérico ou data além dos limites permitidos. min, max
validity.stepMismatch Número não alinhado com o incremento estipulado. step="0.01"
validity.customError Uma mensagem customizada foi ativada via JavaScript. input.setCustomValidity('...')
validity.valid Retorna true apenas se todas as outras 8 flags forem falsas! –

3. Validações Customizadas em Português com `setCustomValidity()`

As mensagens de erro padrão do navegador variam entre idiomas e navegadores. Com setCustomValidity(), você define regras de negócio personalizadas em português:

JavaScript (Validação de Confirmação de Senha)
JavaScript 15 linhas
const senhaInput = document.querySelector('#senha');
const confirmacaoInput = document.querySelector('#confirmar-senha');
 
function validarCoincidenciaSenhas() {
    if (senhaInput.value !== confirmacaoInput.value) {
        // Define a mensagem de erro: o campo torna-se INVALID automaticamente!
        confirmacaoInput.setCustomValidity('As senhas digitadas não coincidem!');
    } else {
        // String vazia limpa o erro: o campo volta a ser VÁLIDO!
        confirmacaoInput.setCustomValidity('');
    }
}
 
senhaInput.addEventListener('input', validarCoincidenciaSenhas);
confirmacaoInput.addEventListener('input', validarCoincidenciaSenhas);

4. Disparo de Balão Nativo com `reportValidity()`

Diferente de checkValidity() (que apenas retorna um booleano silencioso), o método reportValidity() avalia o campo e, caso seja inválido, exibe instantaneamente o balão de erro nativo do navegador com foco automático no primeiro elemento com falha:

JavaScript 4 linhas
const formValido = formulario.reportValidity();
if (!formValido) {
    console.warn('O usuário foi notificado visualmente dos campos com erro!');
}

5. As Modernas Pseudo-Classes CSS `:user-valid` e `:user-invalid`

Historicamente, a pseudo-classe :invalid marcava campos vazios como vermelhos no instante em que a página carregava, assustando o usuário. Os padrões modernos introduziram :user-invalid e :user-valid: essas regras só são aplicadas depois que o usuário interagiu com o campo e retirou o foco, proporcionando um feedback natural e elegante:

CSS3 9 linhas
/* Aplica borda vermelha e ícone de alerta somente após a interação do usuário */
input:user-invalid {
    border-color: #ef4444;
    background-color: rgba(239, 68, 68, 0.05);
}
 
input:user-valid {
    border-color: #10b981;
}

6. Laboratório Interativo no Playground IDE

No laboratório prático desta lição, você operará um centro de submissão avançado com upload de arquivo contendo: validador de tamanho de arquivo binário (Blob/File) com setCustomValidity(), validador de confirmação de senha em tempo real, um Inspetor de ValidityState que desmonta as 9 flags booleanas de validação a cada tecla digitada e montagem dinâmica de payload com FormData com envio simulado e exibição do payload final.

🛠️ Laboratório Prático & Prática Imediata

Aplique o que você aprendeu nesta lição

Utilize nossas ferramentas online gratuitas para experimentar os conceitos ou teste o código ao vivo no Playground IDE.

💻 Desenvolvedor & Código

Editor de Códigos Web Online

Ambiente com destaque de sintaxe para você testar tags, tabelas e scripts na hora.

Abrir Ferramenta Online
⚡ Live Code Studio

Playground Web Online

Escreva seu código HTML, CSS ou JavaScript e veja o resultado renderizado ao vivo no navegador com zero configuração.

⚡ Codificar no Playground IDE
Foto de Web-Zoneware
✓ Verificado
🎓 Tutor & Coordenador da Web Academy

Web-Zoneware

Tutor Técnico & Desenvolvedor Full-Stack

Desenvolvedor web e instrutor focado na formação prática de novos programadores. Defensor ferrenho de código semântico, arquitetura limpa e acessibilidade W3C/WCAG, dedicando-se a construir cursos estruturados em metodologia passo a passo com execução ao vivo no Playground IDE.

Especialidades: HTML5 Semântico CSS3 & Flexbox/Grid JavaScript Moderno Acessibilidade WCAG 2.2 Didática Prática
Rolar para cima