A place to cache linked articles (think custom and personal wayback machine)
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

index.md 9.0KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168
  1. title: 5 astuces sur les directives AngularJS et leurs tests
  2. url: http://blog.ninja-squad.com/2015/01/27/5-astuces-sur-les-directives-et-leurs-tests/
  3. hash_url: af41d1bdcf6daa279f459c192a088ac2
  4. <p>S’il y a bien un sujet compliqué en Angular, c’est l’écriture de directives. J’espère que les chapitres de <a href="https://books.ninja-squad.com">notre livre</a> aident à passer un cap sur ce problème, mais il manque sur les internets un article un peu complet sur la façon de tester celles-ci.</p>
  5. <p>Angular est très bien pensé pour les tests, avec un système de mock, d’injection de dépendance, de simulation des requêtes HTTP, bref la totale. Mais les tests de directive restent souvent le parent pauvre de tout ça.</p>
  6. <p>Une directive un peu complète va contenir un template, un scope à elle avec différentes valeurs initialisées, et un ensemble de méthodes de comportement. Essayons de prendre une exemple pratique et pas trop compliqué :</p>
  7. <pre><code>angular.module('myProject.directives').directive('gravatar', function() {
  8. return {
  9. restrict: 'E',
  10. replace: true,
  11. scope: {
  12. user: '=',
  13. size: '@'
  14. },
  15. template: '&lt;img class="gravatar" ng-src="http://www.gravatar.com/avatar/{{ user.gravatar }}?s={{ sizePx }}&amp;d=identicon"/&gt;',
  16. link: function(scope) {
  17. if (scope.size === 'lg') {
  18. scope.sizePx = '40';
  19. } else {
  20. scope.sizePx = '20';
  21. }
  22. }
  23. };
  24. });
  25. </code></pre>
  26. <p>Cette directive permet d’afficher le gravatar d’un utilisateur (passé en paramètre <code>user</code>), avec 2 tailles possibles : 20px par défaut et 40px si le paramètre <code>size</code> est précisé avec la valeur <code>lg</code>. Cette logique de composant est assez agréable à manipuler, puisque pour l’utiliser, il suffit de mettre dans un template :</p>
  27. <pre><code>&lt;gravatar user="user" size="lg"&gt;&lt;/gravatar&gt;
  28. </code></pre>
  29. <p>Tester une directive ressemble à un test classique, avec quelques instructions en plus qui ressemblent à des incantations de magie noire quand on débute, et que l’on copie/colle religieusement en espérant que personne ne nous pose de questions sur leur signification.</p>
  30. <pre><code>beforeEach(inject(function($rootScope, $compile) {
  31. scope = $rootScope;
  32. scope.user = {
  33. gravatar: '12345',
  34. name: 'Cédric'
  35. };
  36. gravatar = $compile('&lt;gravatar user="user" size="lg"&gt;&lt;/gravatar&gt;')(scope);
  37. scope.$digest();
  38. }));
  39. </code></pre>
  40. <h1 id="cest-quoi-ce-bordelnbsp">1. C’est quoi ce bordel ?!</h1>
  41. <p>On commence par créer une chaîne de caractères avec le HTML que l’on veut interpréter. Celui-ci doit, bien sûr, contenir la directive que vous voulez tester :</p>
  42. <pre><code>'&lt;gravatar user="user" size="lg"&gt;&lt;/gravatar&gt;'
  43. </code></pre>
  44. <p>Ensuite l’élément est compilé : c’est peut-être la première fois que vous voyez le service <code>$compile</code>. Celui-ci est un service fourni par Angular, utilisé par le framework lui-même, mais rarement dans notre code. A l’exception des tests donc.
  45. Pour le compiler, on lui passe un scope, qui correspond aux variables auxquelles la directive aura accès. La nôtre a, par exemple, besoin d’un utilisateur : on crée donc un scope avec une variable <code>user</code> qui contient l’id gravatar qui va bien.</p>
  46. <p>Le <code>$digest()</code> à la fin permet de déclencher les watchers, c’est à dire résoudre toutes les expressions contenues dans notre directive : <code>user.gravatar</code> et <code>sizePx</code>.</p>
  47. <p>Une fois compilée, on récupère un élément Angular, comme lorsque l’on utilise la méthode <a href="https://docs.angularjs.org/api/ng/function/angular.element">angular.element</a> qui wrappe un élément de DOM ou du HTML sous forme de chaîne de caractères pour en faire un élément jQuery.</p>
  48. <p>Et voilà, le setup est fait. Maintenant, nous allons pouvoir passer au test proprement dit.</p>
  49. <p>Ce que vous ne savez probablement pas, c’est qu’un élément Angular offre de petits bonus. Ainsi, nous pouvons accéder au scope de la directive, qu’il soit isolé ou non. Dans notre cas, la directive <code>gravatar</code> utilise un scope isolé, donc notre test ressemblerait à quelque chose comme ça :</p>
  50. <pre><code>it('should have the correct size on scope', function() {
  51. expect(gravatar.isolateScope().sizePx).toBe('40');
  52. });
  53. </code></pre>
  54. <p>Si le scope n’était pas isolé, on utiliserait <code>scope()</code> :</p>
  55. <pre><code>it('should have the correct size on scope', function() {
  56. expect(gravatar.scope().sizePx).toBe('40');
  57. });
  58. </code></pre>
  59. <p>On peut aussi s’assurer que le HTML produit par la directive est conforme à ce que l’on attend. Vous pouvez utiliser la méthode <code>html()</code> qui renvoie le HTML de l’élément sous forme de chaîne de caractères, mais cela donne des tests un peu pénibles à maintenir. On peut faire quelque chose d’un peu plus sympa, pour tester la validité de l’élément, des classes ou attributs avec :</p>
  60. <pre><code>it('should create a gravatar image with large size', function() {
  61. expect(gravatar[0].tagName).toBe('IMG');
  62. expect(gravatar.hasClass('gravatar')).toBe(true);
  63. expect(gravatar.attr('src')).toBe('http://www.gravatar.com/avatar/12345?s=40&amp;d=identicon');
  64. });
  65. </code></pre>
  66. <p>Il est pas beau ce test ? Mais on peut encore mieux faire…</p>
  67. <h1 id="la-logique-dans-un-controller">2. La logique dans un controller</h1>
  68. <p>La logique d’une directive peut être un pénible à tester. Le plus simple est de l’externaliser dans un controller dédié, que l’on peut tester comme un controller classique :</p>
  69. <pre><code>angular.module('myProject.directives').directive('gravatar', function() {
  70. return {
  71. restrict: 'E',
  72. replace: true,
  73. scope: {
  74. user: '=',
  75. size: '@'
  76. },
  77. template: '&lt;img class="gravatar" ng-src="http://www.gravatar.com/avatar/{{ user.gravatar }}?s={{ sizePx }}&amp;d=identicon"/&gt;',
  78. controller: 'GravatarDirectiveController'
  79. };
  80. });
  81. </code></pre>
  82. <p>C’est d’autant plus utile si votre controller grossit et devient plus complexe.</p>
  83. <h1 id="externaliser-le-template">3. Externaliser le template</h1>
  84. <p>De la même façon, si le template grossit trop, n’hésitez pas à l’extraire dans un fichier à part.</p>
  85. <pre><code>angular.module('myProject.directives').directive('gravatar', function() {
  86. return {
  87. restrict: 'E',
  88. replace: true,
  89. scope: {
  90. user: '=',
  91. size: '@'
  92. },
  93. templateUrl: 'gravatar.html',
  94. controller: 'GravatarDirectiveController'
  95. };
  96. });
  97. </code></pre>
  98. <p>Cela introduit cependant une petite subtilité pour les tests. Si vous relancez celui que vous aviez avant d’externaliser le template, vous allez avoir l’erreur suivante :</p>
  99. <pre><code>Error: Unexpected request: GET gravatar.html
  100. No more request expected
  101. </code></pre>
  102. <p>Et oui, si on externalise le template, AngularJS va faire une requête pour le récupérer auprès du serveur. D’où une requête GET inattendue…
  103. Mais on peut charger le template dans le test pour éviter ce problème. Il suffit pour cela d’utiliser <a href="https://github.com/karma-runner/karma-ng-html2js-preprocessor">karma-ng-html2js</a> (ou le module grunt/gulp équivalent). Le principe est de charger les templates dans un module à part et d’inclure ce module dans notre test.</p>
  104. <p>Il suffit alors de charger le template dans le test :</p>
  105. <pre><code>beforeEach(module('gravatar.html'));
  106. </code></pre>
  107. <p>Et le tour est joué !</p>
  108. <h1 id="rcursivit">4. Récursivité</h1>
  109. <p>Si vous faites des directives un peu avancées, un jour ou l’autre, vous allez tomber sur une directive qui s’appelle elle-même. Bizarrement, ce n’est pas supporté par défaut par AngularJS. Vous pouvez cependant ajouter un module, RecursionHelper, qui offre un service permettant de compiler manuellement des directives récursives :</p>
  110. <pre><code>angular.module('myProject.directives')
  111. .directive('container', function(RecursionHelper) {
  112. return {
  113. restrict: 'E',
  114. templateUrl: 'partials/container.html',
  115. controller: 'ContainerDirectiveCtrl',
  116. compile: function(element) {
  117. return RecursionHelper.compile(element, function() {
  118. });
  119. }
  120. };
  121. });
  122. </code></pre>
  123. <h1 id="apprendre-des-meilleurs">5. Apprendre des meilleurs</h1>
  124. <p>Le meilleur moyen de progresser en écriture de directives est de vous inspirer des projets open-source. Le projet AngularUI contient un grand nombre de directives, notamment les directives de <a href="http://angular-ui.github.io/bootstrap/">UIBootstrap</a> qui peuvent vous inspirer. L’un des principaux contributeurs au projet, <a href="https://github.com/pkozlowski-opensource">Pawel</a>, a fait un talk avec <a href="http://pkozlowski-opensource.github.io/ng-europe-2014/presentation/#/">quelques idées</a> complémentaires à cet article.</p>
  125. <p>Et si vous voulez mettre tout ça en pratique, <a href="http://ninja-squad.fr/training/angularjs">notre prochaine formation</a> a lieu à Paris les 9-11 Février, et la suivante à Lyon les 9-11 Mars !</p>