Nomenclatura, legibilidade e armadilhas comuns
Diretrizes de nomenclatura e legibilidade; evite sombreamento, números mágicos e declarações misturadas.
Nomenclatura, legibilidade e armadilhas comuns é uma aula grátis de JavaScript Academy no CoddyKit. Esta é a aula 3 de 3. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de JavaScript Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de JavaScript Academy inclui 3 aulas no total.
Introdução
Objetivo: Escreva código legível. Use nomes claros, evite números mágicos e tenha cuidado com a ocultação de nomes.
- Nomes descritivos
- Constantes para valores fixos
- Nenhuma ocultação acidental
Demonstração de nomenclatura clara
Dê nomes às variáveis com base em o que elas armazenam, não em como são usadas. Nomes curtos, mas claros, são melhores.
// Use descriptive names
// Avoid single letters or vague words
const itemCount = 3;
const unitPrice = 5;
const totalPrice = itemCount * unitPrice;
console.log("Items:", itemCount);
console.log("Unit price:", unitPrice);
console.log("Total price:", totalPrice);
Diretrizes de nomenclatura
Dicas de nomenclatura:
- Substantivos para dados (userName, totalPrice)
- Verbos para funções (computeTotal)
- Seja consistente com o uso de maiúsculas e minúsculas (camelCase)
Sem números mágicos
Transforme valores fixos em constantes (UPPER_CASE é comum). Isso esclarece a intenção e facilita as atualizações.
// Replace magic numbers with named constants
const TAX_RATE = 0.08;
const SUBTOTAL = 20;
const tax = SUBTOTAL * TAX_RATE;
const finalTotal = SUBTOTAL + tax;
console.log("Tax:", tax);
console.log("Final total:", finalTotal);
Demonstração de ocultação
Ocultação: uma variável interna usa o mesmo nome e esconde a externa. Prefira nomes exclusivos quando os escopos são aninhados.
// Shadowing: inner variable hides an outer one
let score = 10;
function addBonus() {
// The next line creates a new "score" only inside this function
let score = 5;
console.log("Inner score:", score);
}
addBonus();
console.log("Outer score:", score);
Lista de verificação de legibilidade
Lista de verificação:
- Uma ideia por linha
- Funções curtas
- Use constantes para valores fixos
- Evite nomes reutilizados em diferentes escopos
Quiz sobre boas práticas de nomenclatura
Verificação rápida: nomenclatura clara.
Recapitulação
Recapitulação: Use nomes descritivos, transforme valores fixos em constantes e evite a ocultação para manter o código fácil de ler e manter.
Perguntas Frequentes
A aula “Nomenclatura, legibilidade e armadilhas comuns” é grátis?
Sim — o texto completo de “Nomenclatura, legibilidade e armadilhas comuns” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de JavaScript Academy, atualize para CoddyKit PRO. O curso de JavaScript Academy inclui 3 aulas no total.
O que vou aprender em “Nomenclatura, legibilidade e armadilhas comuns”?
Diretrizes de nomenclatura e legibilidade; evite sombreamento, números mágicos e declarações misturadas. Você pratica JavaScript Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar JavaScript Academy?
Nenhuma experiência prévia é necessária. JavaScript Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 3 de 3.
Quanto tempo leva a aula “Nomenclatura, legibilidade e armadilhas comuns”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de JavaScript Academy?
Sim. Cada aula de JavaScript Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- let, const e como evitar var
- Escopo de bloco, função e módulo e a TDZ
- Nomenclatura, legibilidade e armadilhas comuns