Quando criamos funções lambda precisamos garantir o comportamento de todos os itens de maneira integrada, e isso comumente ocorre subindo a aplicação e realizando os testes manuais, enquanto os métodos que são consumidos pela função lambda são validados unitariamente.
Nesse cenário podemos garantir que o método que identifica se determinado token é valido está comportando da maneira esperada ou não, porém não temos a garantia de que ele está funcionando corretamente de maneira integrada à função lambda, barrando acessos com token inválido e permitindo apenas os acessos com o token esperado.
E é por isso que foi criado esse repositório, com o propósito de demonstrar que é sim possível validar uma função lambda totalmente integrada na camada de testes unitários, identificando comportamentos que normalmente seriam pegos apenas no teste manual. E com esse teste automatizado temos a vantagem de executar o mesmo de forma recorrente em pipeline a cada alteração.
Uma alta cobertura de cenários de funções lambda (e consequentemente alta cobertura de código) é possível.
O exemplo principal é a demonstração da biblioteca lambda-tester, que é utilizado nos arquivos que estão dentro do diretório ./tests/handler.
Recomendo você acessar o diretório ./src, estudar os 2 arquivos presentes no mesmo e em seguida executar a aplicação localmente (ler a seção Aplicação mais abaixo) para entender o comportamento da função lambda criada.
Em seguida execute os testes (ler a seção Testes mais abaixo) e estude os testes implementados.
Todos os arquivos em /src e /tests possuem comentários no topo para auxiliar no entendimento do código, mesmo que não possua familiaridade com função lambda não deixe de acessá-los e ler.
Espero que te auxilie :D
É preciso ter os seguintes programas instalados para executar os testes e a aplicação:
Os testes unitários que utilizam a biblioteca lambda-tester estão no diretório ./tests/handler.
Os testes estão divididos em 3 arquivos e validam os seguintes cenários:
- tests/functions/tokenIsValid.spec.js - Teste unitário do método
tokenIsValid(em ./src/authorization.js). - tests/handler/catchError.spec.js - Teste unitário da função lambda (em ./src/index.js) com a biblioteca lambda-tester validando cenário de exceção.
- tests/handler/authorization.spec.js - Teste unitário da função lambda (em ./src/index.js) com a biblioteca lambda-tester validando a integração da função lambda com o método tokenIsValid.
Para rodar os testes execute o seguinte comando no terminal:
docker-compose up testOu, caso prefira, acesse a pipeline para ver o resultado dos testes: https://github.com/PauloGoncalvesBH/lambda-unit-test/actions
A linha 23 é o cenário de execução da função lambda estando autenticado. Essa linha não foi coberta devido de que o propósito desse exemplo era demonstrar o uso da biblioteca lambda-tester.
A aplicação está no diretório ./src, tendo como ponto de entrada o arquivo ./src/index.js, e com a configuração do lambda no arquivo serverless.yml.
Para iniciar a aplicação localmente execute o seguinte comando:
docker-compose up start-serverlessE em seguida, no browser, acesse a URL http://localhost:3000/?token=auth-password.
Para simular o comportamento de Acesso não autorizado acesse o browser com valor diferente em token ou sem o mesmo, como:
- Biblioteca NPM 'lambda-tester'
- Texto 'Abordagem de testes' da Samanta Cicilia (
Pirâmide de testes é o mito da área de QA) - Documentação do plugin 'serverless-offline'