Merge pull request #1 from AndressaKarla/refatoracoes

Refatoracoes

Author: AndressaKarla

.github/workflows/workflow-testes-automatizados-web-front-serve-rest-playwright.yml

@@ -1,4 +1,6 @@
 name: Pipeline Testes Automatizados Web Front ServeRest Playwright
+
+# executa o workflow toda vez que for realizado um push ou pull-request no repositório
 on:
   push:
     branches: [ "main" ]
@@ -16,17 +18,18 @@ jobs:
       - name: Passo 1 - Obter cópia do código-fonte do repositório
         uses: actions/checkout@v3
 
-      - name: Passo 2 - Redirecionar o conteúdo de "secrets.LOGIN_ENV" para o arquivo "login.json"
+      - name: Passo 2 - Redirecionar os conteúdos de "secrets.LOGIN_ENV", "secrets.USUARIO_ENV", para os arquivos "login.json", "usuario.json", etc
         run: |
           echo '${{ secrets.LOGIN_ENV }}' > ./tests/support/fixtures/login.json
+          echo '${{ secrets.USUARIO_ENV }}' > ./tests/support/fixtures/usuario.json
 
       - name: Passo 3 - Instalar node versão 18
         uses: actions/setup-node@v3
         with:
           node-version: 18
 
       - name: Passo 4 - Instalar dependências do projeto
-        # forçar, mesmo tendo possíveis conflitos, a instalação das dependências do projeto do arquivo "package.json
+        # forçar, mesmo tendo possíveis conflitos, a instalação das dependências do projeto do arquivo "package.json"
         run: npm install --force
 
       - name: Passo 5 - Instalar navegadores do Playwright

README.md

@@ -2,7 +2,7 @@
 # Projeto de Testes Automatizados Web | Javascript | Playwright | GitHub Actions :test_tube:
 ---
 # :information_source: Introdução
-Esse projeto "testes-automatizados-web-front-serve-rest_playwright-javascript" é executado em um ambiente de desenvolvimento no ["front"](https://front.serverest.dev) do ["ServeRest"](https://github.com/ServeRest) que simula uma loja virtual, adaptado para o curso ["Playwright eXpress"](https://qax.com.br/pt/cursos/playwright-express) da ["QAx"](https://qax.com.br/pt) e desenvolvido com o objetivo de me aprofundar um pouco mais nos estudos sobre testes automatizados web em Javascript e Page Objects nas ferramentas Playwright e GitHub Actions.
+Me baseei e adaptei parte do que foi ensinado nos cursos ["Playwright eXpress"](https://www.udemy.com/course/playwright-express) e ["Playwright Zombie Edition"](https://www.udemy.com/course/playwright-zombie) da ["QAx"](https://www.udemy.com/user/weare-qax) para esse projeto "testes-automatizados-web-front-serve-rest_playwright-javascript" que é executado em um ambiente de desenvolvimento no ["front"](https://front.serverest.dev) do ["ServeRest"](https://github.com/ServeRest) que simula uma loja virtual, e que foi desenvolvido com o objetivo de me aprofundar um pouco mais nos estudos sobre testes automatizados web em Javascript e PageObjects nas ferramentas Playwright e GitHub Actions.
 
 
 ---

package.json

@@ -1,11 +1,17 @@
 {
   "name": "testes-automatizados-web-front-serve-rest_playwright-javascript",
   "version": "1.0.0",
-  "description": "",
-  "main": "index.js",
-  "scripts": {},
-  "keywords": [],
-  "author": "",
+  "description": "Projeto de Testes Automatizados E2E no front e API REST do ServeRest em Playwright e Javascript",
+  "main": "playwright.config.js",
+  "scripts": {
+    "pw:ui": "playwright test --ui",
+    "pw:ui:local": "ENV environment=local playwright test --ui",
+    "test": "playwright test --project=chromium",
+    "test:local": "ENV environment=local playwright test --project=chromium",
+    "test:headed": "playwright test --project=chromium --headed",
+    "test:local:headed": "ENV environment=local playwright test --project=chromium --headed"
+  },
+  "author": "Andressa Karla",
   "license": "ISC",
   "devDependencies": {
     "@playwright/test": "^1.42.1"

playwright.config.js

@@ -13,15 +13,15 @@ module.exports = defineConfig({
     timeout: 5000
   },
 
-  fullyParallel: true,
+  fullyParallel: false,
   forbidOnly: !!process.env.CI,
   retries: process.env.CI ? 2 : 0,
   workers: process.env.CI ? 1 : undefined,
-  reporter: 'html',
+  reporter: [['html', { open: 'never' }]], 
 
   use: {
     actionTimeout: 0,
-    baseURL: baseURLFront,
+    baseURL: baseURIAPI,
 
     viewport: {
       width: 1280,
@@ -37,8 +37,11 @@ module.exports = defineConfig({
   projects: [
     {
       name: 'chromium',
-      use: { ...devices['Desktop Chrome'] },
+      use: { 
+        ...devices['Desktop Chrome'],  
+        baseURL: baseURLFront
+      },
     }
   ]
-});
+})
 

tests/login-entrar.spec.js

@@ -1,25 +1,39 @@
 const { test, expect } = require('@playwright/test')
 const { LoginPage } = require('./pages/login-page')
 const { HomePage } = require('./pages/home-page')
+const { Api } = require('./support/api/api')
 const { carregarFixture } = require('./support/helpers')
 
+/*
+  Funcionalidade: Tela Login - Botão Entrar
+    Como usuário da Tela Login do front do ServeRest
+    Quero clicar no Botão Entrar
+    Para validar o comportamento da funcionalidade
+*/
+
 test.describe('Funcionalidade: Tela Login - Botão Entrar', () => {
-  let loginFixture, loginPage, homePage
-  
-    test.beforeEach( async ({ page }) => {
-      loginFixture = await carregarFixture('login')
-      loginPage = new LoginPage(page)
-      homePage = new HomePage(page)
-      await loginPage.acessarBaseURLFront()
-    })
+  let usuarioFixture, apiRequest, loginFixture, loginPage, homePage 
+
+  test.beforeAll(async ({ request }) => {
+    usuarioFixture = await carregarFixture('usuario')
+    apiRequest = new Api(request)
+    await apiRequest.obterPorEmailEincluirUsuarioAdmin(usuarioFixture.adminValido.nomeValido, usuarioFixture.adminValido.emailValido, usuarioFixture.adminValido.senhaValida)
+  })
+
+  test.beforeEach(async ({ page }) => {
+    loginFixture = await carregarFixture('login')
+    loginPage = new LoginPage(page)
+    homePage = new HomePage(page)
+    await loginPage.acessarBaseURLFront()
+  })
 
   test.describe('Cenário: Validar Login usuário administrador', () => {
     test('Então deverá apresentar a tela Home com o texto Bem Vindo e com o texto Este é seu sistema para administrar seu ecommerce', async ({ page }) => {
       await loginPage.realizarLoginBotaoEntrar(loginFixture.adminValido.emailValido, loginFixture.adminValido.senhaValida)
-      
+
       await page.waitForURL('admin/home')
       await expect(page).toHaveURL('admin/home')
-  
+
       await expect(homePage.textoBemVindo).toHaveText(/Bem Vindo/)
       await expect(homePage.textoSistemaAdministrarEcommerce).toHaveText('Este é seu sistema para administrar seu ecommerce.')
     })
@@ -35,7 +49,7 @@ test.describe('Funcionalidade: Tela Login - Botão Entrar', () => {
     test.describe(`Esquema do Cenário: Validar Login usuários inválidos: ${ex.email} e ${ex.senha}`, async () => {
       test(`Então na tela Login deverá apresentar a mensagem: ${ex.mensagem}`, async () => {
         await loginPage.realizarLoginBotaoEntrar(loginFixture.invalido[ex.email], loginFixture.invalido[ex.senha])
-      
+
         await expect(loginPage.formLogin).toContainText(ex.mensagem)
       })
     })

tests/support/api/api.js

@@ -0,0 +1,30 @@
+import { expect } from '@playwright/test'
+import playwrightConfig from '../../../playwright.config'
+
+class Api {
+    constructor(request) {
+        this.request = request
+        this.baseUri = playwrightConfig.use.baseURL
+    }
+
+    async obterPorEmailEincluirUsuarioAdmin(nomeSobrenome, email, senha) {
+        const getEmailUsuarioAdmin = await this.request.get(`${this.baseUri}/usuarios?email=${email}`)
+        const retornoGetEmailUsuarioAdmin = JSON.parse(await getEmailUsuarioAdmin.text())
+
+        if (retornoGetEmailUsuarioAdmin.quantidade == 0) {
+            const postUsuarioAdmin = await this.request.post(`${this.baseUri}/usuarios`, {
+                data: {
+                    nome: nomeSobrenome,
+                    email: email,
+                    password: senha,
+                    administrador: "true"
+                }
+            })
+
+            expect(postUsuarioAdmin.ok()).toEqual(true)
+        }
+    }
+}
+
+module.exports = { Api: Api }
+

tests/support/fixtures/login.example.json

@@ -1,14 +1,14 @@
 {
     "adminValido": {
-        "emailValido": "informar-email-usuario-admin-valido@dominio.com",
-        "senhaValida": "informar-senha-usuario-admin-valido"
+        "emailValido": "informar-email-usuario-admin-valido@qa.com",
+        "senhaValida": "informar-mesma-senha-usuario-admin-valido-fixture-usuario"
     },
     "invalido": {
         "emailInvalidoVazio": "deixar-apenas-as-aspas-duplas",
         "senhaInvalidaVazia": "deixar-apenas-as-aspas-duplas",
-        "emailInvalidoDominioSemPonto": "informar-email-usuario-invalido-dominio-sem-ponto@dominio",
+        "emailInvalidoDominioSemPonto": "informar-email-usuario-invalido-dominio-sem-ponto@outlook",
         "senhaValida": "informar-senha-usuario-valido",
-        "emailInvalidoNaoCadastrado": "informar-email-usuario-invalido-nao-cadastrado@dominio.com",
+        "emailInvalidoNaoCadastrado": "informar-email-usuario-invalido-nao-cadastrado@gmail.com",
         "senhaInvalidaNaoCadastrada": "informar-senha-usuario-invalido-nao-cadastrada"
     }
 }

tests/support/fixtures/usuario.example.json

@@ -0,0 +1,7 @@
+{
+    "adminValido": {
+        "nomeValido": "informar-nome-usuario-admin-valido",
+        "emailValido": "[email protected]",
+        "senhaValida": "informar-mesma-senha-usuario-admin-valido-fixture-login"
+    }
+}

tests/support/helpers.js

@@ -1,3 +1,5 @@
+import { expect } from '@playwright/test'
+
 const carregarFixture = async (nomeArquivo) => {
     const fixture = require(`./fixtures/${nomeArquivo}`)
     return fixture