L’éditeur JavaScript de Visual Studio est un de mes préférés notamment grâce à l’IntelliSense dont j’avais parlé dans un précédent article. Nous allons voir dans ce post comment améliorer l’intelliSense afin de pouvoir voir les paramètres attendu par une fonction JavaScript, sa description, ….

Visual Studio utilise pour JavaScript les commentaires XML comme en C# à la différence que ceux-ci doivent se trouver au début du corps de la fonction et non au dessus.

var exampleFunction = function (a, b, c) {
    /// <summary>Exemple de description d'un fonction</summary>;
    /// <param name="a" type="String">description d'un paramètre de type string</param>
    /// <param name="b" type="int">description d'un paramètre de type int</param>
    /// <param name="c" type="Object">description d'un paramètre de type Objet</param>
    ... ici le code de la fonction
}

Sans et avec commentaires de fonction :

Par défaut, malheureusement, Visual Studio ne génère pas automatiquement le squelette des commentaires lors de l’insertion de ///. Il existe cependant des extensions qui permettent de le faire :

• Web Essentials 2012, une extension indispensable pour les développeurs web dont j’avais parlé dans un article pour effectuer le débogage de scripts minifiés
• JScript vsdoc Stub Generator pour Visual Studio 2010.

L’IntelliSense peut afficher les commentaires dans les scénarios suivants :

• 1 fichier .js référence un auter fichier .js .
• 1 fichier .js référence 1 fichier .aspx ou cshtml.
• 1 fichier .aspx ou .cshtml qui référence 1 fichier .js.

L’IntelliSense n’est pas disponible quand un fichier .aspx (ou .cshtml) référence un autre fichier.aspx (ou .cshtml).

Il existe une version de JQuery avec les commentaires compatible avec VS dont j’avais parlé dans un précédent article concernant les astuces JQuery.

Il faut savoir qu’il existe une autre norme pour les commentaires API en JavaScript JsDoc et que Web Essentials 2012 permet de gérer.

Références

• L’article sur la création de commentaires de code XML pour JavaScript sur MSDN
• Pour en savoir plus sur le formatage des commentaire JavaScript : The format for JavaScript doc comments (en)

Bon codage !!