search

testing-community / workshop-protractor

https://drive.google.com/drive/folders/1Fvx7o_eoSq_19Oyg_xmELmvuclJUrgUC
MIT License
13 stars 33 forks source link

readme

Workshop Protractor

!Bienvenido! El objetivo de este taller es aprender a automatizar pruebas de interfaz gráfica (UI) usando Protractor. Mediante el desarrollo de varios ejercicios prácticos, se abarcará diferentes temas para desarrollar un proyecto de automatización. Durante el desarrollo de los ejercicios, se explicará cómo preparar un proyecto para un proceso de integración continúa con Travis CI, cómo usar SauceLabs como plataforma de pruebas en la nube, el uso de Zalenium para orquestar pruebas (tanto local como en la nube), y el uso de Github y Gitflow para la entrega de un producto de software.

Se asume que la persona tiene conocimientos previos en:

Recursos:

Steps

Tabla de Contenido

  1. Configuración Inicial del Proyecto
  2. Mejorando el primer caso de prueba
  3. Agregando Reporte a la Consola
  4. Desactivar el manejador de promesas y Selenium server
  5. Chrome Headless
  6. Agregar Integración Continua
  7. Agregando Análisis de Código Estático
  8. Depurando El Código
  9. CSS Selector
  10. Page Object Model
  11. Esperas de Carga de Página y de Jasmine
  12. Esperas Implicitas
  13. Esperas Explicitas
  14. Mejorando los Locator
  15. Separar prueba en diferentes describes
  16. Agregando Jasmine Awesome
  17. Utilizando Capabilities para configurar Chrome
  18. Listas de Elementos, filtros y elementos dentro de elementos
  19. Más Locators
  20. Ejecución de Código Javascript
  21. Trabajando con IFrames
  22. Subiendo un Archivo
  23. Descargando Archivos
  24. Configurar Saucelabs
  25. Probar con diferentes navegadores
  26. Zalenium

1. Configuración Inicial del Proyecto

Descripción: Se configurará inicialmente el proyecto con TypeScript y se hará una prueba sobre la página de Google. Adicionalmente se creará la configuración necesaria básica para un repositorio de Github

Nota: Si no tiene conocimiento sobre Github se le recomienda realizar las Guias de Github o el lab de Introduction to Github

  1. Crear una cuenta en Github si no la tiene.

  2. Crear un repositorio en limpio dentro de la página de GitHub con el nombre de “protractor-workshop”

  3. Crear una carpeta en su computador llamada protractor-workshop y ubicarse en ella en una consola

  4. Seguir las instrucciones para realizar el primer commit (use las que aparece en lá página de github)

    echo "# protractor-workshop" >> README.md
git init
git add README.md
git commit -m "first commit"
git remote add origin git@github.com:<su-usuario>/protractor-workshop.git
git push -u origin main

  5. En la configuración del repositorio de GitHub en la opción Branches proteja la rama Master indicando que los PR requieran revisión antes de mergear y que requiera la comprobación del estado antes de hacer merge

  6. Dentro del menú colaboradores agregar a:

  7. Instalar JDK en su equipo si no lo tiene instalado

  8. Instalar NodeJS en su equipo si no lo tiene instalado.

  9. Crear una rama project-setup en el repositorio

    git checkout -b project-setup

  10. Crear el archivo .editorconfig a raíz del proyecto con la siguiente información

    root = true

[*]
indent_style = space
end_of_line = lf
charset = utf-8
trim_trailing_whitespace = true
insert_final_newline = true
indent_size = 2

[*.md]
indent_size = 4
trim_trailing_whitespace = false

  11. Instalar la extensión de Visual Studio Code EditorConfig for VS Code (Generalmente requiere reinicio del IDE)

  12. Ejecutar en una consola npm init dentro de la ruta donde se encuentra el repositorio y colocar la siguiente información:

    Parametro Valor
    Name workshop-protractor
    Version [Por Defecto]
    Description This is a Workshop about Protractor
    Entry Point [Por Defecto]
    Test Command protractor dist/protractor/local.config.js
    Git Repository [Por Defecto]
    Keywords ui-testing, protractor
    Author [Su nombre] <[Su correo]> ([su github])
    License MIT

  13. Instalar la dependencia de protractor npm install --save-dev protractor

  14. Instalar las dependencias de desarrollo de typescript npm i --save-dev typescript

  15. Instalar los types de NodeJS npm install --save-dev @types/node

  16. Instalar los types de Jasmines npm install --save-dev @types/jasminewd2

  17. Crear en la raíz del proyecto la carpeta protractor y dentro de ella el archivo local.config.ts y agregar la siguiente información

    import { Config } from 'protractor';

export const config: Config = {
  framework: 'jasmine',
  specs: [ '../test/google.spec.js' ],
  seleniumAddress: 'http://localhost:4444/wd/hub'
};

  18. Actualizar los drivers con el comando

    npx webdriver-manager update

  19. En la consola ejecutar

    npx webdriver-manager start

  20. Crear la carpeta test en la raíz del proyecto y dentro de la carpeta crear el archivo google.spec.ts

    import { browser } from 'protractor';

describe('This is the first example of protractor', () => {
 it('should have a title', () => {
     browser.driver.get('http://www.google.com');
     expect(browser.driver.getTitle()).toEqual('Google');
 });
});

  21. Crear el archivo tsconfig.json en la raíz del proyecto con el siguiente contenido

    {
    "compilerOptions": {
        "outDir": "dist",
        "sourceMap": true,
        "mapRoot": "dist",
        "noUnusedLocals": true
    }
}

  22. Modificar los scripts del package.json para que tengan el siguiente contenido:

    "clean": "rm -rf dist",
"build": "npm run clean && tsc",
"test": "npm run build && protractor dist/protractor/local.config.js"

  23. Ejecutar el comando en una segunda consola npm test y comprobar que la prueba pasa de forma satisfactoria

  24. Crear el archivo .gitignore en la raíz del proyecto. Ingresar a la página https://www.gitignore.io/ y en el área de texto agregar el sistema operativo, IDE's y NodeJS, ejemplo OSX Node VisualStudioCode. Genere el archivo y cópielo dentro del archivo .gitignore

  25. Agregar al final del .gitignore las siguientes líneas

    # Typescript
dist

  26. Crear el archivo LICENSE en la raíz del proyecto con lo especificado en https://en.wikipedia.org/wiki/MIT_License (Tenga en cuanta cambiar el año y el copyright holders)

  27. Crear la carpeta a nivel de raíz llamada .github y dentro de ella crear el archivo CODEOWNERS con el siguiente contenido

    * @aperdomob @holgiosalos @veronicatofino @alejagonzalezv @angieVa @kliver98 @danielgalvis98

  28. Realizar un commit donde incluya los 8 archivos modificados con el mensaje “setup protractor configuration” y subir los cambios al repositorio

    git add .
git commit -m "setup protractor configuration"
git push origin project-setup

  29. Crear un PR, asignarle los revisores y esperar por la aprobación o comentarios de los revisores. Si no sabe como realizarlo siga las siguientes instrucciones

  30. Una vez aprobado realizar el merge a master seleccionando la opción “squash and merge”

2. Mejorando el primer caso de prueba

Descripción: Se utilizará el método onPrepare para configurar la información que debería ser igual en todas las pruebas, adicionalmente se utilizará el beforeEach para organizar la prueba de forma más legible

  1. Crear la rama improve-test a partir de master

  2. Cambiar el contenido del archivo google.spec.ts por

    import { browser } from 'protractor';

describe('Given a SDET learning protractor', () => {
  describe('when open Google Page', () => {
    beforeEach(() => {
      browser.driver.get('http://www.google.com');
    });

    it('then should have a title', () => {
      expect(browser.driver.getTitle()).toEqual('Google');
    });
  });
});

  3. Ejecutar npm test y verificar la correcta ejecución de la prueba

  4. Subir los cambios a Github

  5. Crear un PR, asignar los revisores y esperar por la aprobación o comentarios de los revisores.

  6. Una vez aprobado realizar el merge a master seleccionando la opción “squash and merge”

  7. Eliminar la rama una vez mergeada

3. Agregando Reporte a la Consola

Descripción: Es necesario poder ver los resultados de una forma entendible en la consola, en esta sesión se configura un reporte de consola.

  1. Instale la dependencia de desarrollo jasmine-spec-reporter npm install -D jasmine-spec-reporter

  2. Crear la carpeta protractor/helpers y dentro de la carpeta el archivo reporter.ts con el siguiente contenido

    import { SpecReporter, StacktraceOption } from 'jasmine-spec-reporter';
export let reporter = () => {
  jasmine.getEnv().addReporter(new SpecReporter({
    spec: {
      displayStacktrace: StacktraceOption.PRETTY,
      displayDuration: true
    }
  }));
};

  3. Modifique el archivo local.config.ts incluyendo el import del reporter

    import { reporter } from './helpers/reporter';

  4. Modificar el protractor/local.config.ts agregando la propiedad onPrepare con el siguiente contenido:

      onPrepare: () => {
    reporter();
  }

  5. Solicite la revisión de código tal como se hizo en el punto anterior. Dentro de la descripción del PR incluya una imagen con el resultado de la ejecución, así como muestra a continuación

    Console result

4. Desactivar el manejador de promesas y Selenium server

Descripción: En el issue WebDriverJS recomienda dejar de utilizar la implentación propia de promesas personalizadas de Selenium que ha trabajado desde sus inicios, aunque hoy en día aún hay soporte es necesario empezar a trabajar de la forma que recomienda Protractor

  1. Eliminar la propiedad seleniumAddress del local.config.ts

  2. Termine el proceso del npx webdriver-manager start (ya no es necesario)

  3. Agregar la propiedad SELENIUM_PROMISE_MANAGER con el valor false en el local.config.ts

  4. Modificar el archivo de google.spec.ts para que trabaje con async/await

    import { browser } from 'protractor';

describe('Given a SDET learning protractor', () => {
  describe('when open Google Page', () => {
    beforeEach(async () => {
      await browser.driver.get('http://www.google.com');
    });

    it('then should have a title', async () => {
      expect(await browser.driver.getTitle()).toEqual('Google');
    });
  });
});

  5. Solicite la revisión de código tal como se hizo en el punto anterior

5. Chrome Headless

Descripción: Muchas veces no contamos con servidores de integración continua que tengan acceso a máquinas con interfaz gráfica. Existen algunos navegadores que tienen versión headless que funcionan sin interfaz gráfica pero se comportan muy similar a los navegadores comunes. En esta sesión vamos a configurar la versión headless de chrome

  1. Duplicar el archivo local.config.ts con el nombre de headless.config.ts

  2. Agregar la propiedad de capabilities en el nuevo archivo con la siguiente información

    capabilities: {
  browserName: 'chrome',
  chromeOptions: {
    args: ['--headless', '--disable-gpu']
  }
}

  3. Duplicar el script test del package.json con el nombre de test:headless y cambia la ruta de ejecución al archivo headless.conf.js

  4. Cambia el nombre del script test por test:local

  5. Ejecuta tanto el comando npm run test:local como el npm run test:headless para comprobar que ejecuta efectivamente

  6. Solicite la revisión de código tal como se hizo en el punto anterior

6. Agregar Integración Continua

Descripción: La integración continua es una práctica requerida hoy en día, en esta sesión configuraremos travis para ejecutar nuestra integración continua

  1. Crear el archivo .nvmrc en la raíz del proyecto con el contenido v15.3.0

  2. Crear el archivo .travis.yml en la raíz del proyecto

  3. Agregar el siguiente contenido

    dist: xenial
addons:
  chrome: stable
language: node_js
install:
  - npm ci
  - npm run webdriver:update
cache:
  directories:
    - "node_modules"

  4. Habilitar Travis en el repositorio https://docs.travis-ci.com/user/getting-started/

  5. Modificar los scripts de package.json agregando "test": "npm run test:headless"

  6. Agregar el script "webdriver:update" con el valor "webdriver-manager update --gecko false"

  7. Subir los cambios a github (no cree aún el PR)

  8. Ir a la url de Configuración de Travis

  9. Habilite la configuración GitHub Apps

  10. Cree un PR

  11. Verificar que la ejecución en Travis termine correctamente

7. Agregando Análisis de Código Estático

Descripción: El análisis de código estático nos ayuda a estandarizar la forma en como escribimos código, en esta sesión configuraremos eslint con airbnb para tener análisis de código estático

  1. Agregar las dependencias de desarrollo eslint, @typescript-eslint/eslint-plugin, @typescript-eslint/parser, eslint-plugin-protractor, y eslint-config-airbnb

  2. Crear el archivo .eslintrc.js en la raíz con la siguientes información

    module.exports = {
"env": {
    "browser": true,
    "commonjs": true,
    "es2021": true
},
"extends": [
    "eslint:recommended",
    "plugin:@typescript-eslint/recommended",
    "plugin:protractor/recommended"
],
"parser": "@typescript-eslint/parser",
"parserOptions": {
    "ecmaVersion": "latest"
},
"plugins": [
    "@typescript-eslint",
    "protractor"
],
"rules": {
    "comma-dangle": "off",
    "@typescript-eslint/comma-dangle": ["error", "only-multiline"]
}
}

  3. Agregar el script de package.json lint "lint": "eslint . --ext .ts"

  4. Corregir las reglas de forma automática npm run lint -- --fix

  5. Las reglas que no se puedan corregir automáticamente investigue y corrijalas. Ejecute el comando npm run lint para verificar que reglas esta rompiendo

  6. Modifique el script de build del package.json agregandole al principio npm run lint &&

  7. Solicite la revisión de código tal como se hizo en el punto anterior

NOTA: se recomienda instalar la extensión ESLint de vs code

8. Depurando El Código

Descripción: La depuración nos ayudará a identificar y corregir las parte del código que estén presentando fallas, así como poder tener una mayor entendimiento de las valores de las variables en tiempo de ejecución. Para activar el debugger en vs code:

  1. Vaya a la vista de Debug (⇧⌘D - mac / )

  2. Haga click en el ícono del engranaje y seleccione Node.js. Estor creará el archivo .vscode/launch.json

  3. Reemplace el contenido del archivo por la siguiente información

    {
  // Use IntelliSense to learn about possible attributes.
  // Hover to view descriptions of existing attributes.
  // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "Debug tests",
      "program": "${workspaceRoot}/node_modules/protractor/bin/protractor",
      "args": ["${workspaceRoot}/dist/protractor/local.config.js"],
      "preLaunchTask": "npm: build",
      "sourceMaps": true,
      "smartStep": true,
      "internalConsoleOptions": "openOnSessionStart",
      "outFiles": [
          "${workspaceFolder}/dist/**/*.js"
      ]
    },
    {
      "type": "node",
      "request": "launch",
      "name": "Debug headless tests",
      "program": "${workspaceRoot}/node_modules/protractor/bin/protractor",
      "args": ["${workspaceRoot}/dist/protractor/headless.config.js"],
      "preLaunchTask": "npm: build",
      "sourceMaps": true,
      "smartStep": true,
      "internalConsoleOptions": "openOnSessionStart",
      "outFiles": [
          "${workspaceFolder}/dist/**/*.js"
      ]
    }
  ]
}

  4. Compruebe que puede lanzar las pruebas y depurarlas utilzando vs code

  5. Envíe un pull request con una captura de pantalla en la que se identifique fue posible hacer depuración del test google.spec.ts

  6. Solicite la revisión de código tal como se hizo en el punto anterior

Sobre las opciones de depuración de node:

9. CSS Selector

Descripción: Los css selector son los selectores más utilizados por los desarrolladores, tener un buen dominio de ellos facilita la automatización de pruebas. En esta sesión se implementará un primer caso de pruebas con css selectores

  1. Crear el archivo buy-tshirt.spec.ts dentro de la carpeta test

  2. Escribir dentro del archivo el siguiente contenido

    import { $, browser } from 'protractor';

describe('Buy a t-shirt', () => {
  beforeEach(() => {
    jasmine.DEFAULT_TIMEOUT_INTERVAL = 120000;
  });

  it('then should be bought a t-shirt', async () => {
    await browser.get('http://automationpractice.com/');
    await(browser.sleep(10000));
    await $('#block_top_menu > ul > li:nth-child(3) > a').click();
    await(browser.sleep(3000));
    await $('#center_column a.button.ajax_add_to_cart_button.btn.btn-default').click();
    await(browser.sleep(3000));
    await $('[style*="display: block;"] .button-container > a').click();
    await(browser.sleep(3000));
    await $('.cart_navigation span').click();
    await(browser.sleep(3000));

    await $('#email').sendKeys('aperdomobo@gmail.com');
    await $('#passwd').sendKeys('WorkshopProtractor');
    await $('#SubmitLogin > span').click();
    await(browser.sleep(3000));

    await $('#center_column > form > p > button > span').click();
    await(browser.sleep(3000));

    await $('#cgv').click();
    await(browser.sleep(3000));

    await $('#form > p > button > span').click();
    await(browser.sleep(3000));
    await $('#HOOK_PAYMENT > div:nth-child(1) > div > p > a').click();
    await(browser.sleep(3000));
    await $('#cart_navigation > button > span').click();
    await(browser.sleep(3000));

    await expect($('#center_column > div > p > strong').getText())
      .toBe('Your order on My Store is complete.');
  });
});

  3. Modifique los archivos de configuración de protractor cambiando

    specs: ['../test/**/*.spec.js']

    y

    getPageTimeout: 1000

  4. Ejecute las pruebas tanto con interfaz gráfica como en modo headless. Si alguna prueba falla modificarla utilizando css locators o los tiempos hasta que logre funcionar

  5. Solicite la revisión de código tal como se hizo en el punto anterior

10. Page Object Model

Descripción: El page object model es el patrón por defecto que se utiliza para la mantenibilidad de las pruebas, conocer cómo implementar este patrón le ahorrará muchas horas de reproceso en el futuro. En esta sesión se hará la primera implementación del patrón Page Object Model (POM)

  1. Crear la carpeta src/page desde la raíz del proyecto

  2. Crear el archivo src/page/menu-content.page.ts con el siguiente contenido

    import { $, ElementFinder } from 'protractor';

export class MenuContentPage {
  private tShirtMenu: ElementFinder;

  constructor () {
    this.tShirtMenu = $('#block_top_menu > ul > li:nth-child(3) > a');
  }

  public async goToTShirtMenu(): Promise<void> {
    await this.tShirtMenu.click();
  }
}

  3. Crear el archivo src/page/index.ts con el siguiente contenido

    export { MenuContentPage } from './menu-content.page';

  4. Modificar el archivo buy-tshirt.spec.ts de la siguiente forma

    • Importar la dependencia del page object despues del import de protractor

      import { browser } from 'protractor';
import { MenuContentPage } from '../src/page';

    • Creando una instancia del objeto MenuContentPage

      describe('Buy a t-shirt', () => {
const menuContentPage: MenuContentPage = new MenuContentPage();

    • Modificando el locator que le da clic en el menú de t-shirt

      await browser.get('http://automationpractice.com/');
await(browser.sleep(3000));
await menuContentPage.goToTShirtMenu();

  5. Realice el resto de page object y remplacelo en la prueba, los nombres de los page object son: address-step.page.ts, bank-payment.page.ts, order-summary.page.ts, payment-step.page.ts, product-added-modal.page.ts, product-list.page.ts, shipping-step.page.ts, sign-in-step.page.ts, summary-step.page.ts

  6. Ejecute las pruebas tanto con interfaz gráfica como en modo headless. Si alguna prueba falla modificarla utilizando css locators o los tiempos hasta que logre funcionar

  7. Solicite la revisión de código tal como se hizo en el punto anterior

11. Esperas de Carga de Página y de Jasmine

Descripción: Las esperas en selenium son los tiempos que se esperará para realizar algunas acciones, conocerlos y saber cómo utilizarlos nos disminuirá la fragilidad de las pruebas y adicionalmente nos ayudará a reducir los tiempos de ejecución.

  1. Cambia el valor del getPageTimeout por 30000 en los archivos de configuración de protractor

  2. Elimina el sleep de 10000

  3. Ejecutar las pruebas y verifica que aun sigan funcionando

  4. Agregar el tiempo de espera de Jasmine dentro de los archivos de configuración como muestra la siguiente imagen

    jasmineNodeOpts: {
  defaultTimeoutInterval: 120000
}

  5. Eliminar el beforeEach de la prueba

  6. Ejecute las pruebas tanto con interfaz gráfica como en modo headless. Si alguna prueba falla modificarla utilizando css locators o los tiempos hasta que logre funcionar

  7. Solicite la revisión de código tal como se hizo en el punto anterior

12. Esperas Implicitas

Descripción: Una espera implícita es una espera global que se tiene para cada elemento de la página. En esta sesión veremos cómo tenerla configurada nos ayudará a reducir la cantidad de sleeps de la prueba

  1. Agregar dentro del onPrepare de los archivos de config la línea

    browser.manage().timeouts().implicitlyWait(3000);

  2. Quitar todos los sleeps de la prueba

  3. Ejecute las pruebas tanto con interfaz gráfica como en modo headless. Si alguna prueba falla modificarla utilizando css locators o los tiempos hasta que logre funcionar

  4. Solicite la revisión de código tal como se hizo en el punto anterior

13. Esperas Explicitas

Descripción: Las esperas explícitas es la más recomendada, ya que nos permite hacer esperas puntuales sobre algunos elementos y no sobre todos. En esta sesión desactivaremos las esperas implícitas y activaremos las explícitas donde sea necesario

  1. Modificar los archivos de configuración de tal forma que desactive las esperas implicitas

    browser.manage().timeouts().implicitlyWait(0)

  2. Ejecute la prueba e identifique en qué partes la prueba falla

  3. Utiliza esperas explícitas para solucionar las fallas de la prueba. busque apoyo de browser y ExpectedConditions

  4. Ejecute las pruebas tanto con interfaz gráfica como en modo headless. Si alguna prueba falla modificarla utilizando css locators o los tiempos hasta que logre funcionar

  5. Solicite la revisión de código tal como se hizo en el punto anterior

14. Mejorando los Locator

Descripción: En esta sesión usted hará la propuesta de que locators deberían ser utilizados en la prueba que se está implementado.

  1. Haga su propia propuesta de locators para cada uno de los page-objects
  2. Enviar PR con los cambios
  3. El revisor comentará con los que no está de acuerdo, en ese caso, justifique la razón de su selección (No une XPATH)

15. Separar prueba en diferentes describes

Descripción: Por legibilidad es bueno tener sesionados cada uno de los pasos de las pruebas en diferentes describes, en esta sesión usted aprenderá cómo hacerlo

  1. Modificar la prueba de buy-tshirt.spec.ts de tal forma que tenga varios describes de la siguiente forma
    • Abrir la página en el navegador
    • Proceso de compra de la Camiseta
    • Logeo en la aplicación
    • Seleccionar la dirección por defecto
    • Pago en el banco (Este debe contener el it de validación)
  2. Enviar PR con los cambios

16. Agregando Jasmine Awesome

Descripción: agregaremos un reporte visual a nuestro proyecto de tal forma que tenga un reporte html de la ejecución de las pruebas

  1. Instalar la dependencia de desarrollo jasmine-awesome-report
  2. Siga las instrucciones de https://github.com/aperdomob/jasmine-awesome-report (La carpeta debe llamarse reports y el reporte awesome)
  3. Modificar el gitignore para que excluya la carpeta del reports
  4. Modificar el package.json para que el script del clean borre la carpeta de reports
  5. Ejecute las pruebas tanto con interfaz gráfica como en modo headless. Si alguna prueba falla modificarla utilizando css locators o los tiempos hasta que logre funcionar
  6. Solicite la revisión de código tal como se hizo en el punto anterior

17. Utilizando Capabilities para configurar Chrome

Descripción: Las popups que muestra chrome cuando se está ejecutando por selenium son molestas y pueden causar fragilidad en las pruebas, en esta sesión se enseñará a desactivarlas por medio de las capabilities.

  1. Modificar la configuración local de protractor agregando capabilities para chrome para evitar mostrar algunas ventanas emergente en la ejecución

    capabilities: {
  browserName: 'chrome',
  chromeOptions: {
    args: ['--disable-popup-blocking', '--no-default-browser-check', '--window-size=800,600'],
    prefs: { credentials_enable_service: false }
  }
},

  2. Tomar una foto de que el test se ejecuta sin las ventanas emergentes y colocarla en la descripción del PR

  3. Ejecute las pruebas tanto con interfaz gráfica como en modo headless. Si alguna prueba falla modificarla utilizando css locators o los tiempos hasta que logre funcionar

  4. Solicite la revisión de código tal como se hizo en el punto anterior

18. Listas de Elementos, filtros y elementos dentro de elementos

Descripción: En muchas ocasiones tenemos que obtener un locator para posteriormente poder hacer una acción sobre un hermano o alguno que no esté directamente relacionado, en esta sesión trabajaremos con la anidación de locators y métodos de búsqueda para poder conseguir relacionar dos locators

  1. Agregar una variable privada dentro de product-list.page.ts llamado products el cual obtendrá todos los productos
  2. Cree el método privado findByProduct el cual debe retornar toda la caja del producto con el nombre específico. Utilice $ para obtener elementos internos del locator, filter para filtrar la lista y first para obtener el primer elemento. Revise la API de protractor por si tiene alguna duda
  3. Elimine el método que antes obtenía el primer elemento y cambielo por un método llamado selectProduct que reciba el nombre del producto y le da clic en la imagen
  4. Ejecute las pruebas tanto con interfaz gráfica como en modo headless. Si alguna prueba falla modificarla utilizando css locators o los tiempos hasta que logre funcionar
  5. Solicite la revisión de código tal como se hizo en el punto anterior

19. Más Locators

Descripción: esta sesión automatizaremos otra página diferente, y su misión es seleccionar los mejores locators posibles de tal forma que el page object sea lo más reutilizable posible

  1. Crear el archivo personal-information.page.ts en la carpeta src/page

  2. Crear el archivo locators.spec.ts en la carpeta de test, dentro de este archivo se navegará a https://www.tutorialspoint.com/selenium/selenium_automation_practice.htm y ejecutará el siguiente método que debe llenar el formulario con la información que se indica y dar clic en el botón Button (Evitar el uso de css locators)

    await personalInformationPage.fillForm({
   firstName: 'Alejandro',
   lastName: 'Perdomo',
   sex: 'Male',
   experience: 7,
   profession: ['Automation Tester'],
   tools: ['Selenium Webdriver'],
   continent: 'South America',
   commands: [
     'Browser Commands',
     'Navigation Commands',
     'Switch Commands',
     'Wait Commands',
     'WebElement Commands']
});

  3. Realizar una comprobación del título "Practice Automation Form"

20. Ejecución de Código Javascript

Descripción: Selenium tiene algunas limiaciones y por tanto en ocasiones nos toca ejecutar código directamente en javascript para poder hacer una acción que necesitamos, en este sesión cambiaremos una propiedad de un locator por medio de javascript ya que selenium no es capaz de soportarlo nativamente.

  1. Cree el archivo de prueba i-frame.spec.ts el cual abrirá la página http://toolsqa.com/iframe-practice-page/ modificará la áltura del IFrame 1, posteriormente obtendrá la nueva altura para comprobar si efectivamente cambio

  2. Cree el archivo page i-frame.page.ts el cual contendrá un método para modificar la altura de un IFrame y otro para obtener su altura

    import { $, browser, ElementFinder, promise } from 'protractor';

...

public setFormFrameHeight(height: number): promise.Promise<void> {
    return browser.executeScript(`arguments[0].height = ${height};`, this.iframe1);
}

21. Trabajando con IFrames

Descripción: Los IFrames aunque ya están mandados a recoger, en ocasiones no los encontramos en algunas páginas, y no está de más saber cómo trabajar con ellos cuando nos los encontremos. En esta sesión entraremos a un iframe, haremos acciones sobre el, saldremos de él y haremos otras acciones sobre la página principal

  1. Modificar el page i-frame.page.ts de tal forma que publique:

    • un método que retorne el título de la página de valor Sample Iframe page
    • un método para pasarse al iframe 1
    public async switchToFrame(): Promise<void> {
    await browser.switchTo().frame(this.frame.getWebElement());
}
    • otro método para regresar al contexto principal
    public async switchToMainPage(): Promise<void> {
    await browser.switchTo().defaultContent();
}

  2. Modificar la prueba i-frame.spec.ts de tal forma que verifique el título principal

  3. Modificar la prueba i-frame.spec.ts de tal forma que se cambie al iframe 1 y verifique el título

  4. Modificar la prueba i-frame.spec.ts de tal forma que se cambie al contexto principal y verifique nuevamente el título

22. Subiendo un Archivo

Descripción: En esta sesión se automatizará una prueba donde se deba subir un archivo.

  1. Modificar el page personal-information.page.ts de tal forma que el método fillForm ahora no haga clic en el botón y cree otro método submit que llene el formulario y haga clic en el botón
  2. También debe recibir dentro del json un parámetro file que tiene la ruta relativa de algún archivo a subir, si tiene un valor válido debe subir el archivo
  3. Cree la carpeta resources a nivel de la raíz del proyecto y coloque un archivo jpg en ella
  4. Modificar locators.spec.ts de tal forma que se le pase la ruta de la imagen que puso en resources
  5. Agregue una validación el locators.spec.ts que verifique la imagen fue cargada

23. Descargando Archivos

Descripción: En esta sesión se automatizará una prueba donde se deba descargar un archivo

  1. Modificar el page personal-information.page.ts de tal forma que si recibe el parámetro downloadFile dentro del JSON llame al método privado download de ese mismo pageobject
  2. El método download obtendrá el link del enlace "Test File to Download" y se lo pasará al método downloadFile que recibe dos parametros de entrada el link de descarga y el nombre del archivo con que se quiere guardar

  3. Crear la carpeta service dentro de src y crear dentro un archivo llamado download.service.ts que tendrá dos métodos públicos

    public async downloadFile(link: string, filename): Promise<void>

    Este método obtendrá la información del link y lo guardará en una carpeta temp a nivel raíz del proyecto con el nombre indicado

    public readFileFromTemp(filename: string): Buffer

    Recibirá el nombre del archivo y devolverá el buffer que contiene la información del archivo

  4. Modificar la prueba de tal forma que descargue el archivo y después comprobar que descargó de forma correcta

24. Configurar Saucelabs

Descripción: Ejecutar en modo headless no siempre es la mejor opción, existen herramientas de pago como Saucelabs que nos provisionan diferentes sistemas operativos y diferentes navegadores, en esta sesión configuraremos saucelabs para ejecutar nuestras pruebas.

Ya que nuestras pruebas se ejecutarán en un servidor de integración sin interfaz gráfica, debemos utilizar servicios externos para la ejecución en browsers reales. En este caso utilizaremos saucelabs.

  1. Crear una cuenta en SauceLabs

  2. Una vez creada la cuenta, ir a la opción de User Settings

    Saucelabs user settings

  3. Ir a la sección de Access Key y dar click en show. Esto pedirá el password para mostrar el access key. Una vez lo acceda, cópielo al portapapeles y guárdelo en un lugar seguro

    Saucelabs access key

  4. Adicione al archivo package.json el script test:saucelabs y haga que este se corra cuando se ejecute el script de test

    "test:saucelabs": "npm run build && protractor dist/protractor/saucelabs.config.js",
"test": "npm run test:saucelabs"

  5. Duplique el archivo protractor/local.config.ts con el nombre protractor/saucelabs.config.ts

  6. Adicione las siguientes propiedades protractor/saucelabs.config.ts:

    • sauceUser: tendrá el valor del user name de saucelabs (se obtendrá por variable de ambiente)
    • sauceKey: tendrá el valor del key de saucelabs copiado en el punto 3 (se obtendrá por variable de ambiente)
    • Capabilities.name: nombre de la ejecución del job en saucelabs
    // ...

export let config: Config = {
  // ...
  sauceUser: process.env.SAUCE_USERNAME,
  sauceKey: process.env.SAUCE_ACCESS_KEY
};
    // ...
capabilities: {
  name: 'UI Workshop',
  browserName: 'chrome',
  chromeOptions: {
    args: ['--disable-popup-blocking', '--no-default-browser-check', '--window-size=800,600'],
    prefs: { credentials_enable_service: false }
  }
},
// ...

  7. Una vez configurado esto, en la consola asigne los valores para SAUCE_USERNAME y SAUCE_ACCESS_KEY, con los valores del registro en saucelabs

    export SAUCE_USERNAME='sauce-username'
export SAUCE_ACCESS_KEY='sauce-keu'

  8. Ejecute la prueba npm test

  9. Esto lanzará la ejecución directamente en saucelabs y se puede visualizar de la siguiente forma: http://recordit.co/pIAXMQShQJ

  10. Para que travis tome correctamente el SAUCE_ACCESS_KEY se debe configurar la variable de forma encriptada

    travis encrypt SAUCE_USERNAME=el-usuario --add --com
travis encrypt SAUCE_ACCESS_KEY=el-key --add --com

    Nota 1: Si recibe un mensaje de error similar a repository not known to https://api.travis-ci.org/: owner/repo Inicie sesión usando el comando travis login --com, se le solicitara ingresar su usuario y contraseña de Travis Nota 2: Si no desea instalar el cliente de travis puede utilizar docker de la siguiente forma:

    docker run -v $(pwd):/usr/src/app -it ruby /bin/bash
gem install travis -v 1.8.9 --no-rdoc --no-ri
echo 'y' | travis -v
cd /usr/src/app
travis encrypt SAUCE_USERNAME=el-usuario --add --com
travis encrypt SAUCE_ACCESS_KEY=el-key --add --com

Sugerencias

25. Probar con diferentes navegadores

Descripción: Nuestros productos generalmente deben ser verificados en más de un navegador, por tanto es importante saber cómo ejecutar nuestras pruebas en varios navegadores.

  1. Necesitaremos editar el archivo protractor/saucelabs.config.ts, con los siguientes valoresCambiar capabilities por multiCapabilities

    • multiCapabilities: contiene la configuración de varios navegadores en un mismo config file
    import { browser, Config } from 'protractor';
import { reporter } from './helpers/reporter';

const firefoxConfig = {
  browserName: 'firefox',
  platform: 'linux',
  name: 'firefox-tests',
  shardTestFiles: true,
  maxInstances: 1
};

const chromeConfig = {
  browserName: 'chrome',
  name: 'chrome-tests',
  shardTestFiles: true,
  maxInstances: 1
};

const multiCapabilities = [chromeConfig, firefoxConfig];

export let config: Config = {
  multiCapabilities,
  // ...
};

  2. Ejecute las pruebas y en el PR suba la imagen que muestre que esta corriendo en diferentes navegadores Saucelabs Multibrowser execution

Sugerencias para brobar con diferentes navegadores

26. Zalenium

Descripción: En ocasiones requerimos ejecutar nuestras pruebas en nuestro ambiente local o en un servidor de integración continua pero no tenemos los recursos suficientes para pagar todas las ejecuiones que se requieren en servicios como Saucelabs, o simplemente no queremos instalar ciertos navegadores en nuestro equipo ya que nos puede afectar nuestro ambiente de trabajo. Zalenium nos permite ejecutar nuestras pruebas dentro de containers si cumplen ciertos requerimientos y el resto mandarlo a Saucelabs de esa forma no tenemos que hacer configuraciones adicionales y tampoco incurrir a facturas muy grandes

  1. Descargue la imagen de docker elgalu/selenium

    docker pull elgalu/selenium

  2. Descargue la imagen de zalenium

    docker pull dosel/zalenium

    Nota 1: Si recibe un mensaje de error similar a Error response from daemon: Get https://registry-1.docker.io/v2/: unauthorized:incorrect username or password Inicie sesión usando el comando echo "YOUR_DOCKER_PASSWORD" | docker login --username YOUR_DOCKER_USERNAME --password-stdin

  3. Ejecute el contenedor de zalenium

    docker run --rm -ti --name zalenium -p 4444:4444 \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -v /tmp/videos:/home/seluser/videos \
    --privileged dosel/zalenium start

  4. Duplicar el archivo de saucelabs.config.ts y llamarlo zalenium.config.ts

  5. Configure el archivo de zalenium para que apunte al servidor de Grid de Zalenium

    seleniumAddress: 'http://localhost:4444/wd/hub'

  6. Abrá la página http://localhost:4444/grid/admin/live

  7. Remueva del package.json la instrucción del --gecko false en el script del postinstall

  8. Agregue el script de test:zaleniumen el package.json

  9. Ejecute el comando npx webdriver-manager update

  10. Ejecute las pruebas con npm run test:zalenium y vea como en la página de live se refresca la ejecución de las pruebas

  11. Abrá la página http://localhost:4444/dashboard y tome un screenshot del resultado de las pruebas y lo adjunta al PR