Comentários em JavaScript
Você já sabe escrever instruções e valores com sintaxe cuidadosa. Esta sessão acrescenta algo que o motor ignora: comentários — notas para você e para outras pessoas que leem o código.
O que são comentários em JavaScript e como escrevê-los?
Um comentário é texto que o motor JavaScript ignora. Não muda o que o programa faz. Use // para uma nota que termina no fim dessa linha, ou /* … */ para uma nota que pode ocupar uma ou mais linhas. Comentários explicam o porquê, deixam lembretes ou desativam temporariamente uma linha enquanto você testa.
Formas de comentário em um relance
📊 Como iniciantes devem usar comentários
| Forma | Exemplo | Quando usar |
|---|---|---|
Uma linha // |
// Mostrar uma mensagem de boas-vindas |
Nota curta acima ou no fim da linha |
Várias linhas /* */ |
/* várias linhas de notas */ |
Explicação mais longa, ou várias linhas de uma vez |
| Depois do código | console.log(x); // verificação temporária |
Lembrete pequeno ao lado de uma instrução |
| Desativar uma linha | // console.log(x); |
Parar uma instrução temporariamente sem apagá-la |
| Não para o motor | (qualquer comentário) | Visitantes não «executam» seus comentários — só humanos leem |
Comentários de uma linha com //
Tudo de // até o fim dessa linha é comentário. O código antes de // na mesma linha ainda é executado.
console.log("Hello"); // saudação para o Console
console.log(42); // um literal numérico
Você também pode colocar // sozinho na própria linha, acima da instrução que descreve.
// Registrar uma mensagem de status curta
console.log("Ready");
Comentários de várias linhas com / /
Comece com /* e termine com */. Tudo entre eles é ignorado — mesmo em várias linhas.
/*
Demo: cumprimentar o visitante uma vez.
Mantenha isto curto para iniciantes.
*/
console.log("Welcome");
Desativar código temporariamente
Comentar uma linha é um hábito comum ao depurar: o código permanece no arquivo, mas não é executado até você remover o comentário.
console.log("This runs");
// console.log("This stays quiet");
console.log("This also runs");
Só a linha do meio fica em silêncio. Remova o // quando quiser esse log de novo.
Comentários ao lado de atualizações de página
Um comentário curto de porquê ajuda o você do futuro quando uma instrução atualiza a página. O comentário em si nunca aparece na página.
<!DOCTYPE html>
<html>
<head>
<title>Comments — Page note</title>
</head>
<body>
<h1 id="msg">Waiting…</h1>
<script>
// Mostrar um status claro quando o script for executado
document.getElementById("msg").textContent = "Comments help humans";
</script>
</body>
</html>
O texto do título vem do literal de string. A linha // é só para quem lê o código-fonte.
Experimente você mesmo
- Adicione uma nota
//acima de umconsole.loge outra no fim da mesma linha; execute e confirme que os logs ainda aparecem. - Envolva uma explicação de duas linhas em
/* */acima de um log; mude o texto do comentário — a saída deve permanecer igual. - Comente uma de três linhas
console.logcom//, execute e depois restaure. - Abra a demo HTML; mude só o texto do comentário; atualize e confirme que o texto do título não mudou.
- Escreva um comentário que diga porquê (por exemplo «verificação temporária») em vez de repetir o código palavra por palavra.
Erros comuns
- Esquecer o
*/de fechamento após/*— código seguinte pode sumir no comentário - Esperar que
//continue na próxima linha (para no fim da linha) - Aninhar
/* … /* … */ … */sem cuidado — comentários de várias linhas não aninham com segurança - Comentários que só repetem o código em vez de um porquê útil
- Confundir com Sintaxe (literais e nomes) ou esperar já Variáveis — comentários são notas, não armazenamento
Resumo
- Comentários são para humanos; o motor os ignora
//cobre o resto de uma linha/* */pode cobrir uma ou muitas linhas- Use-os para o porquê, lembretes e desativação temporária — não para ruído
- A seguir: Variáveis — nomes que guardam valores que você pode reutilizar
🧠 Teste Seu Conhecimento
Teste Seu Conhecimento
Desafie-se com este questionário interativo e veja o quão bem você entende o tópico
📝 Instruções
- Leia cada pergunta cuidadosamente
- Selecione a melhor resposta para cada pergunta
- Você pode refazer o quiz quantas vezes quiser
- Seu progresso será mostrado no topo