Notice: This page requires JavaScript to function properly.
Please enable JavaScript in your browser settings or update your browser.
Aprenda Usando Comentários para Documentar o Código | Fundamentos do JavaScript
Introdução ao JavaScript

bookUsando Comentários para Documentar o Código

Às vezes, pode ser necessário impedir que uma parte específica do seu código seja executada. Excluir todo o código não é conveniente caso queira testar essa seção separadamente depois. Existem vários cenários em que pode ser preciso interromper temporariamente a execução de uma parte do código que não está funcionando. Nesses casos, os comentários são úteis.

Nota

Comentários fornecem uma sintaxe para ocultar trechos do seu código do interpretador ou compilador. Eles também são valiosos para documentar o código para outros desenvolvedores.

Comentários de uma linha

Comentários de uma linha bloqueiam toda a linha de código, garantindo que o código acima e abaixo deles seja executado. A sintaxe para comentários de uma linha é simples: basta adicionar // antes do código na linha que deseja comentar:

123
console.log("Line 1"); // console.log("Line 2"); console.log("Line 3");
copy

O exemplo acima mostra que o comentário // bloqueia a segunda linha de código, que não é executada.

Também podemos usar comentários de linha única para bloquear várias linhas de código consecutivas:

12345
console.log("Line 1"); console.log("Line 2"); // console.log("Line 3"); // console.log("Line 4"); console.log("Line 5");
copy

Além disso, podemos adicionar o comentário ao final da linha.

123
console.log("Part 1.1"); console.log("Part 1.2"); console.log("Part 2.1"); // console.log("Part 2.2") console.log("Part 3.1"); console.log("Part 3.2");
copy

Comentários de múltiplas linhas

Considere uma situação com um bloco de código grande, com 299 linhas. Comentar cada linha individualmente seria demorado. É nesse contexto que os comentários de múltiplas linhas são úteis.

Comentários de múltiplas linhas começam com /* e terminam com */. Qualquer código incluído entre eles será comentado:

1234567891011
console.log("Line 1"); console.log("Line 2"); /* console.log("Line 4"); console.log("Line 5"); console.log("Line 6"); console.log("Line 7"); console.log("Line 8"); console.log("Line 9"); */ console.log("Line 11");
copy

No exemplo acima, podemos ver que as linhas de código de 3 a 10 não foram executadas.

Podemos usar comentários de múltiplas linhas para comentar parte de uma linha:

1
console.log("Part 1", /* "Part 2", */ "Part 3");
copy
1
/* console.log("Part 1"); */ console.log("Part 2");
copy

1. Por que os comentários são utilizados no código?

2. Como criamos um comentário de uma linha?

3. Qual é a sintaxe para criar um comentário de múltiplas linhas?

4. Se você possui um bloco grande de código e o envolve com /* e */, o que acontece com o código incluído?

question mark

Por que os comentários são utilizados no código?

Select the correct answer

question mark

Como criamos um comentário de uma linha?

Select the correct answer

question mark

Qual é a sintaxe para criar um comentário de múltiplas linhas?

Select the correct answer

question mark

Se você possui um bloco grande de código e o envolve com /* e */, o que acontece com o código incluído?

Select the correct answer

Tudo estava claro?

Como podemos melhorá-lo?

Obrigado pelo seu feedback!

Seção 1. Capítulo 4

Pergunte à IA

expand

Pergunte à IA

ChatGPT

Pergunte o que quiser ou experimente uma das perguntas sugeridas para iniciar nosso bate-papo

Awesome!

Completion rate improved to 2.33

bookUsando Comentários para Documentar o Código

Deslize para mostrar o menu

Às vezes, pode ser necessário impedir que uma parte específica do seu código seja executada. Excluir todo o código não é conveniente caso queira testar essa seção separadamente depois. Existem vários cenários em que pode ser preciso interromper temporariamente a execução de uma parte do código que não está funcionando. Nesses casos, os comentários são úteis.

Nota

Comentários fornecem uma sintaxe para ocultar trechos do seu código do interpretador ou compilador. Eles também são valiosos para documentar o código para outros desenvolvedores.

Comentários de uma linha

Comentários de uma linha bloqueiam toda a linha de código, garantindo que o código acima e abaixo deles seja executado. A sintaxe para comentários de uma linha é simples: basta adicionar // antes do código na linha que deseja comentar:

123
console.log("Line 1"); // console.log("Line 2"); console.log("Line 3");
copy

O exemplo acima mostra que o comentário // bloqueia a segunda linha de código, que não é executada.

Também podemos usar comentários de linha única para bloquear várias linhas de código consecutivas:

12345
console.log("Line 1"); console.log("Line 2"); // console.log("Line 3"); // console.log("Line 4"); console.log("Line 5");
copy

Além disso, podemos adicionar o comentário ao final da linha.

123
console.log("Part 1.1"); console.log("Part 1.2"); console.log("Part 2.1"); // console.log("Part 2.2") console.log("Part 3.1"); console.log("Part 3.2");
copy

Comentários de múltiplas linhas

Considere uma situação com um bloco de código grande, com 299 linhas. Comentar cada linha individualmente seria demorado. É nesse contexto que os comentários de múltiplas linhas são úteis.

Comentários de múltiplas linhas começam com /* e terminam com */. Qualquer código incluído entre eles será comentado:

1234567891011
console.log("Line 1"); console.log("Line 2"); /* console.log("Line 4"); console.log("Line 5"); console.log("Line 6"); console.log("Line 7"); console.log("Line 8"); console.log("Line 9"); */ console.log("Line 11");
copy

No exemplo acima, podemos ver que as linhas de código de 3 a 10 não foram executadas.

Podemos usar comentários de múltiplas linhas para comentar parte de uma linha:

1
console.log("Part 1", /* "Part 2", */ "Part 3");
copy
1
/* console.log("Part 1"); */ console.log("Part 2");
copy

1. Por que os comentários são utilizados no código?

2. Como criamos um comentário de uma linha?

3. Qual é a sintaxe para criar um comentário de múltiplas linhas?

4. Se você possui um bloco grande de código e o envolve com /* e */, o que acontece com o código incluído?

question mark

Por que os comentários são utilizados no código?

Select the correct answer

question mark

Como criamos um comentário de uma linha?

Select the correct answer

question mark

Qual é a sintaxe para criar um comentário de múltiplas linhas?

Select the correct answer

question mark

Se você possui um bloco grande de código e o envolve com /* e */, o que acontece com o código incluído?

Select the correct answer

Tudo estava claro?

Como podemos melhorá-lo?

Obrigado pelo seu feedback!

Seção 1. Capítulo 4
some-alt