cypressTest-angular

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

cypressTest-angular

★ 13 Open GitHub ↗

Utilizando o Cypress E2E para testar um blog em Angular.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="left">
  Testes E2E com Cypress
</h1>

<h3 align="center">Programação</h3>

<ul>
  <li>Motivação</li>
  <li>Cypress?</li>
  <li>Trade-offs</li>
  <li>Pré-Requisitos</li>
  <li>O que vamos testar</li>
  <li>Instalação</li>
  <li>Removendo o Protactor</li>
  <li>Cypress Test Runner</li>
  <li>Primeiro Teste</li>
  <li>Como Rodar</li>
  <li>Configuração</li>
  <li>Roteiro de Testes</li>
  <li>Support Commands</li>
  <li>Fixture</li>
  <li>Relatórios e Integrações</li>
  <li>Plugins</li>
  <li>Incluir Outra Spec</li>
  <li>Falso Negativo</li>
  <li>DevOps</li>
  <li>Paralelismo</li>
  <li>Analytics Dashboard</li>
</ul>

<hr>

<h3 align="center">Motivação</h3>

<p align="left">
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Agilidade (- tempo)<br>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Qualidade (- bugs)<br>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Economia de horas (- custo)
</p>

<hr>

<h3 align="center">Por que não somente Testes Unitários?</h3>

<p align="left">
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;O teste E2E simula a navegação pelo usuário, validando não só a interface frontend como integração com o backend.<br>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Teste unitário valida a qualidade do Código. E2E valida a aplicação.
</p>

<hr>

<h3 align="center"> 
  Cypress?
</h3>

<p align="justify">
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;JavaScritpt: Baixa curva de aprendizado, custo com treinamento reduzido.<br>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Performance: Paralelismo, Stress Test, Load Test.<br>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Recorder: Cypress Recorder (Chrome), Katalon Recorder.<br>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Produtividade: Auto-reload, Spies, Stubs e Mocks.<br>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Licença: OpenSource (Mit).<br>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;End-to-end tests, Integration tests, Unit tests.<br>

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Diferente do Selenium ou Appium, que injetam comandos exernos, o Cypress roda no mesmo contexto JS do App, com acesso instantâneo a todas as interações e eventos.
</p>

<h3 align="center"> 
  Trade-offs
</h3>

<p align="justify">
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Cypress não é uma ferramenta de automação geral.<br>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Os comandos do Cypress sempre são executados dentro de um navegador.<br>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Nunca haverá suporte para várias guias do navegador.<br>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Você não pode usar o Cypress para controlar dois navegadores no mesmo teste.
</p>

<hr>

<h3 align="center"> 
  Pré-Requisitos
</h3>

<hr>

<h3 align="center"> 
  O que vamos testar
</h3>

<p align="justify">
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Projeto para teste: Angular Real World Example App
  <pre>git clone https://github.com/gothinkster/angular-realworld-example-app</pre>
  <pre>cd angular-realworld-example-app</pre>
  <pre>npm install</pre>
  <pre>npm run start
http://localhost:4200/</pre><br>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Aqui temos um aplicativo Angular contendo exemplos "reais" (CRUD, autenticação, etc) de acordo com a especificação para exemplos RealWord.<br>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Vamos adicionar o Cypress!
</p>

<hr>

<h3 align="center"> 
  Instalação
</h3>

<p align="justify">
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Abra outro terminal. Na pasta/angular-realworld-example-app/ execute:
  <pre>npm install cypress --save-dev</pre>
  <pre>npx cypress -v</pre>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Caso tenha problemas com Proxy ou Firewall, baixe o <a href="https://download.cypress.io/desktop">binário</a> e configure a variável de ambiente antes de instalar:
  <br><br>
  <pre>set CYPRESS_INSTALL_BINARY=C:\cypress.zip</pre>
  <pre>npm install cypress --save-dev --verbose</pre>
</p>

<hr>

<h3 align="center"> 
  Removendo o Protactor
</h3>

<p align="left">
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Remova o pacote:
  <pre>npm uninstall protactor --save-dev</pre>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Exclua a pasta /e2e/<br>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Do package.json, remova a linha: "e2e": "ng e2e"
</p>

<hr>

<h3 align="center"> 
  Cypress Test Runner
</h3>

<p align="left">
    <pre>npx cypress open</pre>
    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;O comando "cypress open", além de abrir o Cypress Test Runner, cria a pasta inicial /cypress/ e o arquivo de configuração /cypress.json<br>
    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;E já vem com /examples/ dos principais comandos Cypress.
</p>

<hr>

<h3 align="center"> 
  Primeiro Teste
</h3>

<p align="left">
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;cypress/integrations/exemplo.spec.js

```js
describe('Primeiro Teste', () => {
  it('Exemplos Cypress', () => {
    cy.visit('https://example.cypress.io')
    expect(true).to.equal(true)
  })
})
```

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;describe and it come from Mocha<br>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;expect comes from Chai
</p>

<hr>

<h3 align="center"> 
  Como Rodar
</h3>

<p align="left">
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Para executar todos os testes da pasta /cypress/integration/:
  <pre>npx cypress run</pre>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Para executar somente um roteiro:
  <pre>npx cypress run --spec "cypress/integration/examples/example.spec.js"</pre>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Para abrir a interface do Cypress Test Runner:
  <pre>npx cypress open</pre>
</p>

<hr>

<h3 align="center">Configuração</h3>

<p align="left">
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;cypress.json
<pre>
{
  "baseUrl": "http://localhost:4200",
  "pageLoadTimeout": 30000,
  "defaultCommandTimeOut": 30000,
  "viewportHeight": 800,
  "viewportWidth": 500,
  "retries": 3
}
</pre>  
</p>

<hr>

<h3 align="center">Roteiro de Testes</h3>

<ol>
  <li>Cadastro</li>
  <li>Login</li>
  <li>Perfil</li>
  <li>Feeds</li>
  <li>Paginação</li>
  <li>Post</li>
  <li>Tags</li>
  <li>Comentários</li>
  <li>Seguir</li>
  <li>Logout</li>
</ol>

<hr>

<h3 align="center">Cypress Recorder</h3>

<p align="left">
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="https://chrome.google.com/webstore/detail/cypress-recorder/glcapdcacdfkokcmicllhcjigeodacab">Extensão</a> para o Chrome capaz de gravar um roteiro base.<br>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Recomendado para capturar os seletores no DOM.

```js
describe('Conduit Cadastro', () => {
    const usuario = 'usuario' + (new Date()).getTime()
    const senha = 'senha' + (new Date()).getTime()

it('Novo Usuário', () => {
        cy.visit('/register')
        cy.get('[formcontrolname=username]').type(usuario)
        cy.get('[formcontrolname=email]').type(usuario+'@email.com')
        cy.get('[formcontrolname=password]').type(senha)
        cy.get('.btn').click()
        cy.contains('.nav-item:nth-child(4) > .nav-link', usuario)
            .should('be.visible')
    })
})
```
  
  <pre>npx cypress run --spec "cypress/integration/register.spec.js"</pre>
</p>

<hr>

<h3 align="center">Support Comands</h3>

<p align="left">
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;cypress/support/index.js

```js
Cypress.Commands.add('login', (username, password) => {
  cy.visit('/login')
  cy.url().should('include', '/login')
  cy.get('[formcontrolname=email]').type(username)
  cy.get('[formcontrolname=password]').type(password)
  cy.get('.btn').click()
})
```

<hr>

<h3 align="center">Login</h3>

<p align="left">
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;cypress/integration/login.spec.js
</p>

```js
describe('Conduit Login', () => {
    it('Login sucesso', () => {
        cy.login('testecypress@testecypress.com', 'testecypress')
        cy.get('.nav-item:nth-child(4) > nav-link').click()
        cy.get('.btn:nth-child(5)').click()
        cy.url().should('contain', '/settings')
    })

it('Dados Inválidos', () => {
        cy.login('usuario@inexistente.com', 'senhaerrada')
        cy.get('.error-messages > li')
            .should('contain', 'email or password is invalid')
    })
})
```

<hr>

<h3 align="center">Perfil</h3>

<p align="left">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;cypress/integration/perfil.spec.js</p>

```js
describe('Profile', () => {
    it('Editar Perfil', () => {
        cy.login('testecypress@testecypress.com', 'testecypress')
        cy.contains('testecypress').click()
        cy.contains('Edit Profile Settings').click()
        cy.get('[formcontrolname="image"]').clear()
        cy.get('[formcontrolname="image"]')
            .type('https://thispersondoesnotexist.com/image')
        cy.get('[formcontrolname="password"]').type('testecypress')
        cy.contains('Update Settings').click()
    })
})
```

<hr>

<h3 align="center">Feeds</h3>

<p align="left">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;cypress/integration/feed.spec.js</p>

```js
describe('Conduit Feed', () => {

it('Ver Feeds', () => {
        cy.login('testecypress@testecypress.com', 'testecypress')
        cy.get('.nav-pills > .nav-item:nth-child(1) > .nav-link').click();
        cy.get('.nav-pills > .nav-item:nth-child(2) > .nav-link').click()
        cy.get('app-article-preview:nth-child(1) .btn').click()
    })
    
})
```

<hr>

<h3 align="center">Pagination</h3>

<p align="left">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;cypress/integration/pagination.spec.js</p>

```js
describe('Paginação', () => {
    it('Paginar', () => {
        cy.visit('/')
        cy.get('.page-item.active > a').contains('1')
        cy.get('.page-item:nth-child(2) > .page-link').click()
        cy.get('.page-item.active > a').contains('2')
        cy.get('.page-item:nth-child(3) > .page-link').click()
        cy.get('.page-item.active > a').contains('3')
    })
})
```

<hr>

<p align="left">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;cypress/integration/post.spec.js</p>

```js
describe('Post', () => {

beforeEach(() => {
        cy.login('testecypress@testecypress.com', 'testecypress')
    })

it('Novo', () => {
        const tit = 'Cypress E2E'
        cy.contains('New Article').click()
        cy.location('pathname').should('equal', '/editor')
        cy.get('[formcontrolname=title]').type(tit)
        cy.get('[formcontrolname=description]').type('Ponta a Ponta')
        cy.get('[formcontrolname=body]').type('Agilidade, Qualidade')
        cy.contains('Publish Article').click()
        cy.get('h1').contains(tit)
    })

it('Editar', () => {
        cy.contains('testecypress').click()
        cy.location('pathname').should('contains', '/profile')
        cy.get('.article-preview').get('h1').first().click()
        cy.contains('Edit Article').click()
        cy.get('[formcontrolname=body]').clear()
        cy.get('[formcontrolname=body]').type('Economia')
        cy.contains('Publish Article').click()
        cy.contains('Economia')
    })

})
```

<hr>

<p align="left">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;cypress/integration/tags.spec.js</p>

```js
describe('Tags', () => {
    it('Adicionar', () => {
        cy.login('testecypress@testecypress.com', 'testecypress')
        cy.contains('testecypress').click()
        cy.location('pathname').should('contains', '/profile')
        cy.get('.article-preview').get('h1').first().click()
        cy.contains('Edit Article').click()
        cy.get('[placeholder="Enter tags"]').type('dungeons{enter}');
        cy.get('[placeholder="Enter tags"]').type('dragons{enter}');
        cy.contains('Publish Article').click();
        cy.get('.tag-list').contains('dragons');
    })
})
```

<hr>

<h3 align="center">Comentários</h3>

<p align="left">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;cypress/integration/comentarios.spec.js</p>

```js
describe('Comentarios', () => {
    it('Escrever', () => {
        cy.login('testecypress@testecypress.com', 'testecypress')
        cy.contains('Global Feed').click()
        cy.get('.preview-link').first().click()
        cy.get('.form-control').type('Sensacional!')
        cy.get('.btn-primary').click()
        cy.contains('Sensacional!')
    })
})
```

<hr>

<h3 align="center">Seguir</h3>

<p align="left">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;cypress/integration/seguir.spec.js</p>

```js
describe('Seguir', () => {
    it('Seguir Usuário', () => {
        const usuario = 'usuario'+(new Date()).getTime();
        const senha = 'senha'+(new Date()).getTime();
        cy.visit('/register', { timeout: 10000 })
        cy.get('[formcontrolname=username]').type(usuario)
        cy.get('[formcontrolname=email]').type(usuario+'@email.com')
        cy.get('[formcontrolname=password]').type(senha)
        cy.get('.btn').click()
        cy.wait(10000)
        cy.visit('/profile/testecypress')
        cy.contains('Folow').click()
    })
})
```

<hr>

<h3 align="center">Logout</h3>

<p align="left">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;cypress/integration/logout.spec.js</p>

```js
describe('Logout', () => {
    it('Logout via Perfil', () => {
        cy.login('testecypress@testecypress.com', 'testecypress')
        cy.contains('Settings').click()
        cy.url().should('include', '/settings')
        cy.get('.btn-outline-danger').click()
    })
})
```

<hr>

<h3 align="center">Fixture: Data-Driven Tests</h3>

<p align="left">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;cypress/support/index.js</p>

```js
Cypress.Commands.add('loadUsers', () => {
  cy.fixture('users')
    .as('users')
})
```

<p align="left">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;cypress/integration/test.spec.js</p>

```js
// this.users.default.username
// this.users.default.pass
// this.users.client.username
// this.users.client.pass
```

<p align="left">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;cypress/fixtures/users.json</p>

```js
{
  "default":{
    "user": "basic-user",
    "pass": "testpass"
  },
  "client":{
    "user": "premium-user",
    "pass": "testpass"
  }
}
```

<hr>

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="https://docs.cypress.io/plugins/">Plugins</a><br>
<p align="left">
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Funcionalidades extendidas</p>

<hr>

<h3 align="center">Relatórios e Integrações</h3>

<p align="left">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Reports json, html e xml</p>

<ul>
  <li>mocha</li>
  <li>mochawesome</li>
  <li>mochawesome-merge</li>
  <li>mochawesome-report-generator</li>
  <li>cypress-multi-reporters</li>
  <li>cypress-slack-reporter</li>
  <li>cypress-sonarqube-reporter</li>
</ul>

<hr>

<h3 align="center">Falso Negativo</h3>

<p align="left">
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Rede, microserviços e dependências podem falhar<br>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Um teste E2E pode falhar por conta de outros recursos além do controle da sua aplicação:
</p>

<ul>
  <li>Uma API pode falhar</li>
  <li>Insdisponibilidade de Rede ou Firewall</li>
  <li>Indisponibilidade de recursos como CPU e memória</li>
  <li>Deploys paralelos</li>
</ul>

<h3 align="center">Como Identificar?</h3>

<p align="left">
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Verifique se os as apis e serviços estão rodando:
</p>
          
```js
it('Backend Health Checks', () => {
  
  cy.request('https://login/healthcheck').then((response) => {
    expect(response.status).to.eq(200)
  })
  
  cy.request('https://database/healtcheck')
    .then((response) => {
    expect(response.status).to.eq(200)
  })

})
```

<hr>

<h3 align="center">DevOps</h3>

<p align="left>Como rodar no CI/CD</p>
<pre>cypress run</pre>
<pre>cypress run [--record][--key dashboard-key]
          
<p align="left>Environments:</p>
          
<ul>
  <li>CYPRESS_BASE_URL</li>
  <li>CYPRESS_VIDEO_COMPRESSION</li>
  <li>CYPRSS_REPORTER</li>
  <li>CYPRESS_INSTALL_BINARY</li>
  <li>CYPRESS_RECORD_KEY</li>
</ul>

<pre>
# cypress/Dockerfile

# Imagem base
FROM cypress/base:14.0.0

# Copia os arquivos para a imagem
COPY ./

# Opcional - Pega o binário local
#ENV CYPRESS_INSTALL_BINARY=/cypress.zip

RUN npm install --verbose
RUN $(npm bin)/cypress verify

# Inicialização do container
CMD $(npm bin)/cypress run
</pre>

<pre>
# prompt / terminal

docker build -t cypress:0.0.1
docker run cypress:0.0.1
</pre>

<hr>

<h3 align="center">Paralelismo</h3>
<pre>cypress run --parallel --record</pre>

<h3 align="center">Cypress Dashboard</h3>
<pre>cypress run --record --key=abc123</pre>

<h3 align="center">+ exemplos</h3>

<p align="left">1 - Cypress Kitchen Sink</p>
          
<pre>
git clone
https://github.com/cypress-io/cypress-example-kitchensink.git

cd cypress-example-kitchensink
npm install
npm start
npm run cy:open
</pre>

<p align="left">2 - Cypress Real Word App</p>
          
<pre>
git clone
https://github.com/cypress-io/cypress-realworld-app.git

cd cypress-realworld-app
npm install
npm dev
npm run cypress:open
</pre>

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="https://devhints.io/mocha">Cheatsheet Mocha</a><br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="https://devhints.io/chai">Cheatsheet Chai</a><br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="https://cheatography.com/aiqbal/cheat-sheets/cypress-io/">Cheatsheet Cypress</a>

cypressTest-angular

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README