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, você pode precisar evitar que uma parte específica do seu código seja executada. Excluir todo o código não é prático se você deseja testar uma seção separada posteriormente. Existem vários cenários nos quais você pode precisar interromper temporariamente a execução de uma parte não funcional do seu código. Nestes casos, os comentários vêm para o seu socorro.

Nota

Comentários fornecem uma sintaxe para ocultar seções 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 a linha inteira de código, garantindo que o código acima e abaixo deles seja executado. A sintaxe para comentários de uma linha é simples: você precisa 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 // impede a execução da segunda linha de código.

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


              
12345

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

Também podemos adicionar o comentário no 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 grande bloco de código, com 299 linhas de comprimento. Comentar cada linha individualmente seria demorado. É aí que os comentários de múltiplas linhas se tornam úteis.

Comentários de múltiplas linhas começam com /* e terminam com */. Qualquer código dentro deles é considerado comentário:


              
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 o código da linha 3 até a 10 não foi executado.

Podemos usar comentários de múltiplas linhas para comentar uma parte do código:


              
1

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

              
1

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

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

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

3. Qual é a sintaxe para criar um comentário de várias linhas?

4. Se você possuir um grande bloco de código e o encapsular entre /* e */, o que acontece com o código dentro?

question mark

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

Select the correct answer

question mark

Como criamos um comentário de uma única linha?

Select the correct answer

question mark

Qual é a sintaxe para criar um comentário de várias linhas?

Select the correct answer

question mark

Se você possuir um grande bloco de código e o encapsular entre /* e */, o que acontece com o código dentro?

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, você pode precisar evitar que uma parte específica do seu código seja executada. Excluir todo o código não é prático se você deseja testar uma seção separada posteriormente. Existem vários cenários nos quais você pode precisar interromper temporariamente a execução de uma parte não funcional do seu código. Nestes casos, os comentários vêm para o seu socorro.

Nota

Comentários fornecem uma sintaxe para ocultar seções 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 a linha inteira de código, garantindo que o código acima e abaixo deles seja executado. A sintaxe para comentários de uma linha é simples: você precisa 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 // impede a execução da segunda linha de código.

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


              
12345

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

Também podemos adicionar o comentário no 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 grande bloco de código, com 299 linhas de comprimento. Comentar cada linha individualmente seria demorado. É aí que os comentários de múltiplas linhas se tornam úteis.

Comentários de múltiplas linhas começam com /* e terminam com */. Qualquer código dentro deles é considerado comentário:


              
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 o código da linha 3 até a 10 não foi executado.

Podemos usar comentários de múltiplas linhas para comentar uma parte do código:


              
1

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

              
1

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

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

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

3. Qual é a sintaxe para criar um comentário de várias linhas?

4. Se você possuir um grande bloco de código e o encapsular entre /* e */, o que acontece com o código dentro?

question mark

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

Select the correct answer

question mark

Como criamos um comentário de uma única linha?

Select the correct answer

question mark

Qual é a sintaxe para criar um comentário de várias linhas?

Select the correct answer

question mark

Se você possuir um grande bloco de código e o encapsular entre /* e */, o que acontece com o código dentro?

Select the correct answer

Tudo estava claro?

Como podemos melhorá-lo?

Obrigado pelo seu feedback!

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