J'utilise Netbeans pour ajouter des commentaires de type professionnel à chaque fonction que j'écris. Je commence donc chacune d'entre elles par /**
et ensuite j'appuie sur Enter
pour permettre à Netbeans de remplir le schéma de commentaires par défaut pour la fonction suivante.
Jusqu'à présent, je l'ai utilisé uniquement pour le langage PHP et dans ce cas, Netbeans ajoutait toujours @returns {type}
dans le schéma de commentaire uniquement, si la fonction PHP suivante est réellement incluse. return
déclaration. Sur les "procédures" (fonctions qui ne renvoient aucune valeur), cette partie était absente.
Aujourd'hui j'ai essayé la même chose pour la fonction Javascript et Netbeans a ajouté @returns {undefined}
pour commenter le schéma même si la fonction suivante ne renvoie rien.
Cela m'a troublé. Netbeans suggère-t-il ainsi que chaque fonction Javascript doit retourner quelque chose ? Que dois-je faire ? Ignorer (ou supprimer) cette partie du schéma de commentaire ou suivre la suggestion (si c'est bien une suggestion) et ajouter return false;
à la fin d'une telle fonction, bien qu'elle soit inutile pour moi ?