Por que cai em entrevista
Formulário é onde o front-end encontra o usuário real, e muita etapa de take-home ou live coding inclui um. Mostrar uma mensagem vermelha é a parte fácil; garantir que qualquer pessoa encontre e corrija o erro é o que vale nota.
Você vai ligar cada mensagem ao campo com aria-describedby, marcar o campo inválido, impedir o envio com erro e levar o foco ao primeiro campo que precisa de correção, tudo em React puro, sem biblioteca de formulário.
O que você vai construir
- Campos com rótulo "Email" e "Password" e um botão de envio "Create account".
- E-mail vazio mostra "Email is required"; e-mail sem usuário, @ e domínio mostra "Enter a valid email".
- Senha com menos de 8 caracteres mostra "Password must be at least 8 characters".
- Campo inválido tem aria-invalid="true" e aria-describedby apontando para o erro dele.
- Com erro, onSubmit não é chamado e o foco vai para o primeiro campo inválido.
- Se estiver válido, onSubmit é chamado uma vez com o e-mail sem espaços nas pontas e a senha como foi digitada.
Fora do escopo: Validar enquanto digita. Biblioteca de formulário. React puro basta aqui.
Como você será avaliado
Passar nos testes é o começo. Na conversa depois, uma boa explicação cobre:
- Explica por que o foco vai para o primeiro campo inválido.
- Diz como os erros chegam à tecnologia assistiva.
- Justifica campo controlado ou não controlado neste caso.
Código inicial
/src/SignupForm.tsx
type Values = { email: string; password: string };export function SignupForm({ onSubmit }: { onSubmit: (values: Values) => void }) {// implemente aquireturn (<form><label htmlFor="email">Email</label><input id="email" type="email" /><label htmlFor="password">Password</label><input id="password" type="password" /><button type="submit">Create account</button></form>);}
Ver os testes que vão rodar /src/SignupForm.test.tsx
import "@testing-library/jest-dom";import { render, screen, fireEvent } from "@testing-library/react";import { SignupForm } from "./SignupForm";const email = () => screen.getByLabelText("Email");const password = () => screen.getByLabelText("Password");const fill = (field: HTMLElement, value: string) => fireEvent.change(field, { target: { value } });const submit = () => fireEvent.click(screen.getByRole("button", { name: "Create account" }));describe("SignupForm", () => {it("submits once with the trimmed email", () => {const onSubmit = jest.fn();render(<SignupForm onSubmit={onSubmit} />);fill(email(), " [email protected] ");fill(password(), "12345678");submit();expect(onSubmit).toHaveBeenCalledTimes(1);expect(onSubmit).toHaveBeenCalledWith({ email: "[email protected]", password: "12345678" });});it("does not submit when the fields are empty", () => {const onSubmit = jest.fn();render(<SignupForm onSubmit={onSubmit} />);submit();expect(onSubmit).not.toHaveBeenCalled();expect(screen.getByText("Email is required")).toBeInTheDocument();expect(screen.getByText("Password must be at least 8 characters")).toBeInTheDocument();});it("rejects an email without a domain", () => {render(<SignupForm onSubmit={jest.fn()} />);fill(email(), "ana@");submit();expect(screen.getByText("Enter a valid email")).toBeInTheDocument();});it("links each error to its field", () => {render(<SignupForm onSubmit={jest.fn()} />);submit();expect(email()).toHaveAttribute("aria-invalid", "true");const errorId = email().getAttribute("aria-describedby") ?? "";expect(document.getElementById(errorId)).toHaveTextContent("Email is required");});it("moves focus to the first invalid field", () => {render(<SignupForm onSubmit={jest.fn()} />);fill(email(), "[email protected]");fill(password(), "short");submit();expect(password()).toHaveFocus();});it("clears an error once the field is fixed", () => {const onSubmit = jest.fn();render(<SignupForm onSubmit={onSubmit} />);submit();fill(email(), "[email protected]");fill(password(), "12345678");submit();expect(screen.queryByText("Email is required")).not.toBeInTheDocument();expect(email()).toHaveAttribute("aria-invalid", "false");expect(onSubmit).toHaveBeenCalledTimes(1);});});
Dicas
Abra só se travar. Cada uma entrega um pouco mais.
Dica 1
Escreva validate(values) como função pura que devolve um objeto de erros. O render e o foco leem dele.
Dica 2
noValidate no form desliga os balões do navegador, então só as suas mensagens aparecem.
