Comentários em JavaScript

• Pode 18, 2024

Comentários são apenas isso, comentários que você coloca em seu JavaScript ou HTML para explicar o que está acontecendo. Existem várias maneiras de colocar comentários no seu código JavaScript. Sintaxe de comentário - como dizer ao script ou documento que algo é um comentário e não dados ou código - é muito simples. Escrever bons comentários é mais difícil e, olhando o código (inclusive o meu), a parte mais difícil parece estar realmente fazendo isso!

O JavaScript possui 2 tipos de comentários, um comentário de linha única e um comentário de várias linhas.

O comentário de linha única no JavaScript começa com duas barras (//) e termina no final da linha (tecnicamente, imediatamente antes do caractere terminador da linha). Comentários de linha única são particularmente úteis para notas curtas.

// Este é um comentário de linha única
data = "meus dados" // Este também é um comentário de linha única

Um comentário de várias linhas em JavaScript começa com uma barra seguida por um asterisco (/*) e termina com um asterisco seguido de uma barra (*/) Tudo entre o /* e */ é considerado um comentário. Esse tipo de comentário pode abranger várias linhas. Também é possível colocar esse tipo de comentário no meio de uma linha de código, se não abranger várias linhas, mas isso raramente é útil.

/ * esta é a linha um de um comentário de várias linhas
isso ainda faz parte do meu comentário
esta é a última parte do meu comentário * /

/ * este é um comentário no estilo de várias linhas em uma única linha * /

Você costuma ver asteriscos extras adicionados aos comentários de várias linhas para criar caixas de informações decorativas, como:

/*********************
* Minhas funções *
*********************/

As funções de várias linhas são particularmente úteis no início de um programa ou seção de um programa para descrever o que o programa se destina a fazer e como ele o faz.

Os comentários são usados ​​para dois propósitos. Ao escrever o código (ou mesmo antes de escrevê-lo!), Você deve escrever comentários que permitirão que outra pessoa entenda o que o programa está fazendo (ou deveria estar fazendo). Mesmo que você não espere que mais alguém leia seu código, você ficará surpreso com o quanto você pode esquecer se quiser fazer alterações depois de algumas semanas ou meses.

Além disso, particularmente em linguagens de script como JavaScript, os comentários são frequentemente usados ​​como parte do processo de depuração. Você pode inserir um código para depuração e comentá-los quando terminar de usá-los ou comentar seções de código que você acha que estão causando problemas ou que estão sendo alteradas para adicionar novas funcionalidades. Ao fazer isso, tome cuidado especial para não colocar um comentário de linha única na linha antes do início de um comentário de várias linhas. Isso descomenta o restante do comentário de várias linhas, o que quase certamente causará um erro.

Instruções De Vídeo: Comentarios en JavaScript (Pode 2024).