Codificación aprenderaprogramar.com: CU01111E
COMENTARIOS JAVASCRIPT
JavaScript permite insertar comentarios en el código, al igual que la mayoría de los lenguajes de programación. En concreto hay dos tipos de comentarios permitidos, los comentarios en línea que comienzan con una doble barra: //, y los comentarios multilínea, que comienzan con /* y terminan con */.
COMENTARIOS EN JAVASCRIPT
Veamos un ejemplo. Escribe este código y guárdalo en un archivo de extensión html:
<html> <head> <title>Portal web - aprenderaprogramar.com</title> <meta charset="utf-8"> <script type="text/javascript"> /* Funciones JavaScript Versión 0.1 Autor: César Krall Curso: Tutorial básico del programador web: JavaScript desde cero */ //Función que muestra mensaje de bienvenida function mostrarMensaje1() { alert('Bienvenido al curso JavaScript de aprenderaprogramar.com'); } function mostrarMensaje2() { //Mensaje si se hace click sobre párrafo alert('Ha hecho click sobre el párrafo inferior'); } </script> </head> <body> <div> <p>Aquí un párrafo de texto situado antes de la imagen, dentro de un div contenedor</p> <img onclick="mostrarMensaje1()" src="http://i.imgur.com/afC0L.jpg" alt="Notepad++" title="Notepad++, un útil editor de texto"> <p style="background-color:yellow;" onclick="mostrarMensaje2()">Aquí otro párrafo de texto. JavaScript es un lenguaje utilizado para dotar de efectos dinámicos a las páginas web. </p> </div> </body> </html> |
Visualiza el resultado y comprueba que la página web se muestra con normalidad y que JavaScript se ejecuta con normalidad.
Los comentarios son parte del código JavaScript. El navegador los recibe y los detecta pero los ignora al no constituir instrucciones que hayan de ejecutarse. Sin embargo, los comentarios pueden ser visualizados si accedemos al código fuente de la página web (cosa que puede hacer cualquier usuario). Por lo tanto en los comentarios no debe figurar nada que pueda considerarse indebido (como “este código lo he copiado a mi compañero de trabajo sin permiso”, ó “Para acceder a la base de datos usar como datos usuario: cesar y contraseña: aprenderaprogramar.com”).
Los comentarios deben usarse para describir aspectos importantes. Por ejemplo, contenido de un archivo, cometido de una función, versión, licencia, autor, copyright, aspectos que permitan una mejor comprensión del código, avisos importantes, etc.
Obviamente los comentarios JavaScript tienen que encontrarse dentro de código JavaScript, no pueden insertarse en cualquier parte. Por tanto deberán estar dentro de las etiquetas <script> … </script> o bien dentro de un archivo js, no pueden encontrarse en el código HTML.
Los comentarios multilínea no se pueden anidar (es decir, no puede haber un comentario multilínea dentro de otro comentario multilínea). Los comentarios multilínea pueden dar lugar a errores cuando se mezclan con expresiones regulares (hablaremos de expresiones regulares más adelante).
INSERCIÓN AUTOMÁTICA DE PUNTO Y COMA
En general las sentencias JavaScript deben terminar con un punto y coma que delimita el final de una instrucción. No obstante, en caso de que “se olvide” insertar el punto y coma delimitador, el intérprete JavaScript lo insertará automáticamente siempre que le sea posible, facilitando que el código se ejecute.
En el código anterior, elimina los punto y coma al final se las sentencias JavaScript:
function mostrarMensaje1() { alert('Bienvenido al curso JavaScript de aprenderaprogramar.com') } function mostrarMensaje2() { alert('Ha hecho click sobre el párrafo inferior') } |
Visualiza la página web en tu navegador y comprueba que JavaScript sigue funcionando. ¿Por qué? Porque el intérprete del navegador, al encontrar que faltan los ; de cierre, los ha introducido automáticamente para permitir que se ejecute el código. Aunque esto puede parecer una facilidad, recomendamos siempre el cierre de toda instrucción mediante punto y coma. Esto evitará errores o que ocurran cosas indeseadas.
Para acceder a la información general sobre este curso y al listado completo de entregas pulsa en este link: Ver curso completo.
Para hacer un comentario o consulta utiliza los foros aprenderaprogramar.com, abiertos a cualquier persona independientemente de su nivel de conocimiento.