2021-07-25 17:25:49 +00:00
# Como adicionar testes Cypress
2021-02-23 05:16:09 +00:00
2021-07-25 17:25:49 +00:00
Quando estiver realizando alterações em JavaScript, CSS ou HTML que podem mudar a funcionalidade ou aparência de uma página, é importante incluir os testes de integração [Cypress ](https://docs.cypress.io ) correspondentes.
2021-02-23 05:16:09 +00:00
2021-07-25 17:25:49 +00:00
Para aprender como escrever testes Cypress ou 'specs', por favor confira a [documentação ](https://docs.cypress.io/guides/getting-started/writing-your-first-test.html ) oficial do Cypress.
2021-02-23 05:16:09 +00:00
2021-07-25 17:25:49 +00:00
## Onde adicionar um teste
2021-02-23 05:16:09 +00:00
2021-07-25 17:25:49 +00:00
- Testes Cypress estão no diretório `./cypress` .
2021-02-23 05:16:09 +00:00
2021-07-25 17:25:49 +00:00
- Testes do Cypress para um módulo do currículo estão no diretório do currículo correspondente, ou seja, `cypress/integration/learn/responsive-web-design/basic-css/index.js` .
2021-02-23 05:16:09 +00:00
2021-07-25 17:25:49 +00:00
## Como executar testes
2021-02-23 05:16:09 +00:00
2022-06-17 16:10:07 +00:00
> [!NOTE] Se estiver usando GitPod, por favor veja essa [configuração sobre Cypress-GitPod](how-to-add-cypress-tests.md#cypress-gitpod-setup)
2021-02-23 05:16:09 +00:00
2021-07-25 17:25:49 +00:00
### 1. Veja se as aplicações de cliente e MongoDB estão executando
2021-02-23 05:16:09 +00:00
2022-06-15 12:44:14 +00:00
- [Inicie o MongoDB e crie o banco de dados ](how-to-setup-freecodecamp-locally.md#step-3-start-mongodb-and-seed-the-database )
2021-02-23 05:16:09 +00:00
2022-06-15 12:44:14 +00:00
- [Inicie também a aplicação de cliente freeCodeCamp e o servidor API ](how-to-setup-freecodecamp-locally.md#step-4-start-the-freecodecamp-client-application-and-api-server )
2021-02-23 05:16:09 +00:00
2021-07-25 17:25:49 +00:00
### 2. Execute os testes do Cypress
2021-02-23 05:16:09 +00:00
2021-07-25 17:25:49 +00:00
Para executar testes usando compilações de produção, substitua `dev` por `prd` abaixo.
2021-02-23 05:16:09 +00:00
2021-07-25 17:25:49 +00:00
- Para executar todos os testes no diretório `./cypress` :
2021-02-23 05:16:09 +00:00
```console
npm run cypress:dev:run
```
2021-07-25 17:25:49 +00:00
- Para executar um único teste:
2021-02-23 05:16:09 +00:00
```console
npm run cypress:dev:run -- --spec=cypress/pathToYourSpec/youSpecFileName.js
```
2021-07-25 17:25:49 +00:00
- Para criar uma versão de compilação, inicie o servidor de desenvolvimento e execute todos os testes cypress contínuos e funcionais existentes:
2021-02-23 05:16:09 +00:00
```console
npm run e2e:dev:run
```
2021-07-25 17:25:49 +00:00
## Configuração do Cypress-GitPod
2021-02-23 05:16:09 +00:00
2022-01-22 15:02:35 +00:00
### 1. Certifique-se que o ambiente de desenvolvimento está em execução
2021-02-23 05:16:09 +00:00
2021-07-25 17:25:49 +00:00
Se o ambiente GitPod não foi criado automaticamente:
2021-02-23 05:16:09 +00:00
2021-07-25 17:25:49 +00:00
- Inicie a base de dados
2021-02-23 05:16:09 +00:00
```console
mongod
```
2021-07-25 17:25:49 +00:00
- Crie a base de dados
2021-02-23 05:16:09 +00:00
```console
npm run seed
```
2022-01-22 15:02:35 +00:00
- Desenvolva o servidor e o client
2021-02-23 05:16:09 +00:00
```console
npm run develop
```
2022-01-22 15:02:35 +00:00
### 2. Instale as ferramentas de compilação do Cypress
2021-02-23 05:16:09 +00:00
```console
npm run cypress:install-build-tools
```
2021-07-25 17:25:49 +00:00
- Quando solicitado no terminal, selecione o layout do seu teclado por idioma/área
2021-02-23 05:16:09 +00:00
2022-06-17 16:10:07 +00:00
Agora, [o Cypress pode ser executado ](how-to-add-cypress-tests.md#_2-run-the-cypress-tests )