Em 1 minuto
- Delimite requisitos e organize uma primeira entrega que funcione.
- Revise estados vazios, falhas, recuperação, teclado e conteúdo em telas estreitas.
- Documente execução, testes, decisões e limitações para facilitar a avaliação.
O teste técnico front-end começa com a leitura do problema e termina quando outra pessoa consegue executar e avaliar sua entrega. Nesse intervalo, você precisa decidir o que fazer primeiro, quais estados demonstrar e como registrar limitações. Um take-home não melhora automaticamente quando ganha mais arquivos ou bibliotecas. Ele melhora quando o comportamento pedido fica claro, funciona e pode ser conferido.
Este roteiro acompanha um projeto feito para casa, com prazo combinado e possibilidade de documentar escolhas. Para comparar a proposta com outros formatos de teste de código, consulte o guia geral. Aqui, concentre sua preparação em transformar o enunciado em uma entrega pequena e revisável, preservando tempo para conferir o projeto do ponto de vista de quem o recebe.
Como interpretar o teste técnico front-end
Leia o enunciado inteiro antes de criar componentes. Separe comportamentos obrigatórios, restrições de tecnologia e materiais de referência. Uma imagem pode mostrar aparência sem definir interação; uma API de exemplo pode não explicar os estados de falha. Anote essas lacunas e envie perguntas objetivas. Perguntar se a seleção precisa sobreviver ao recarregamento é mais útil do que pedir uma descrição genérica do que esperam.
Confirme prazo de calendário e expectativa de esforço como informações distintas. Se a proposta permitir escolhas, declare as premissas no README. Não transforme uma ausência de resposta em autorização para ampliar o produto. Em um desafio técnico de catálogo, por exemplo, autenticação e pagamento só entram se fizerem parte do escopo. O fluxo principal precisa de atenção antes de qualquer demonstração extra.
Escopo e critérios de aceite
Converta cada requisito em algo observável. Troque 'interface robusta' por descrições como 'quando a busca falha, a tela mostra uma mensagem e permite tentar novamente'. Esse nível de detalhe ajuda a estimar trabalho e testar a entrega. Escreva também o que fica fora: paginação real pode depender de um contrato que a API fornecida não oferece. Registre a restrição sem simular uma capacidade inexistente.
- Prioridade inicial: fluxo pedido funcionando com dados e estados coerentes.
- Revisão obrigatória: teclado, mensagens, adaptação ao tamanho de tela e testes do risco principal.
- Melhorias opcionais: somente as que cabem depois da revisão e têm benefício explicado.
Use os critérios de avaliação técnica para revisar evidências, sem presumir uma rubrica universal. Se faltar tempo, escolha explicitamente uma entrega menor. Um requisito incompleto deve aparecer como pendência, com impacto e próximo passo. Evite escrever 'faltou polir' quando na verdade uma ação importante ainda não funciona: isso dificulta a avaliação e a conversa posterior.
Componentes e primeira entrega executável
Construa uma fatia completa do fluxo antes de espalhar trabalho por todas as telas. Para uma página de artigos, isso pode significar carregar os dados, exibir um título e oferecer nova tentativa quando a consulta falha. Escolha limites de componente por responsabilidade observável. Uma função de transformação de dados não precisa ficar misturada à marcação; um elemento usado uma vez não precisa virar uma biblioteca.
O contrato abaixo descreve estados de carregamento de artigos. Ele permite sucesso vazio e erro com mensagem, sem combinar indicadores contraditórios. É um exemplo de modelagem para orientar a interface, não uma implementação completa. Em um desafio técnico React, você também precisa decidir quem possui esse estado e quais eventos o alteram. Explique essa escolha com o fluxo, não com preferência pessoal.
type Article = { id: string; title: string };type ArticleState =| { status: "loading" }| { status: "error"; message: string }| { status: "success"; articles: readonly Article[] };function articleSummary(state: ArticleState): string {switch (state.status) {case "loading": return "Loading articles";case "error": return state.message;case "success": return state.articles.length + " articles";}}
Mantenha a versão executável ao longo da implementação. Se a API ainda não estiver disponível, use dados de exemplo identificados como tais e concentre a adaptação em um ponto claro. Não apresente dados locais como integração real. Registre o que precisaria mudar quando o contrato definitivo chegar e quais testes dependem dessa integração.

Estados, acessibilidade e testes antes do envio
Confira falhas
Revise a interface sem depender apenas do caminho feliz. Abra a tela sem dados, provoque uma falha controlada e confira a recuperação.
Use o teclado
Percorra as ações com o teclado e observe nomes, foco visível e ordem de navegação.
Teste conteúdo longo
Teste uma janela estreita com conteúdo comprido, não somente com os rótulos curtos do exemplo. Uma tela aparentemente pronta pode esconder informações quando recebe dados reais.
Escolha testes pelo risco da entrega. Se a regra central calcula disponibilidade, verifique essa regra diretamente. Se o risco está na interação, confirme o resultado depois da ação do usuário. Não crie dezenas de testes de detalhes internos para compensar a ausência do fluxo principal. Na revisão final, execute os comandos que você indicará ao avaliador e registre qualquer limitação do ambiente.
README e apresentação das decisões
Faça
- O README deve reduzir o esforço de abrir o projeto: informe requisitos do ambiente, comandos de execução e teste, comportamento entregue e limitações conhecidas.
- Explique decisões que mudam a avaliação: dados simulados, ausência de persistência ou tratamento de uma ambiguidade do enunciado. O leitor precisa entender por que uma escolha foi adequada para aquela tarefa.
Evite
- Listar tecnologias sem contexto.
Confira o acesso ao repositório e a referência exata da entrega. Em uma apresentação, demonstre primeiro o fluxo pedido e depois uma falha com recuperação. Relacione cada limitação a um próximo passo concreto. Se a etapa seguinte acontecer em uma plataforma, veja também a preparação para teste de código online, pois instalação local e submissão em editor têm cuidados operacionais diferentes.
Perguntas frequentes
Como organizar um teste técnico front-end?
Leia as regras, transforme requisitos em critérios de aceite e implemente primeiro um fluxo completo. Reserve tempo para estados de erro, acessibilidade, testes e documentação. A ordem deve acompanhar o que o enunciado pede e o risco de cada parte.
O que colocar no README de um take-home?
Inclua requisitos, comandos, decisões relevantes, verificações realizadas e pendências. Diferencie integração real de dados simulados. Explique como reproduzir o comportamento principal e informe limitações que possam afetar a avaliação, sem esconder trabalho incompleto atrás de termos vagos.
O que fazer se o teste técnico pedir trabalho demais?
Converse sobre expectativa de esforço e prioridade dos requisitos antes de ampliar a entrega. Proponha um recorte verificável e registre o acordo. Se não houver resposta, declare a premissa de escopo e o que você conseguiu concluir no prazo.
Como entregar um teste técnico que ficou incompleto?
Entregue uma versão executável, identifique requisitos pendentes e descreva impacto e próximo passo. Informe os testes que realmente rodaram. Não garanta que o resultado será aprovado; torne a situação clara para que o avaliador possa discutir suas decisões.
Pratique com testes de verdade
Resolva exercícios de front-end no navegador, com os mesmos testes que um avaliador rodaria.
Ver os exercícios