Écrire des tests d'acceptation pour le code Ember dans Discourse

Les tests automatisés sont un excellent moyen de protéger votre code contre les régressions futures. Beaucoup de gens savent comment faire cela dans notre base de code Rails avec rspec, mais le côté JavaScript peut rester quelque peu mystérieux pour certains.

Heureusement, il est assez facile aujourd’hui d’ajouter des tests de base à votre code Ember !

Pour les tests de composants, voir Component tests.

Tests d’acceptation

Les tests d’acceptation sont souvent plus faciles à écrire et peuvent être plus puissants que les tests de composants, car ils testent votre application de la même manière qu’un utilisateur dans son navigateur. Je commence souvent par les tests d’acceptation, puis si je crée un composant complexe, j’ajoute également des tests pour celui-ci.

Voici comment nous pouvons écrire un test d’acceptation qui visitera notre route /admin/snack et confirmera que le snack a été rendu :

test/javascripts/acceptance/snack-test.js

import { acceptance } from "helpers/qunit-helpers";
acceptance("Snack");

test("Visit Page", function (assert) {
  visit("/admin/snack");
  andThen(() => {
    assert.ok(exists(".fancy-snack-title"), "the snack title is present");
  });
});

La fonction test() se lit presque comme de l’anglais ici ! La première commande dit de visiter l’URL /admin/snack. Ensuite, il y a une méthode andThen(). Cette méthode est nécessaire pour s’assurer que tout le travail en arrière-plan est terminé avant que les tests ne continuent. Comme le code JavaScript et Ember est asynchrone, nous devons nous assurer qu’Ember a terminé tout ce qu’il doit faire avant que nos assertions ne soient exécutées. Enfin, il vérifie si l’élément .fancy-snack-title est présent.

Cependant, si vous exécutez ce test en visitant /qunit?module=Acceptance%3A%20Snack, vous constaterez que le test échouera, en raison d’une erreur AJAX.

Si vous vous souvenez, notre code inclut à la fois un côté Rails et un côté JavaScript qui effectuaient une requête AJAX pour obtenir ses données. Le test d’acceptation a exécuté le côté JavaScript, mais il ne savait pas quoi faire pour obtenir ses données de Rails.

Pour corriger cela, nous devons ajouter une fausse réponse, en utilisant l’excellente bibliothèque pretender. Ouvrez le fichier test/javascripts/helpers/create-pretender.js et cherchez la ligne suivante :

this.get("/admin/plugins", () => response({ plugins: [] }));

Juste en dessous, ajoutez une ligne pour renvoyer un faux objet snack afin que notre test d’acceptation fonctionne :

this.get("/admin/snack.json", () => {
  return response({ name: "snack name", description: "snack description" });
});

Vous pouvez lire le code ci-dessus comme « pour toute requête vers /admin/snack.json, répondre avec le response suivant. »

Si vous actualisez l’URL /qunit?module=Acceptance%3A%20Snack, votre test d’acceptation devrait récupérer ses données via pretender et les tests devraient passer.

Que faire ensuite

Vous pourriez essayer de développer une petite fonctionnalité et d’ajouter des tests pour vous assurer qu’elle fonctionne. Vous pourriez même essayer d’utiliser le TDD en créant vos tests avant d’écrire le moindre code côté front-end. Selon ce sur quoi vous travaillez et vos préférences personnelles, vous pourriez trouver cette approche plus agréable. Bonne chance et bon coding :slight_smile:


Ce document est sous contrôle de version - suggérez des modifications sur GitHub.

15 « J'aime »

My prior experience in writing qunit tests was based on the other howto

i.e. “acceptance” was simply

acceptance("Purple Tentacle", { loggedIn: true });

I have seen in other plugins where the test code contained “fake” JSON to test against. I wasn’t sure if that would be as good as testing against “real” data, so I wanted to avoid doing it that way.

The six tests passed, but I got a couple of rather angry looking “unhandled request” errors.

After finding an example of some “setup” code, I tried it and it solved the errors.

It works, but I’m not really sure why, nor why it’s needed for some but not for the majority of plugins I’ve seen that have qunit tests.

3 « J'aime »

For a long time we weren’t great with testing plugins, so not many people followed our example and added tests.

You are right to add a response using pretender to handle AJAX calls.

4 « J'aime »

Juste une note que le chemin /qunit est obsolète. C’est maintenant /tests. Il m’a fallu un certain temps pour le comprendre :slight_smile:

1 « J'aime »