Resumo de Comentários JavaScript -

0.5 - Comentários JavaScript
(http://javascriptbr.blogspot.com)

Comentários no código JavaScript organizam e tornam o código mais intelegível para programadores.

Comentários no JS:

Os comentários são utilizados para explicar o que o código faz para outros programadores, ou para nós mesmos, ao acessá-lo depois de muito tempo e relembrar com mais facilidade. Os comentários de uma única linha começam com // (duas barras). O exemplo à seguir utiliza comentários de linha única para explicar o código:
---------------------------------------- ------------------------------------------------------------------
<script type="text/javascript">
// Escreve um título.
document.write("<h1>Este é O Título</h1>");
// Escreve dois parágrafos:
document.write("<p>Primeiro parágrafo.</p>");
document.write("<p>Segundo parágrafo.</p>");
</script>
---------------------------------------- ------------------------------------------------------------------

Comentários de Várias Linhas:

Comentários de duas ou mais linhas começam com /* (barra e asterístico) e terminam com */ (asterístico e barra). O exemplo à seguir utiliza comentários de mais de uma linha:
---------------------------------------- ------------------------------------------------------------------
<script type="text/javascript">
/*
O código à seguir escreve
um título e dois parágrafos.
*/
document.write("<h1>Este é O Título</h1>");
document.write("<p>Primeiro parágrafo.</p>");
document.write("<p>Segundo parágrafo.</p>");
</script>
---------------------------------------- ------------------------------------------------------------------

Usando Comentários para Impedir Execuções:

No exemplo à seguir o comentário // impede a escrita do título:
---------------------------------------- ------------------------------------------------------------------
<script type="text/javascript">
//document.write("<h1>Este é O Título</h1>");
document.write("<p>Primeiro parágrafo.</p>");
document.write("<p>Segundo parágrafo.</p>");
</script>
---------------------------------------- ------------------------------------------------------------------

Já neste exemplo, o comentário /* impede a execução do código todo:
---------------------------------------- ------------------------------------------------------------------
<script type="text/javascript">
/*
document.write("<h1>Este é O Título</h1>");
document.write("<p>Primeiro parágrafo.</p>");
document.write("<p>Segundo parágrafo.</p>");
*/
</script>
---------------------------------------- ------------------------------------------------------------------

Usando Comentários No Final da Linha:

O exemplo à seguir usa comentários no final da linha.
---------------------------------------- ------------------------------------------------------------------
<script type="text/javascript">
document.write("Hello"); // Escreve "Hello"
document.write(" Dolly!"); // Escreve " Dolly!"
</script>
---------------------------------------- ------------------------------------------------------------------

Resumos Relacionados