freeCodeCamp/guide/spanish/javascript/comments/index.md

88 lines
2.7 KiB
Markdown
Raw Normal View History

2018-10-12 19:37:13 +00:00
---
title: Comments
localeTitle: Comentarios
---
## Comentarios
2018-10-26 13:15:48 +00:00
Los programadores usan comentarios para agregar consejos, notas, sugerencias o advertencias a su código fuente; no tienen ningún efecto en el funcionamiento del código. Los comentarios pueden ser muy útiles para explicar la intención de lo que su código hace o debería hacer.
2018-10-12 19:37:13 +00:00
2018-10-26 13:15:48 +00:00
Siempre es una buena práctica a la hora de comenzar el comentar con más frecuencia que no hacerlo, ya que puede ayudar a los que lean su código a comprender qué es exactamente lo que su código pretende hacer.
2018-10-12 19:37:13 +00:00
2018-10-26 13:15:48 +00:00
JavaScript tiene dos formas de asignar comentarios a su código.
2018-10-12 19:37:13 +00:00
2018-10-26 13:15:48 +00:00
La primera forma es el comentario `//`; Todo el texto después de `//` en la misma línea es comentado. Por ejemplo:
2018-10-12 19:37:13 +00:00
```javascript
function hello() {
2018-10-26 13:15:48 +00:00
// Este es un comentario JavaScript de una línea
2018-10-12 19:37:13 +00:00
console.log("Hello world!");
}
hello();
```
2018-10-26 13:15:48 +00:00
La segunda forma es el comentario `/* */` , que se puede usar tanto para comentarios de una línea como de múltiples líneas. Por ejemplo:
2018-10-12 19:37:13 +00:00
```javascript
function hello() {
2018-10-26 13:15:48 +00:00
/* Este es un comentario JavaScript de una línea */
2018-10-12 19:37:13 +00:00
console.log("Hello world!");
}
hello();
```
```javascript
function hello() {
2018-10-26 13:15:48 +00:00
/* Este comentario abarca varias líneas. Tenga en cuenta que no necesitamos
finalizar el comentario hasta que hayamos terminado. */
2018-10-12 19:37:13 +00:00
console.log("Hello world!");
}
hello();
```
2018-10-26 13:15:48 +00:00
También puede evitar la ejecución de código Javascript simplemente comentando las líneas de código de esta manera:
2018-10-12 19:37:13 +00:00
```javascript
function hello() {
/*console.log("Hello world!");*/
}
hello();
```
#### Más información:
[Cómo escribir comentarios en JavaScript](https://www.digitalocean.com/community/tutorials/how-to-write-comments-in-javascript)
2018-10-26 13:15:48 +00:00
### Muchos IDEs tienen un atajo de teclado para comentar líneas.
2018-10-12 19:37:13 +00:00
2018-10-26 13:15:48 +00:00
1. Resalte el texto a ser comentado.
2. Mac: Pulse Command (Apple Key) y "/"
3. Windows: Pulse Control y "/"
4. También puede descomentar el código siguiendo los mismos pasos.
2018-10-12 19:37:13 +00:00
Un atajo para comentar una sección de javascript en muchos editores de código es resaltar las líneas de código que desea comentar, luego presione `Cmd/Ctrl + /` .
2018-10-26 13:15:48 +00:00
Los comentarios también son muy útiles para realizar pruebas de código, ya que puede evitar que se ejecute una determinada línea de código / bloque
2018-10-12 19:37:13 +00:00
```javascript
function hello() {
2018-10-26 13:15:48 +00:00
// La siguiente sentencia no va a ser ejecutada
2018-10-12 19:37:13 +00:00
// console.log('hi')
}
hello();
```
```
function hello() {
2018-10-26 13:15:48 +00:00
// Las siguientes sentencias no van a ser ejecutadas
2018-10-12 19:37:13 +00:00
/*
console.log('hi');
console.log('code-test');
*/
}
hello();
```
#### Más información:
2018-10-26 13:15:48 +00:00
* [Cómo escribir comentarios en JavaScript](https://www.digitalocean.com/community/tutorials/how-to-write-comments-in-javascript)