SonarJSExo.md

+## JsTestDriver (sans accès root)
+
+- [JsTestDriver](https://code.google.com/p/js-test-driver/) est un autre framework pour les tests JS.
+  - JSTD permet d'intégrer des données liées à la couverture des tests en exécutant les tests JavaScript en ligne de commande et en récupérant les données au moyen d'un plugin dédié coverage
+  - JSTD permet de réaliser les tests sur plusieurs navigateurs
+
+- Télécharger le moteur JsTestDriver [ici](http://www.fil.univ-lille1.fr/~bilasco/TOOLS/JsTestDriver-1.3.5.jar) ou [ailleurs](https://code.google.com/p/js-test-driver/downloads/list)
+
+- Télécharger le plugin coverage [ici](http://www.fil.univ-lille1.fr/~bilasco/TOOLS/coverage-1.3.5.jar) ou [ailleurs](https://code.google.com/p/js-test-driver/downloads/list) (mesurant la couverture des tests) et le placer à la racine de votre projet
+
+- Télécharger les adaptateurs QUnit pour JSTestDriver [ici](http://www.fil.univ-lille1.fr/~bilasco/TOOLS/JSTDQUA.zip) ou [ailleurs](http://code.google.com/p/js-test-driver/source/browse/#svn/trunk/JsTestDriver/contrib/qunit/src)
+  - par défaut uniquement __module__, __test__ et __ok__ sont supportés ; 
+  - dans le fichier QUnitAdaptor.js dans l'archive (ici) un support minimal a été ajouté pour __throws__, __equals__ et l'utilisation des __fixtures__ ; 
+  - les courageux peuvent pousser encore plus l'adaptation ...
+
+- Configurer le lien entre JsTestDriver et le projet en éditant à la racine du projet le fichier jsTestDriver.conf
+```
+server: http://localhost:9876
+
+basepath: "."
+
+plugin:
+ - name: "coverage"
+   jar: "coverage-1.3.5.jar"
+   module: "com.google.jstestdriver.coverage.CoverageModule"
+ 
+load:
+
+  # Add these lines to load qunit, the equiv function and adapter in order, before the tests
+  - JSTDQUA/equiv.js
+  - JSTDQUA/QUnitAdapter.js
+
+  # And this loads the source files we are testing
+  - src/*.js
+ 
+  # This is where we load the qunit tests
+  - test/money_test.js
+  - test/money_ops_test.js
+  - test/calc_test.js
+
+```
+
+- Lancer le serveur sur le port choisi (9876) 
+```
+java -jar PATH_TO/JsTestDriver-1.3.5.jar --port 9876
+```
+  - on peut spécifier --runnerMode DEBUG pour avoir plus de détails
+  - on peut cibler un navigateur en indiquant --browser CHEMIN_VERS_BINAIRE_BROWSER
+  - assurez-vous que le serveur est bien lancé en se connectant à http://localhost:9876 (si vous n'avez pas indiqué --browser, il faut cliquer sur "Capture this browser")
+  - vous pouvez avoir différentes configurations serveur et client / navigateur
+
+- Lancer le client en sauvegardant les informations d'analyse (des fois, il est nécessaire de le lancer deux fois)
+```
+java -jar PATH_TO/JsTestDriver-1.3.5.jar --config jsTestDriver.conf --tests all --testOutput forSonar
+```
+
+- Le plugin coverage sauvegarde des informations sur la couverture en forSonar/jsTestDriver.conf-coverage.dat
+  - les informations peuvent être exploitées et visualisées également en utilisant [genhtml doc](http://ltp.sourceforge.net/coverage/lcov/genhtml.1.php) [genhtml perl code](http://www.fil.univ-lille1.fr/~bilasco/TOOLS/genhtml)
+
+## Integration Sonar & JsTestDriver
+
+- Le lien entre le deux se fait en intégrant les données de couverture dans les Qube
+```
+--------------------------------------------
+-    Contenu sonar-project.properties      -
+--------------------------------------------
+#remplacez X par votre numéro d'utilisateur
+sonar.projectKey=fil:m2eserv
+sonar.projectName=NOMPROJET
+sonar.projectVersion=1.0
+sonar.projectDescription=DESCRIPTION PROJET
+
+# chemin vers les répertoires contenant les sources et les tests
+sonar.sources=src
+sonar.tests=test
+
+# indication du langage utilisé dans le projet
+sonar.language=js
+
+# encodage des sources
+sonar.sourceEncoding=UTF-8
+
+# integration des données de couverture issues de JsTestDriver
+sonar.javascript.lcov.reportPath=forSonar/jsTestDriver.conf-coverage.dat
+```
+
+
+### Exclusions
+
+- Vous pouvez demander d'exclure de l'analyse certains dossiers/fichiers (notamment ceux provenant du code externe - frameworks JS, autres)
+```
+--------------------------------------------
+-    Contenu sonar-project.properties      -
+--------------------------------------------
+...
+# exclure tout un dossier
+sonar.exclusions=CHEMIN_VERS_DOSSIER/**
+...
+```
+
+### Projets multi-modules
+
+- Vous pouvez configurer indépendamment plusieurs modules écrites en langages différents. Ci-dessous à titre d'exemple un projet contenant du code JS et du code PHP
+```
+--------------------------------------------
+-    Contenu sonar-project.properties      -
+--------------------------------------------
+...
+sonar.modules=module1,module2
+module1.sonar.projectBaseDir=ROOT_SOURCE/js
+module2.sonar.projectBaseDir=ROOT_SOURCE/php
+...
+```
+
+### Grunt (nodejs), QUnit et Sonar
+
+ * il existe également la possibilité de réaliser des statistiques de couverture en utilisant [nodejs/grunt/grunt-croc-qunit/grunt-contrib-connect/serve-static/istanbul/phantomjs](CouvertureNodeJS)