Commentaires JavaScript
Vous savez écrire des instructions et des valeurs avec une syntaxe soignée. Cette leçon ajoute quelque chose que le moteur ignore : les commentaires — des notes pour vous et pour les autres humains qui lisent le code.
Que sont les commentaires JavaScript et comment les écrire ?
Un commentaire est un texte que le moteur JavaScript ignore. Il ne change pas ce que fait le programme. Utilisez // pour une note qui s’arrête à la fin de cette ligne, ou /* … */ pour une note qui peut couvrir une ou plusieurs lignes. Les commentaires expliquent le pourquoi, laissent des rappels, ou désactivent temporairement une ligne pendant les tests.
Formes de commentaire en un coup d’œil
📊 Comment les débutants devraient utiliser les commentaires
| Forme | Exemple | Quand l’utiliser |
|---|---|---|
Une ligne // |
// Afficher un message de bienvenue |
Courte note au-dessus ou en fin de ligne |
Plusieurs lignes /* */ |
/* plusieurs lignes de notes */ |
Explication plus longue, ou plusieurs lignes d’un coup |
| Après le code | console.log(x); // vérif temporaire |
Petit rappel à côté d’une instruction |
| Désactiver une ligne | // console.log(x); |
Arrêter une instruction temporairement sans la supprimer |
| Pas pour le moteur | (tout commentaire) | Les visiteurs n’« exécutent » pas vos commentaires — seuls les humains les lisent |
Commentaires d’une ligne avec //
Tout depuis // jusqu’à la fin de cette ligne est un commentaire. Le code avant // sur la même ligne s’exécute encore.
console.log("Hello"); // salut pour la Console
console.log(42); // un littéral nombre
Vous pouvez aussi mettre // seul sur sa propre ligne, au-dessus de l’instruction qu’il décrit.
// Afficher un court message d’état
console.log("Ready");
Commentaires multi-lignes avec / /
Commencez par /* et terminez par */. Tout ce qui se trouve entre les deux est ignoré — même sur plusieurs lignes.
/*
Démo : saluer le visiteur une fois.
Gardez cela court pour les débutants.
*/
console.log("Welcome");
Désactiver du code temporairement
Commenter une ligne est une habitude courante en débogage : le code reste dans le fichier, mais ne s’exécute pas tant que vous n’avez pas retiré le commentaire.
console.log("This runs");
// console.log("This stays quiet");
console.log("This also runs");
Seule la ligne du milieu est silencieuse. Retirez le // quand vous voulez ce journal à nouveau.
Commentaires à côté des mises à jour de page
Un court commentaire pourquoi aide votre futur vous quand une instruction met à jour la page. Le commentaire lui-même n’apparaît jamais sur la page.
<!DOCTYPE html>
<html>
<head>
<title>Comments — Page note</title>
</head>
<body>
<h1 id="msg">Waiting…</h1>
<script>
// Afficher un statut clair une fois le script exécuté
document.getElementById("msg").textContent = "Comments help humans";
</script>
</body>
</html>
Le texte du titre vient du littéral chaîne. La ligne // est seulement pour les lecteurs du code source.
Essayez vous-même
- Ajoutez une note
//au-dessus d’unconsole.loget une autre en fin de la même ligne ; exécutez et confirmez que les journaux apparaissent encore. - Enveloppez une explication de deux lignes dans
/* */au-dessus d’un log ; changez le texte du commentaire — la sortie doit rester la même. - Commentez une des trois lignes
console.logavec//, exécutez, puis restaurez-la. - Ouvrez la démo HTML ; changez seulement le libellé du commentaire ; actualisez et confirmez que le texte du titre n’a pas changé.
- Écrivez un commentaire qui dit pourquoi (par exemple « vérif temporaire ») au lieu de répéter le code mot pour mot.
Erreurs courantes
- Oublier le
*/fermant après/*— le code suivant peut disparaître dans le commentaire - S’attendre à ce que
//continue sur la ligne suivante (il s’arrête en fin de ligne) - Imbriquer
/* … /* … */ … */sans soin — les commentaires multi-lignes ne s’imbriquent pas en sécurité - Des commentaires qui ne font que reformuler le code au lieu d’un pourquoi utile
- Confondre avec la Syntaxe (littéraux et noms) ou attendre déjà Variables — les commentaires sont des notes, pas du stockage
Résumé
- Les commentaires sont pour les humains ; le moteur les ignore
//couvre le reste d’une ligne/* */peut couvrir une ou plusieurs lignes- Utilisez-les pour le pourquoi, les rappels et la désactivation temporaire — pas pour le bruit
- Ensuite : Variables — des noms qui conservent des valeurs réutilisables
🧠 Testez Vos Connaissances
Testez Vos Connaissances
Mettez-vous au défi avec ce quiz interactif et voyez à quel point vous comprenez le sujet
📝 Instructions
- Lisez chaque question attentivement
- Sélectionnez la meilleure réponse pour chaque question
- Vous pouvez refaire le quiz autant de fois que vous le souhaitez
- Votre progression sera affichée en haut