You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: 1-js/02-first-steps/02-structure/article.md
+22-22Lines changed: 22 additions & 22 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,21 +2,21 @@
2
2
3
3
Lo primero que estudiaremos son los bloques de construcción del código.
4
4
5
-
## Declaraciones
5
+
## Sentencias
6
6
7
-
Las declaraciones son construcciones de sintaxis y comandos que realizan acciones.
7
+
Las sentencias son construcciones sintácticas y comandos que realizan acciones.
8
8
9
-
Ya hemos visto una sentencia, `alert('¡Hola, mundo!')`, que muestra el mensaje "¡Hola mundo!".
9
+
Ya hemos visto una sentencia, `alert('¡Hola mundo!')`, que muestra el mensaje "¡Hola mundo!".
10
10
11
-
Podemos tener tantas declaraciones en nuestro código como queramos. Las declaraciones se pueden separar con un punto y coma.
11
+
Podemos tener tantas sentencias en nuestro código como queramos, las cuales se pueden separar con un punto y coma.
12
12
13
-
Por ejemplo, aquí dividimos "Hello World" en dos alertas:
13
+
Por ejemplo, aquí separamos "Hello World" en dos alerts:
14
14
15
15
```js run no-beautify
16
16
alert('Hola'); alert('Mundo');
17
17
```
18
18
19
-
Generalmente, las declaraciones se escriben en líneas separadas para hacer que el código sea más legible:
19
+
Generalmente, las sentencias se escriben en líneas separadas para hacer que el código sea más legible:
20
20
21
21
```js run no-beautify
22
22
alert('Hola');
@@ -46,20 +46,20 @@ alert(3 +
46
46
+2);
47
47
```
48
48
49
-
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.
49
+
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 `"+"`, 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.
50
50
51
51
**Pero hay situaciones en las que JavaScript "falla" al asumir un punto y coma donde realmente se necesita.**
52
52
53
53
Los errores que ocurren en tales casos son bastante difíciles de encontrar y corregir.
54
54
55
-
````smart header="Un ejemplo de un error."
56
-
Si tiene curiosidad por ver un ejemplo concreto de tal error, consulte este código:
55
+
````smart header="Un ejemplo de error"
56
+
Si tienes curiosidad por ver un ejemplo concreto de tal error, mira este código:
57
57
58
58
```js run
59
59
[1, 2].forEach(alert)
60
60
```
61
61
62
-
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`.
62
+
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`.
63
63
64
64
Ahora, agreguemos un 'alert' antes del código y *no* terminemos con un punto y coma:
65
65
@@ -69,9 +69,9 @@ alert("Habrá un error")
69
69
[1, 2].forEach(alert)
70
70
```
71
71
72
-
¡Ahora si ejecutamos el código, solo se muestra el primer `alert` y luego tenemos un error!
72
+
Ahora, si ejecutamos el código, ¡solo se muestra el primer `alert` y luego tenemos un error!
73
73
74
-
Pero todo está bien de nuevo si agregamos un punto y coma después de `alert`:
74
+
Pero todo está bien nuevamente si agregamos un punto y coma después de `alert`:
75
75
```js run
76
76
alert("Todo bien ahora");
77
77
@@ -83,16 +83,16 @@ Ahora tenemos el mensaje "Todo bien ahora" seguido de `1` y `2`.
83
83
84
84
El error en la variante sin punto y coma se produce porque JavaScript no asume un punto y coma antes de los corchetes `[...]`.
85
85
86
-
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:
86
+
Entonces, como el punto y coma no se inserta automáticamente, el código del primer ejemplo se trata como una sola sentencia. Así es como lo ve el motor:
87
87
88
88
```js run no-beautify
89
89
alert("Habrá un error")[1, 2].forEach(alert)
90
90
```
91
91
92
-
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.
92
+
Pero deberían ser dos sentencias separadas, no una. Tal unión en este caso es simplemente incorrecta, de ahí el error. Esto puede suceder en otras situaciones también.
93
93
````
94
94
95
-
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.
95
+
Recomendamos colocar puntos y coma entre las sentencias, incluso si están separadas por saltos de línea. Esta regla está ampliamente adoptada por la comunidad. Notemos una vez más que es posible omitir los puntos y coma la mayoría del tiempo. Pero es más seguro, especialmente para un principiante, usarlos.
96
96
97
97
## Comentarios
98
98
@@ -101,16 +101,16 @@ A medida que pasa el tiempo, los programas se vuelven cada vez más complejos. S
101
101
Los comentarios se pueden poner en cualquier lugar de un script. No afectan su ejecución porque el motor simplemente los ignora.
102
102
103
103
104
-
**Los comentarios de una línea comienzan con dos caracteres de barra diagonal //.**
104
+
**Los comentarios de una línea comienzan con dos caracteres de barra diagonal `//`.**
105
105
106
-
El resto de la línea es un comentario. Puede ocupar una línea completa propia o seguir una declaración.
106
+
El resto de la línea es un comentario. Puede ocupar una línea completa propia o seguir una sentencia.
107
107
108
108
Como aqui:
109
109
```js run
110
110
// Este comentario ocupa una línea propia.
111
111
alert('Hello');
112
112
113
-
alert('World'); // Este comentario sigue a la declaración.
113
+
alert('World'); // Este comentario sigue a la sentencia.
114
114
```
115
115
116
116
**Los comentarios de varias líneas comienzan con una barra inclinada y un asterisco <code>/*</code> y terminan con un asterisco y una barra inclinada <code>*/</code>.**
@@ -136,11 +136,11 @@ alert('Hola');
136
136
alert('Mundo');
137
137
```
138
138
139
-
```smart header="¡Use accesos rapidos del teclado!"
140
-
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`.
139
+
```smart header="¡Usa accesos rápidos del teclado!"
140
+
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 (selecciona una parte del código y pulsa la tecla de acceso rápido). Para Mac, intenta `key: Cmd` en lugar de `key: Ctrl`.
141
141
```
142
142
143
-
````warn header="Los comentarios anidados no son compatibles!"
143
+
````warn header="¡Los comentarios anidados no son compatibles!"
144
144
No puede haber `/*...*/` dentro de otro `/*...*/`.
145
145
146
146
Dicho código terminará con un error:
@@ -155,7 +155,7 @@ alert( 'Mundo' );
155
155
156
156
Por favor, no dudes en comentar tu código.
157
157
158
-
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.
158
+
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 publicarlo 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.
159
159
160
160
Más adelante, en el tutorial, habrá un capítulo <info:coding-style> que también explica cómo escribir mejores comentarios.
0 commit comments