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

title	localeTitle
Comments	Comentários

Comentários

Os programadores usam comentários para adicionar dicas, anotações, sugestões ou avisos ao seu código-fonte; eles não têm efeito na saída real do código. Os comentários podem ser muito úteis para explicar a intenção do que seu código está ou deveria estar fazendo.

É sempre uma boa prática começar comentando com mais frequência do que não, já que isso pode ajudar aqueles que lêem seu código a entender exatamente o que seu código pretende fazer.

JavaScript tem duas maneiras de atribuir comentários em seu código.

A primeira maneira é o // comentário; todo o texto seguindo // na mesma linha em um comentário. Por exemplo:

function hello() { 
  // This is a one line JavaScript comment 
  console.log("Hello world!"); 
 } 
 hello(); 

A segunda maneira é o /* */ comment, que pode ser usado para comentários de linha única e multilinha. Por exemplo:

function hello() { 
  /* This is a one line JavaScript comment */ 
  console.log("Hello world!"); 
 } 
 hello(); 

function hello() { 
  /* This comment spans multiple lines. Notice 
     that we don't need to end the comment until we're done. */ 
  console.log("Hello world!"); 
 } 
 hello(); 

Você também pode impedir a execução de código Javascript apenas commeting as linhas de código como este:

function hello() { 
  /*console.log("Hello world!");*/ 
 } 
 hello(); 

Mais Informações:

Como escrever comentários em JavaScript

Muitos IDEs vêm com um atalho de teclado para comentar linhas.

1. Realce o texto a ser comentado
2. Mac: Comando push (tecla Apple) e "/"
3. Windows: controle de envio e "/"
4. Você também pode descomentar o código, executando as mesmas etapas

Um atalho para comentar uma seção de javascript em muitos editores de código é destacar as linhas de código que você deseja comentar, então pressione Cmd/Ctrl + / .

Os comentários também são muito úteis para o teste de código, pois você pode impedir que uma determinada linha de código / bloco seja executada.

function hello() { 
  // The statement below is not going to get executed 
  // console.log('hi') 
  } 
 hello(); 

function hello() { 
  // The statements below are not going to get executed 
  /* 
  console.log('hi'); 
  console.log('code-test'); 
  */ 
 } 
 hello(); 

Mais Informações:

• Como escrever comentários em JavaScript