Cours 3.4. Les commentaires en JavaScript

Il est possible d'écrire des commentaires dans un code JavaScript. Les commentaires ont plusieurs utilités :

ils permettent d'expliquer le code ;
de séparer les différentes parties d'un script ;
et ils empèchent l'exécution des lignes qui sont commentées.

Commentaire sur une seule ligne

Les commentaires sur une seule ligne commencent avec la syntaxe //. Le texte entre // et la fin de la ligne est ignoré lors de l'exécution. Voici un exemple de commentaire :

// Affiche Hello World <= Cette ligne est un commentaire sur une seule ligne
console.log ('Hello World');

Les commentaires ne commencent pas forcément au début de la ligne :

const pi = 3.1415;   // Cette constante définie la valeur de π

Commentaire sur plusieurs lignes

Les commentaires sur plusieurs ligne commencent par /* et se termine par */. Le texte entre /* et */ est ignoré lors de l'exécution. Voici un exemple de commentaire sur plusieurs lignes :

/* 
Le code ci-dessous permet de changer le premier titre <h1>

document                    => Il s'agit du document courant (la page HTML)
.getElementsByTagName("h1") => permet de récupérer tous les éléments <h1> de la page
[0]                         => permet d'isoler le premier élément
.innerHTML                  => est le texte (ou le HTML) contenu dans la balise <h1>
*/
document.getElementsByTagName("h1")[0].innerHTML= "J'ai remplacé le titre !"

Exercice

Le code HTML suivant ouvre une pop-up lors du chargement de la page. Sans la supprimer, commenter la pop-up afin d'empécher son exécution. Le reste du code doit toujours s'exécuter.

<html>
  <head>
  </head>
  <body>
    <h1>Commentaires en JavaScript</h1>
    <script>
      alert('Moi je connais une pop-up qui énerve les gens.');
      console.log ("Dans la console, c'est plus discret");
    </script>
  </body>
</html>

Faire l'exercice en ligne

Solution

Quiz

À quoi peuvent servir les commentaires ?

Empêcher l'exécution d'une ligne.

Empêcher l'exécution de plusieurs lignes.

Afficher un message dans la console.

Expliquer le code et faciliter sa lecture.

Vérifier

Quelle syntaxe permet d'écrire un commentaire sur une seule ligne ?

# Mon commentaire

\\ Mon commentaire

// Mon commentaire

/* Mon commentaire */

Vérifier Bravo ! On peut aussi écrire un commentaire sur une seule ligne avec /* */. Qui peut le plus, peut le moins !

Quelles propositions sont vraies ?

Un commentaire sur plusieurs lignes commence par */

Un commentaire sur plusieurs lignes commence par /*

Un commentaire sur plusieurs lignes se termine par /*

Un commentaire sur plusieurs lignes se termine par */

Vérifier Bravo ! La bonne syntaxe est /* */.

Cours 3.3 Sommaire Cours 3.5

Voir aussi

Dernière mise à jour : 03/10/2022