A pergunta e duvidas abaixo abordam Node.js, TypeScript e JavaScript. Não sei se os conceitos abaixo se aplicam a outras plataformas/linguagens de programação.
Estou estudando sobre testes automatizados (TA) usando Jest e TypeScript e me surgiu uma dúvida quanto a nomeação dos arquivos de testes. Em alguns projetos que analisei, alguns arquivos estão sendo nomeados de maneira diferente. Alguns possuem a nomenclatura .test.ts
e outros .spec.ts
. Até o presente momento da publicação desta pergunta, eu tinha em mente que test
ou spec
não tinham nenhuma diferença semântica, ambos serviam apenas para identificar que aquele arquivo é um arquivo de teste, porém as distintas nomeações dos arquivos fez surgir a dúvida sobre o assunto.
Estudando e pesquisando sobre TA, encontrei boas respostas sobre o assunto que me ajudou a entender bastante do conceito, mas nada que esclarecesse minha duvida. Por exemplo, esta excelente resposta do @utluiz em que fala sobre conceitos de testes, eu destaco 2 seguintes pontos:
-
Teste Unitário: testa partes específicas do sistema, como classes e métodos.
-
Teste de Integração: testa vários componentes de um sistema funcionando de uma só vez.
Vamos ter essa afirmação em mente.
Agora vamos de código para exemplificar a minha dúvida. Na pasta de testes, tenho 2 arquivos de testes que basicamente o que eles fazem é testar o recurso de cadastrar um novo administrador no sistema. Agora vamos ao primeiro arquivo e ainda vou destacar o nome do arquivo:
- O primeiro se chama
admin-signup.test.ts
e neste arquivo de teste, ele injeta mocks de dependências para dentro do módulo de serviço (AdminServices
):
import * as AdminServices from '@naointeressa';
const adminData = {...}
const AdminRepositoryMock = {...}
const validatorMock = {...}
const bcryptMockValidPass = {...}
describe('any', () => {
it('should ...', async () => {
const sut = await AdminServices.createAdminService(
AdminRepositoryMock,
validatorMock,
bcryptMockValidPass
)
const newAdmin = await sut.createAdmin(adminData)
expect(newAdmin.name).toBeDefined()
expect(newAdmin.email).toBeDefined()
})
...
})
- O segundo se chama
admin-signup.spec.ts
e este se difere do anterior pois ele não injeta mocks, mas sim as verdadeiras dependências do módulo de serviço (AdminServices
):
import * as AdminServices from '@naointeressa';
import * as AdminRepository from '@naointeressa';
import * as crypto from '@naointeressa';
import validator from '@naointeressa';
describe('any', () => {
it('should ...', async () => {
const sut = await AdminServices.createAdminService(
AdminRepository,
validator,
cryptoObject,
);
const newAdmin = await sut.createAdmin(adminData);
expect(newAdmin.name).toBeDefined();
expect(newAdmin.email).toBeDefined();
});
});
Foi nesse código (simplificado obviamente) que me surgiu essa duvida em relação a nomeação dos arquivos de testes.
Eu fiz uma análise dos exemplos acima citados e cheguei ao seguinte pensamento:
Usamos
.test.ts
quando o nosso arquivo de teste não testa nenhum recurso externo da nossa aplicação (banco de dados, API externas, chamadas HTTP, etc...), ou seja, para testes que seguem a citação1
da resposta do @utluiz.Usamos
.spec.ts
quando o teste atravessa camadas externas da aplicação (outros módulos, bibliotecas, banco de dados, etc...), ou seja, para a citação2
da resposta do @utluiz. Testes end-2-end também teriam esse tipo de nomenclatura de arquivos (citaçãoTeste de Sistema
na resposta do @utluiz, me corrijam se estiver errado).
Porém não estou seguro da minha conclusão acima. Estou estudando mais sobre testes e ainda fico com algumas duvidas, então, sobre a minha duvida de nomenclaturas, eu pergunto:
Existem diferenças semânticas entre nomear um arquivo como
.test.ts
e.spec.ts
?Se a reposta da pergunta acima é sim, o meu pensamento sobre onde usar determinada nomenclatura está correto? Se não, e qual contexto eu devo usar um ou outro?
Ou se não existe diferença semântica entre os nomes, posso adotar qualquer um, e todos eles tem o mesmo propósito... indicar que um arquivo é um arquivo de teste?
Cheguei a pensar que spec
vem de algo específico, ou seja, se o teste testa uma funcionalidade muito simples e minúscula da aplicação como por exemplo uma função que verifica se um campo de email não é vazio (''
) e só, nada a mais. Mas não me ajudou a sanar a duvida. Gostaria de uma resposta definitiva.