J'utilise Netbeans pour ajouter des commentaires de type professionnel à chaque fonction, j'écris. Je commence donc chacun d'eux par /**
, puis j'appuie sur Enter
pour laisser Netbeans remplir le schéma de commentaires par défaut pour la fonction suivante.
Jusqu'à présent, je n'utilisais cela que pour le langage PHP et dans ce cas, Netbeans ajoutait toujours une @returns {type}
partie dans le schéma de commentaire uniquement, si la fonction PHP suivante incluait vraiment une return
déclaration. Sur les soi-disant «procédures» (fonctions qui ne renvoient aucune valeur), cette partie manquait.
Aujourd'hui, j'ai essayé la même chose pour la fonction Javascript et Netbeans a ajouté une @returns {undefined}
partie au schéma de commentaire même si la fonction suivante ne renvoie rien.
Cela m'a dérouté. Netbeans suggère-t-il ainsi que chaque fonction Javascript doit renvoyer quelque chose? Que devrais-je faire? Ignorer (ou supprimer) cette partie du schéma de commentaire ou suivre la suggestion (si c'est une suggestion) et ajouter return false;
à la fin de cette fonction, bien que cela ne me serve à rien?
undefined
. Dans de nombreuses langues, le résultat de la dernière déclaration est renvoyé (plus utile, IMO). Celles-ci sont appelées retours implicites .