Lo primero que estudiaremos son los bloques de construcción del código.
Las declaraciones son construcciones de sintaxis y comandos que realizan acciones.
Ya hemos visto una declaración, alert('¡Hola, mundo!'), Que muestra el mensaje "¡Hola mundo!".
Podemos tener tantas declaraciones en nuestro código como queramos. Las declaraciones se pueden separar con un punto y coma.
Por ejemplo, aquí dividimos "Hello World" en dos alertas:
alert('Hola'); alert('Mundo');Generalmente, las declaraciones se escriben en líneas separadas para hacer que el código sea más legible:
alert('Hola');
alert('Mundo');Se puede omitir un punto y coma en la mayoría de los casos cuando existe un salto de línea.
Esto también funcionaría:
alert('Hola')
alert('Mundo')Aquí, JavaScript interpreta el salto de línea como un punto y coma "implícito". Esto se denomina inserción automática de punto y coma.
En la mayoría de los casos, una nueva línea implica un punto y coma. Pero "en la mayoría de los casos" no significa "siempre"!
Hay casos en que una nueva línea no significa un punto y coma. Por ejemplo:
alert(3 +
1
+ 2);El código da como resultado 6 porque JavaScript no inserta punto y coma aquí. Es intuitivamente obvio que si la línea termina con un signo más "+", entonces es una "expresión incompleta", por lo que no se requiere el punto y coma. Y en este caso eso funciona según lo previsto.
Pero hay situaciones en las que JavaScript "falla" al asumir un punto y coma donde realmente se necesita.
Los errores que ocurren en tales casos son bastante difíciles de encontrar y corregir.
Si tiene curiosidad por ver un ejemplo concreto de tal error, consulte este código:
```js run
[1, 2].forEach(alert)
```
No es necesario pensar en el significado de los corchetes `[]` y `forEach` todavía. Los estudiaremos más adelante. Por ahora, solo recuerda el resultado del código: muestra `1` luego `2`.
Ahora, agreguemos un 'alert' antes del código y *no* terminemos con un punto y coma:
```js run no-beautify
alert("Habrá un error")
[1, 2].forEach(alert)
```
¡Ahora si ejecutamos el código, solo se muestra el primer `alert` y luego tenemos un error!
Pero todo está bien de nuevo si agregamos un punto y coma después de `alert`:
```js run
alert("Todo bien ahora");
[1, 2].forEach(alert)
```
Ahora tenemos el mensaje "Todo bien ahora" seguido de `1` y `2`.
El error en la variante sin punto y coma se produce porque JavaScript no asume un punto y coma antes de los corchetes `[...]`.
Entonces, como el punto y coma no se inserta automáticamente, el código del primer ejemplo se trata como una sola declaración. Así es como lo ve el motor:
```js run no-beautify
alert("Habrá un error")[1, 2].forEach(alert)
```
Pero deberían ser dos declaraciones separadas, no una. Tal unión en este caso es simplemente incorrecto, de ahí el error. Esto puede suceder en otras situaciones.
Recomendamos colocar puntos y coma entre las declaraciones, incluso si están separadas por nuevas líneas. Esta regla es ampliamente adoptada por la comunidad. Notemos una vez más que es posible omitir los puntos y comas la mayoría del tiempo. Pero es más seguro, especialmente para un principiante, usarlos.
A medida que pasa el tiempo, los programas se vuelven cada vez más complejos. Se hace necesario agregar comentarios que describan lo que hace el código y por qué.
Los comentarios se pueden poner en cualquier lugar de un script. No afectan su ejecución porque el motor simplemente los ignora.
Los comentarios de una línea comienzan con dos caracteres de barra diagonal //.
El resto de la línea es un comentario. Puede ocupar una línea completa propia o seguir una declaración.
Como aqui:
// Este comentario ocupa una línea propia.
alert('Hello');
alert('World'); // Este comentario sigue a la declaración.Los comentarios de varias líneas comienzan con una barra inclinada y un asterisco /* y terminan con un asterisco y una barra inclinada */.
Como aquí:
/* Un ejemplo con dos mensajes.
Este es un comentario multilínea.
*/
alert('Hola');
alert('Mundo');El contenido de los comentarios se ignora, por lo que si colocamos el código dentro de /* ... */, no se ejecutará.
A veces puede ser útil deshabilitar temporalmente una parte del código:
/* Comentando el código
alert('Hola');
*/
alert('Mundo');En la mayoría de los editores, se puede comentar una línea de código presionando `key:Ctrl+/` para un comentario de una sola línea y algo como `key:Ctrl+Shift+/` - para comentarios de varias líneas (seleccione una parte del código y pulse la tecla de acceso rápido). Para Mac, intente `key: Cmd` en lugar de `key: Ctrl`.
No puede haber `/*...*/` dentro de otro `/*...*/`.
Dicho código terminará con un error:
```js run no-beautify
/*
/* comentario anidado ?!? */
*/
alert( 'Mundo' );
```
Por favor, no dudes en comentar tu código.
Los comentarios aumentan el tamaño general del código, pero eso no es un problema en absoluto. Hay muchas herramientas que minimizan el código antes de publicar en un servidor de producción. Eliminan los comentarios, por lo que no aparecen en los scripts de trabajo. Por lo tanto, los comentarios no tienen ningún efecto negativo en la producción.
Más adelante en el tutorial habrá un capítulo info:coding-style que también explica cómo escribir mejores comentarios.