Comentarios

¿Qué son los comentarios?

JavaScript tiene varias formas de indicar comentarios en el código

A veces, al escribir código , deberá proporcionarle explicaciones destinadas solo a personas y no a una computadora. Tal vez sea algún tipo de mensaje del pasado (¡para el yo del futuro!) sobre esto o aquello en el código del programa. O tal vez solo sea una indicación de que solo se debe ejecutar tal o cual parte del código, y el resto debe omitirse. En una palabra, en tal caso, deberá recurrir a la ayuda de los comentarios. Los comentarios se utilizan para agregar ➕ pistas, notas , sugerencias o advertencias. Pueden hacer que el código 💡 sea más fácil de leer y comprender. También se pueden usar para evitar que se ejecute el código (esta técnica se practica al depurar código).

En JavaScript, hay varias formas de incluir comentarios en tu código.

Video

Comentario de una sola línea

La primera 1️⃣ manera //comentario en este caso, todo el texto en la línea después de la doble barra inclinada será un comentario . Cuando el intérprete ve dos barras diagonales de 2️⃣ seguidas //, inmediatamente entiende que todo lo que viene más allá del final de la línea se puede ignorar de manera segura. Ignora la sintaxis del código por ahora, lo veremos en detalle un poco más tarde.

Editor en vivo

function learnJavaScript() { // Este es un comentario de línea var hello = 'Hello world!!!' return hello }

function learnJavaScript() {
  // Este es un comentario de línea
  var hello = 'Hello world!!!'

  return hello
}

Resultado

Loading...

Comentario de varias líneas

La segunda forma 2️⃣ es /* */, que es más flexible que la primera 1️⃣. Tan pronto como el intérprete ve /*, piensa: "Sí, así que hasta que vea */, ¡puedo ignorar cualquier cosa aquí!" Por ejemplo, puedes usarlo en una línea 1️⃣ :

Editor en vivo

function learnJavaScript() { /* este es un comentario de una sola linea */ var hello = 'Hello world!!!' return hello }

function learnJavaScript() {
  /* este es un comentario de una sola linea */
  var hello = 'Hello world!!!'

  return hello
}

Resultado

Loading...

O puedes hacer un comentario de varias líneas como se muestra aquí :

Editor en vivo

function learnJavaScript() { /* Este comentario ocupa varias líneas. Tenga en cuenta que no tiene que romper un comentario hasta que lo haya terminado. */ var hello = 'Hello world!!!' /* Escribe tu comentario aqui */ return hello }

function learnJavaScript() {
  /* Este comentario ocupa varias líneas.
     Tenga en cuenta que no tiene que romper un comentario hasta que lo haya terminado. */
  var hello = 'Hello world!!!'
  /* Escribe tu comentario aqui */
  return hello
}

Resultado

Loading...

Comentar en medio del código.

Además, si lo deseas, puedes usar este comentario en medio de una línea de código. Aunque esto puede empeorar la legibilidad del código :

Editor en vivo

function learnJavaScript() { var x = '' var hello = 'Hello ' + x /* вставьте значение x */ + '!' return hello }

function learnJavaScript() {
  var x = ''
  var hello = 'Hello ' + x /* вставьте значение x */ + '!'

  return hello
}

Resultado

Loading...

Sin embargo, hay maneras de reducir la necesidad de comentarios. Podemos usar ciertas técnicas de codificación para refinar nuestro código simplemente aprovechando el lenguaje de programación a nuestro favor.

¡Esto no solo hace que nuestro código sea más fácil de entender, sino que también ayuda a mejorar el diseño general del programa!

Este tipo de código a menudo se denomina autodocumentado.

Esto significa que el código debe estar escrito de tal manera que, en primer lugar, sea conveniente que otros programadores trabajen con él en el futuro, incluido su autor, y en segundo lugar, teniendo en cuenta la posibilidad de expandir este código.

Al comentar el código, todo estaba llamado a cambiar.

React Native

Un ejemplo de dónde más podemos usar comentarios en un proyecto React Native real. De repente necesitaremos esconder algún código. Para hacer esto, necesitamos envolverlo en un comentario. Tenga en cuenta que el bloque con comentarios funcionó, debe estar entre llaves, de lo contrario, la biblioteca React no entenderá que esta es una expresión de JavaScript; esta es una especificidad de la sintaxis JSX, que estudiaremos en el curso más tarde. Intente descomentar el código y luego vuelva a comentarlo.

¿Problemas?

Escribe en Discord o Telegram chat y suscríbete a nuestras noticias

Preguntas:

¿Para quién son los comentarios?

1. persona
2. Consola
3. Intérprete de JavaScript

¿Para qué sirven los comentarios?

1. Agrega pistas, notas, sugerencias
2. Para cumplir con las solicitudes
3. Para evitar la ejecución de código

¿Qué forma de especificar un comentario en código JavaScript no existe?

1. (' ')
2. //
3. /* */

¿Cómo deshabilitar cualquier número de líneas de código?

1. Escribe un comentario en medio del código.
2. Envuelve el código en un comentario
3. Usa el comando console.log

Intérprete de JavaScript ____ cualquier comentario encontrado.

1. Realiza
2. Ignora
3. Compila

¿Cuál es el símbolo para un comentario de una sola línea?

1. //
2. \\
3. ||

¿Qué caracteres se deben ingresar para iniciar un comentario de bloque?

1. /*
2. *\\
3. //

¿Qué término se refiere al código que tiene nombres útiles de variables y nombres de funciones descriptivos para que sea fácil para el desarrollador comprender el propósito del código cuando lo lee (sin mucha necesidad de comentarios explicativos)?

1. Autodocumentación
2. Documentación
3. Manuscrito

Para comprender cuánto ha aprendido esta lección, realice una prueba en la aplicación móvil de nuestra escuela sobre este tema o en nuestro bot de Telegram.

Enlaces:

1. MDN web docs
2. Código para adolescentes: la gran guía de programación para principiantes Volumen 1: Javascript - Jeremy Moritz
3. JavaScript.ru

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Dmitriy Vasilev

Resoner2005 🐛 🎨 🖋