Comentarios en JavaScript
Ya sabes escribir instrucciones y valores con sintaxis cuidadosa. Esta sesión añade algo que el motor omite: comentarios — notas para ti y para otras personas que lean el código.
¿Qué son los comentarios en JavaScript y cómo se escriben?
Un comentario es texto que el motor de JavaScript ignora. No cambia lo que hace el programa. Usa // para una nota que termina al final de esa línea, o /* … */ para una nota que puede ocupar una o varias líneas. Los comentarios explican el porqué, dejan recordatorios o desactivan temporalmente una línea mientras pruebas.
Formas de comentario de un vistazo
📊 Cómo deberían usar los comentarios los principiantes
| Forma | Ejemplo | Cuándo usarla |
|---|---|---|
Una línea // |
// Mostrar un saludo |
Nota corta encima o al final de la línea |
Varias líneas /* */ |
/* varias líneas de notas */ |
Explicación más larga, o varias líneas a la vez |
| Después del código | console.log(x); // chequeo temporal |
Recordatorio pequeño junto a una instrucción |
| Desactivar una línea | // console.log(x); |
Parar una instrucción temporalmente sin borrarla |
| No para el motor | (cualquier comentario) | Los visitantes no «ejecutan» tus comentarios — solo los leen humanos |
Comentarios de una línea con //
Todo desde // hasta el final de esa línea es un comentario. El código antes de // en la misma línea sigue ejecutándose.
console.log("Hello"); // saludo para la Consola
console.log(42); // un literal numérico
También puedes poner // solo en su propia línea, encima de la instrucción que describe.
// Registrar un mensaje de estado corto
console.log("Ready");
Comentarios de varias líneas con / /
Empieza con /* y termina con */. Todo lo que hay entre ellos se ignora — incluso en varias líneas.
/*
Demo: saludar al visitante una vez.
Mantén esto corto para principiantes.
*/
console.log("Welcome");
Desactivar código temporalmente
Comentar una línea es un hábito habitual al depurar: el código permanece en el archivo, pero no se ejecuta hasta que quites el comentario.
console.log("This runs");
// console.log("This stays quiet");
console.log("This also runs");
Solo la línea del medio está en silencio. Quita el // cuando quieras ese registro otra vez.
Comentarios junto a actualizaciones de página
Un comentario corto de porqué ayuda a tu yo futuro cuando una instrucción actualiza la página. El comentario en sí nunca aparece en la página.
<!DOCTYPE html>
<html>
<head>
<title>Comments — Page note</title>
</head>
<body>
<h1 id="msg">Waiting…</h1>
<script>
// Mostrar un estado claro cuando se ejecute el script
document.getElementById("msg").textContent = "Comments help humans";
</script>
</body>
</html>
El texto del encabezado viene del literal de cadena. La línea // es solo para quien lee el código fuente.
Pruébalo tú mismo
- Añade una nota
//encima de unconsole.logy otra al final de la misma línea; ejecuta y confirma que los registros siguen apareciendo. - Envuelve una explicación de dos líneas en
/* */encima de un log; cambia el texto del comentario — la salida debe seguir igual. - Comenta una de tres líneas
console.logcon//, ejecuta y luego restáurala. - Abre la demo HTML; cambia solo el texto del comentario; actualiza y confirma que el texto del encabezado no cambió.
- Escribe un comentario que diga porqué (por ejemplo «chequeo temporal») en lugar de repetir el código palabra por palabra.
Errores comunes
- Olvidar el
*/de cierre tras/*— el código posterior puede quedar dentro del comentario - Esperar que
//continúe en la línea siguiente (termina al final de la línea) - Anidar
/* … /* … */ … */sin cuidado — los comentarios de varias líneas no anidan de forma segura - Comentarios que solo repiten el código en lugar de un porqué útil
- Confundir esta sesión con Sintaxis (literales y nombres) o esperar ya Variables — los comentarios son notas, no almacenamiento
Resumen
- Los comentarios son para humanos; el motor los ignora
//cubre el resto de una línea/* */puede cubrir una o muchas líneas- Úsalos para el porqué, recordatorios y desactivar temporalmente — no para ruido
- A continuación: Variables — nombres que guardan valores que puedes reutilizar
🧠 Pon a Prueba tu Conocimiento
Pon a Prueba tu Conocimiento
Ponte a prueba con este cuestionario interactivo y descubre qué tan bien entiendes el tema
📝 Instrucciones
- Lee cada pregunta cuidadosamente
- Selecciona la mejor respuesta para cada pregunta
- Puedes repetir el quiz tantas veces como quieras
- Tu progreso se mostrará en la parte superior