Nombres, legibilidad y errores comunes
Aprenda pautas para elegir nombres y mejorar la legibilidad; evite el shadowing, los números mágicos y las declaraciones mezcladas.
Nombres, legibilidad y errores comunes es una lección gratuita de JavaScript Academy en CoddyKit. Esta es la lección 3 de 3. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de JavaScript Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de JavaScript Academy incluye 3 lecciones en total.
Introducción
Objetivo: Escriba código legible. Utilice nombres claros, evite los números mágicos y tenga cuidado con el sombreado.
- Nombres descriptivos
- Constantes para valores fijos
- Sin sombreado accidental
Demostración de nombres claros
Asigne nombres a las variables según lo que contienen, no según cómo se utilizan. Lo breve pero claro es preferible.
// 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);
Directrices para los nombres
Consejos para los nombres:
- Sustantivos para los datos (userName, totalPrice)
- Verbos para las funciones (computeTotal)
- Sea coherente con las mayúsculas y minúsculas (camelCase)
Sin números mágicos
Convierta los valores fijos en constantes (UPPER_CASE es habitual). Esto explica la intención y facilita las actualizaciones.
// 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);
Demostración del sombreado
Sombreado: Una variable interna utiliza el mismo nombre y oculta la externa. Prefiera nombres únicos cuando los ámbitos estén anidados.
// 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 comprobación de legibilidad
Lista de comprobación:
- Una idea por línea
- Funciones cortas
- Utilice constantes para los valores fijos
- Evite reutilizar nombres entre ámbitos
Cuestionario sobre buenas prácticas de nombres
Comprobación rápida: nombres claros.
Repaso
Repaso: Utilice nombres descriptivos, convierta los valores fijos en constantes y evite el sombreado para que el código sea fácil de leer y mantener.
Preguntas frecuentes
¿La lección «Nombres, legibilidad y errores comunes» es gratis?
Sí — el texto completo de «Nombres, legibilidad y errores comunes» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de JavaScript Academy, actualiza a CoddyKit PRO. El curso de JavaScript Academy incluye 3 lecciones en total.
¿Qué aprenderé en «Nombres, legibilidad y errores comunes»?
Aprenda pautas para elegir nombres y mejorar la legibilidad; evite el shadowing, los números mágicos y las declaraciones mezcladas. Practicas JavaScript Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.
¿Necesito experiencia previa para empezar JavaScript Academy?
No se requiere experiencia previa. JavaScript Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 3 de 3.
¿Cuánto tiempo toma la lección «Nombres, legibilidad y errores comunes»?
La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.
¿Puedo escribir y ejecutar código en esta lección de JavaScript Academy?
Sí. Cada lección de JavaScript Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.
Todas las lecciones de este curso
- let, const y cómo evitar var
- Ámbitos de bloque, función y módulo, y la TDZ
- Nombres, legibilidad y errores comunes