Scrivere test di accettazione per il codice Ember in Discourse

I test automatizzati sono un ottimo modo per proteggere il tuo codice da future regressioni. Molti sanno come farlo nel nostro codebase Rails con rspec, ma la parte Javascript può essere un po’ un mistero per alcuni.

Per fortuna, oggi è piuttosto semplice aggiungere test di base al tuo codice Ember!

Per i test dei componenti, consulta Test dei componenti.

Test di Accettazione

I test di accettazione sono spesso più facili da scrivere e possono essere più potenti dei test dei componenti, poiché testano la tua applicazione nello stesso modo in cui farebbe un utente nel proprio browser. Spesso inizio con i test di accettazione e, se sto creando un componente complesso, aggiungo anche test specifici per esso.

Ecco come possiamo scrivere un test di accettazione che visiterà la nostra rotta /admin/snack e confermerà che lo snack è stato renderizzato:

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"), "il titolo dello snack è presente");
  });
});

La funzione test() in questo caso quasi si legge come l’inglese! Il primo comando dice di visitare l’URL /admin/snack. Dopodiché, c’è il metodo andThen(). Questo metodo è necessario per assicurarsi che tutto il lavoro in background sia completato prima che i test continuino. Poiché il codice Javascript ed Ember è asincrono, dobbiamo assicurarci che Ember abbia terminato tutto ciò che deve fare prima che vengano eseguiti i nostri assert. Infine, verifica se l’elemento .fancy-snack-title è presente.

Tuttavia, se esegui questo test visitando /qunit?module=Acceptance%3A%20Snack, scoprirai che il test fallirà a causa di un errore AJAX.

Se ricordi, il nostro codice include sia una parte lato Rails che una parte Javascript che esegue una richiesta AJAX per ottenere i dati. Il test di accettazione ha eseguito la parte Javascript, ma non sapeva come ottenere i dati da Rails.

Per risolvere questo, dobbiamo aggiungere una risposta falsa, utilizzando l’eccellente libreria pretender. Apri il file test/javascripts/helpers/create-pretender.js e cerca la riga che dice:

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

Subito sotto, aggiungi una riga per restituire un oggetto snack falso per far funzionare il nostro test di accettazione:

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

Puoi leggere il codice sopra come “per qualsiasi richiesta a /admin/snack.json, rispondi con il seguente response.”

Se aggiorni l’URL /qunit?module=Acceptance%3A%20Snack, il tuo test di accettazione dovrebbe recuperare i dati tramite pretender e i test dovrebbero passare.

Dove andare da qui

Potresti provare a sviluppare una piccola funzionalità e aggiungere test per assicurarti che funzioni. Potresti anche provare a usare il TDD creando i tuoi test prima di scrivere qualsiasi codice sul front end. A seconda di su cosa stai lavorando e delle tue preferenze personali, potresti trovare questo un modo più piacevole di procedere. Buona fortuna e buon coding :slight_smile:


Questo documento è soggetto a controllo di versione - suggerisci modifiche su github.

15 Mi Piace

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 Mi Piace

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 Mi Piace

Solo una nota: il percorso /qunit è obsoleto. Ora è /tests. Mi ci è voluto un po’ per capirlo :slight_smile:

1 Mi Piace