React e TypeScript
Coloque o estado em um único lugar
Cada valor deve ter exatamente um dono. A maioria dos bugs do React são duas cópias do mesmo fato discordando.
Derive em vez de armazenar. Se um valor pode ser computado a partir de props e estado durante a renderização,
compute-o — não o espelhe em useState, porque a cópia fica desatualizada no momento em que sua fonte
muda. const total = items.reduce(...) não precisa de estado e nunca pode estar errado.
Estado copiado de uma prop é o mesmo bug com um fusível mais longo: o valor inicial de useState é
lido uma vez e ignorado para sempre depois. Se o componente deve ser redefinido quando uma prop mudar, dê a ele uma
key e deixe o React remontá-lo.
Eleve o estado apenas até o pai comum mais próximo que precisar dele. Elevar mais longe faz com que todos os irmãos sejam renderizados novamente a cada tecla.
Efeitos
Um efeito sincroniza com algo fora do React: uma assinatura, um timer, o documento, uma biblioteca imperativa. Não é o lugar para computar valores ou responder a um clique — o manipulador de eventos o é.
A lista de dependências deve listar tudo que o efeito lê. Omitir um valor para interromper um loop
congela-o em seu primeiro valor e produz o bug de closure desatualizado. Se o efeito entrar em loop porque uma
dependência é um objeto ou função reconstruída a cada renderização, corrija a dependência — useCallback,
useMemo, ou mova-a para fora do componente — em vez de deletá-la da lista.
Retorne uma função de limpeza sempre que o efeito iniciar algo que possa sobreviver a ele. Assinaturas, timers e requisições em andamento precisam parar quando o componente desmontar ou as dependências mudarem, e sob o StrictMode em desenvolvimento o efeito é executado duas vezes especificamente para expor uma limpeza ausente.
Uma função async não pode ser o corpo de um efeito — ela retorna uma promise, e o React espera uma função
de limpeza. Declare o trabalho assíncrono dentro e chame-o.
Busca de dados
Prefira a biblioteca de dados do projeto em vez de busca manual em um efeito; ela já resolve o cache, a desduplicação, a repetição e a condição de corrida que você está prestes a escrever.
Ao buscar manualmente, trate todos os quatro estados — carregando, vazio, erro, sucesso — e cancele a requisição na limpeza. Duas requisições iniciadas em ordem ainda podem resolver fora de ordem, então ou cancele a anterior ou ignore uma resposta que não é mais atual.
Nunca engula uma rejeição. Uma rejeição não tratada em um manipulador ou efeito falha silenciosamente e a UI simplesmente para de atualizar.
Renderização
Chaveie listas por uma identidade estável dos dados. Chaves de índice são corretas apenas para uma lista que nunca reordena, insere ou deleta; quando isso acontece, o React reutiliza o nó DOM errado e as entradas mantêm o valor da linha anterior.
Recorra a memo, useMemo e useCallback após medir com o profiler. Aplicados
todo lugar por padrão, eles adicionam alocação e listas de dependências que dão errado, e não resolvem
nada quando o custo real é um pai renderizando toda a árvore novamente.
Nunca chame um hook condicionalmente, em um loop, ou após um retorno antecipado. A ordem deve ser idêntica em toda renderização.
TypeScript
Trate any e uma asserção de tipo como uma pergunta não respondida, não uma correção. Ambos silenciam o compilador
exatamente no lugar onde ele tinha algo útil a dizer. Quando um tipo é genuinamente desconhecido, use
unknown e restrinja-o.
Tipifique o que cruza uma fronteira: respostas de API, valores de formulário, parâmetros de URL. Dados da rede não são do tipo que você declarou até que algo os verifique, então valide na borda e deixe o resto da aplicação confiar no resultado.
Verifique
Uma build verde prova menos do que parece. Muitos projetos configuram o framework para ignorar erros de lint e tipo durante a build, então verifique a configuração antes de tratar a build como evidência, e rode a verificação de tipo e o linter explicitamente.
Em seguida, use o componente: o estado vazio, o estado de erro, uma rede lenta e uma segunda interação rápida antes da primeira terminar.