Aula 49 — Boas práticas de código JavaScript

Ao longo do curso, aprendemos variáveis, funções, arrays, objetos, assincronicidade, APIs, módulos e organização de projetos.

Agora é hora de responder uma pergunta essencial:

O que diferencia um código que funciona de um código bem escrito?

Nesta aula, vamos aprender as boas práticas que tornam o código mais legível, confiável e profissional.

🎯 Objetivo da aula

Ao final desta aula, você será capaz de:

• Escrever código mais legível
• Evitar erros comuns
• Facilitar manutenção futura
• Adotar hábitos de desenvolvedores profissionais
• Entender que código é feito para pessoas, não só para máquinas

1️⃣ Código é lido mais do que escrito

Um dos princípios mais importantes da programação é este:

👉 Seu código será lido muito mais vezes do que será escrito.

Isso inclui:

• Você mesmo, no futuro
• Outros desenvolvedores
• Colegas de equipe

Por isso, clareza sempre vem antes de “esperteza”.

2️⃣ Use nomes claros e significativos

Prefira nomes que expliquem o que o código faz.

 
  // Ruim 
  let x = 10;
  // Bom
  let quantidadeItens = 10;

O mesmo vale para funções:

 
  // Ruim function f() 
  { 
    return true; 
  }

// Bom
function usuarioEstaLogado() 
{
return true;
}

3️⃣ Uma função deve fazer uma coisa só

Funções pequenas e focadas são mais fáceis de entender e testar.

 
  // Evite function processarTudo() 
  { 
    buscarDados(); validarDados(); renderizarTela(); 
  } 

Prefira:

 
    function buscarDados() {} 
    function validarDados() {} 
    function renderizarTela() {} 

4️⃣ Evite código duplicado

Código repetido é difícil de manter.

Se você copia e cola algo mais de uma vez, provavelmente deveria virar uma função.

 
      // Melhor function formatarPreco(valor) 
      { 
        return "R$ " + valor.toFixed(2); 
      } 

5️⃣ Prefira clareza a atalhos “espertos”

Código muito compacto pode ser difícil de entender.

 
        // Funciona, mas confuso 
        const status = x > 10 ? (y ? "ok" : "erro") : null; 

Às vezes, ser explícito é melhor:

 
  let status = null;
  if (x > 10) 
    {
    if (y) 
      {
      status = "ok";
      } else 
      {
      status = "erro";
      }
    }

6️⃣ Trate erros com responsabilidade

Nunca assuma que tudo sempre vai dar certo.

 
  try 
  { 
    const dados = JSON.parse(texto); 
  } catch (erro) 
    { 
      console.log("Erro ao processar dados"); 
    } 

Tratar erros torna sua aplicação mais robusta.

7️⃣ Organize o código em módulos

Como vimos nas aulas anteriores:

• Separe responsabilidades
• Use import e export
• Evite arquivos gigantes

Código organizado é código que evolui.

8️⃣ Comente com propósito

Comentários devem explicar por quê, não o óbvio.

 // Calcula o desconto apenas se o usuário for VIP 
      function calcularDesconto(valor) 
      { 
        return valor * 0.9; 
      } 

9️⃣ Consistência é mais importante que perfeição

Não existe um único jeito perfeito de escrever código.

O mais importante é:

• Manter o mesmo padrão
• Usar a mesma nomenclatura
• Seguir a mesma organização

🔟 Pense no “você do futuro”

Sempre que escrever código, pense:

👉 “Vou entender isso daqui a 6 meses?”

Se a resposta for “talvez não”, vale melhorar.

A partir daqui, você não está apenas aprendendo JavaScript — você está aprendendo a pensar como desenvolvedor.

Nossa próxima aula será sobre criação dinâmica de elementos.