Frameworks de Copywriting
Herramientas básicas: la consola y los comentarios
Estas dos herramientas te acompañarán durante todo tu camino como programador. La consola te muestra qué está pasando en tu código, y los comentarios te ayudan a entenderlo más adelante. Dominarlas desde el principio te hará la vida mucho más fácil.
La consola del navegador
La consola es tu mejor aliada mientras aprendes. Te permite ver errores, imprimir valores para entender qué ocurre (a esto se le llama depurar o debugging) y ejecutar código al instante.
Métodos del objeto console
// Imprimir un mensaje informativo
console.log("Hola mundo");
// Imprimir una advertencia (aparece en amarillo)
console.warn("Cuidado: valor inesperado");
// Imprimir un error (aparece en rojo)
console.error("Algo salió mal");
// Mostrar datos en forma de tabla
console.table(["manzana", "banana", "naranja"]);
// Medir cuánto tarda un bloque de código
console.time("calculo");
// ... aquí va tu código ...
console.timeEnd("calculo");
// Limpiar la consola
console.clear();Consejo
Puedes imprimir varios valores a la vez: console.log("Usuario:", nombre, "Edad:", edad). La consola los separa con espacios y respeta su tipo (los objetos se ven expandibles).
Comentarios en JavaScript
Los comentarios son notas que escribes en tu código para ti o para otras personas. JavaScript los ignora por completo al ejecutar.
Tipos de comentarios
// Comentario de una sola línea
/* Comentario
de varias
líneas */
/**
* Comentario de documentación (JSDoc).
* @param {string} nombre - El nombre a saludar.
* @returns {string} El saludo completo.
*/
function saludar(nombre) {
return "Hola " + nombre;
}Buenas prácticas con comentarios
- Explica el porqué, no el qué (el código ya dice qué hace).
- Mantén los comentarios actualizados: un comentario falso es peor que ninguno.
- No comentes lo obvio:
i = i + 1; // suma unosobra.
¿Qué método usarías para mostrar un mensaje de error en rojo en la consola?
Ejercicio práctico
Objetivo: practicar la consola y los comentarios.
- En la consola del navegador, escribe un
console.log, unconsole.warny unconsole.errorcon mensajes distintos. - Usa
console.tablecon una lista de tus 3 comidas favoritas. - En un archivo, escribe una función pequeña y documéntala con un comentario JSDoc que explique qué hace.
Entregable: el código de tu función comentada y una captura de la consola con los tres tipos de mensaje.
Para recordar
console.log,warnyerrorsirven para inspeccionar tu código.console.tablemuestra listas y objetos de forma ordenada.- Los comentarios explican el porqué y deben mantenerse al día.
