/Desafio_JSExperts_Tests

Repositório dedicado à desafio proposto para fixação de conteúdo do curso JSExperts do Erick Wendell

Primary LanguageJavaScript

PokeAPI Tests

A idéia é testar os fundamentos de testing, aplicando o que foi visto no JS Expert - Módulo 02 num projeto simples e divertido.

Consumindo a PokeAPI, faça uma API que retorne 3 pokemóns aleatórios para formar seu time inicial numa jornada pokemon.

Coverage com 100% de cobertura:

https://guga-santos.github.io/Desafio_JSExperts_Tests/

Requisitos

Funcionalidades

  1. GET /

Deve ser a rota padrão da aplicação ao tentar acessar qualquer rota inexistente (ex.: /hi, /hello), deve retornar uma mensagem sugerindo acessar a rota /team

  1. GET /team

Deve retornar um array com 3 pokemóns aleatórios, contendo seus respectivos name e moves, (mostrando apenas um array de strings com os 3 primeiros moves presentes na API. ex.: ["mega-punch","fire-punch","thunder-punch"]).

Testes

  • mocks
  • stubs
  • spies
  • testes end-2-end
  • testes unitários
  • 100% de code coverage

Extras

  • TDD e BDD, será que rola? Acho que vale a tentativa!
  • Que tal consumir a API sem usar libs externas? o módulo https do node pode ser bem interessante!
  • Publicar o code coverage no github pages!

Dicas

  • Sinta-se livre pra desenvolver sua solução da melhor maneira possível, a arquitetura recomendada foi pensada para ser um desafio focado em testes e não em arquitetura, teremos um desafio de arquitetura mais pra frente

Estrutura de pastas esperadas

project
│   README.md
│   .nycrc.json
│   package.json
│
└───src
│   │   app.js
|   |
|   |___api
|   |   |   index.js
│   │
│   └───repository
│   │   │   teamRepository.js
│   │
│   └───service
│       │   teamService.js
│
└───test
│   └───e2e
│   │   │   api.test.js
│   │
│   └───mocks
│   │   │   valid-team.json
│   │   │   ...
│   │
│   └───unit
│       │   teamRepository.test.js
│       │   teamService.test.js
│
└───coverage
│   │   ...

Entendendo a PokeAPI

URLs Úteis ao desafio:

Checklist features

  • Web API

    • Deve ter uma rota raiz que retorne 404 ou um hello world.
    • Deve ter uma rota de /team, onde:
      • Deve consumir a PokeAPI e selecionar 3 pokemóns aleatórios
      • Deve consumir a PokeAPI para obter mais informações sobre os pokemóns escolhidos
      • Deve retornar um objeto JSON contendo um array com 3 pokemóns, cada um com seus respectivos name do tipo String e moves do tipo Array de String

  • Testes

    • Deve ter testes unitários que cubra todas as funções
    • Deve ter testes end-2-end que cubra todas as rotas
    • Deve ter relatório de 100% de code coverage