Escrever testes de aceitação para código Ember no Discourse

Testes automatizados são uma ótima maneira de proteger seu código contra regressões futuras. Muitas pessoas estão familiarizadas com como fazer isso na nossa base de código Rails com o rspec, mas o lado do JavaScript pode ser um enigma para alguns.

Felizmente, hoje em dia é bem fácil adicionar testes básicos ao seu código Ember!

Para testes de componentes, veja Component tests.

Testes de Aceitação

Testes de aceitação geralmente são mais fáceis de escrever e podem ser mais poderosos do que testes de componentes, pois testam sua aplicação da mesma forma que um usuário faria no navegador. Eu costumo começar com testes de aceitação e, se estiver criando um componente complexo, também adiciono testes para ele.

Veja como podemos escrever um teste de aceitação que acessa nossa rota /admin/snack e confirma que o snack foi renderizado:

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"), "o título do snack está presente");
  });
});

O test() neste caso quase parece inglês! O primeiro comando diz para acessar a URL /admin/snack. Depois disso, há um método andThen(). Este método é necessário para garantir que todo o trabalho em segundo plano termine antes que os testes continuem. Como o código JavaScript e Ember é assíncrono, precisamos garantir que o Ember conclua tudo o que precisa fazer antes que nossas asserções sejam executadas. Finalmente, ele testa se o elemento .fancy-snack-title está presente.

No entanto, se você executar este teste visitando /qunit?module=Acceptance%3A%20Snack, descobrirá que o teste falhará devido a um erro AJAX.

Se você se lembra, nosso código inclui tanto o lado Rails quanto o lado JavaScript que realizava uma requisição AJAX para obter seus dados. O teste de aceitação executava o lado JavaScript, mas não sabia o que fazer para obter seus dados do Rails.

Para corrigir isso, precisamos adicionar uma resposta falsa, usando a excelente biblioteca pretender. Abra o arquivo test/javascripts/helpers/create-pretender.js e procure pela linha que diz:

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

Logo abaixo dela, adicione uma linha para retornar um objeto de snack falso para o nosso teste de aceitação funcionar:

this.get("/admin/snack.json", () => {
  return response({ name: "nome do snack", description: "descrição do snack" });
});

Você pode ler o código acima como “para qualquer requisição a /admin/snack.json, responda com o seguinte response.”

Se você recarregar a URL /qunit?module=Acceptance%3A%20Snack, seu teste de aceitação deverá obter seus dados via pretender e os testes deverão passar.

Para onde ir daqui

Você pode tentar desenvolver um pequeno recurso e adicionar testes para garantir que funcione. Você pode até tentar usar TDD criando seus testes antes de escrever qualquer código no front-end. Dependendo do que você está trabalhando e de suas preferências pessoais, você pode achar esta uma maneira mais agradável de proceder. Boa sorte e bons códigos :slight_smile:


Este documento é controlado por versão - sugira mudanças no github.

15 curtidas

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 curtidas

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 curtidas

Apenas uma observação de que o caminho /qunit está obsoleto. Agora é /tests. Levei um tempo para descobrir isso :slight_smile:

1 curtida