Diferencia entre revisiones de «Selenium con DSL»

De Dos Ideas.
Saltar a: navegación, buscar
(→‎Ejemplo)
(→‎Creando un test)
 
(No se muestran 13 ediciones intermedias de 3 usuarios)
Línea 3: Línea 3:
  
 
== Ejemplo ==
 
== Ejemplo ==
 +
A continuación mostramos una propuesta de como encarar un test de [[Selenium]]con [[DSL]]. Para el ejemplo, suponemos un sistema de biblioteca, con las siguientes pantallas y su navegación.
 +
Se puede observar que pare este sistemas planteamos dos roles de usuario, el Bibliotecario y el Socio.
  
−
A continuación mostramos una propuesta de como encarar un test de [[Selenium]] con [[DSL]]. Para el ejemplo, suponemos una aplicación con seguridad, usuarios con diferentes Roles, y diferentes pantallas:
+
[[Archivo:reservaLibro.jpg]]
  
 +
=== Creando un test ===
 +
En el siguiente test, vamos a probar la funcionalidad de la reserva de libro.
 +
Para escribir el siguiente test, se utilizó una sintaxis acotada y simple con las siguientes reglas:
 +
 +
* '''ir'''''<NombreDeLaPagina>'': Los métodos que comiencen con el prefijo “ir”, nos retorna el nuevo contexto (página).
 +
* '''verificar'''''<Descripción>'':  Los métodos que comiencen con el prefijo "verificar", poseen los "assert" para comprobar alguna acción realizada en la página, este método siempre retona la misma página (this).
 +
* '''ingresarComo'''''<Nombre del Rol>'': Rol con el que se probará el sistema.
 +
* '''aceptar, cancelar, volver, buscar''': Son nombre de las acciones básica que se realizan en un página y pueden (o nó) devolver otra página.
 +
* ''<acciones propias de la página>'' : Estos métodos realizan acciones sobre el sistema sin ir a otra página. Ej.: reservar
 +
 +
 +
==== ReservaSeleniumDslTest ====
 
<code java>
 
<code java>
−
package com.test;
+
package com.test.dsl;
−
 
 
−
import static org.junit.Assert.fail;
 
  
 
import org.junit.AfterClass;
 
import org.junit.AfterClass;
 +
import org.junit.Assert;
 
import org.junit.BeforeClass;
 
import org.junit.BeforeClass;
 
import org.junit.Test;
 
import org.junit.Test;
  
−
import com.test.selenium.dsl.Usuario;
 
−
 
−
public class AltaDenunciaSeleniumTest {
 
  
 +
public class ReservaSeleniumDslTest {
 
      
 
      
 
     @BeforeClass
 
     @BeforeClass
Línea 24: Línea 35:
 
         Usuario.inicializar();
 
         Usuario.inicializar();
 
     }
 
     }
−
 
+
 
     @AfterClass
 
     @AfterClass
 
     public static void tearDownClass() throws Exception {
 
     public static void tearDownClass() throws Exception {
 
         Usuario.finalizar();
 
         Usuario.finalizar();
 
     }
 
     }
−
   
+
 
     @Test
 
     @Test
−
     public void ingresarConRolAdministrativo_SeDaDeAltaUnaDenuncia() {
+
     public void comoBibliotecarioQuieroRealizarUnaReserva() {
−
         Usuario.ingresarComoAdministrativo()
+
         Usuario.ingresaComoBibliotecario()
−
         .irAingresarDenuncia()
+
         .irReservaDeLibro()
−
         .completarDenuncia()
+
         .reservar()
 +
        .aceptar()
 +
        .verificarReserva()
 
         .aceptar()
 
         .aceptar()
−
        .verificarFinalizacionSinErrores()
 
 
         .salir();
 
         .salir();
 +
    }   
 +
}
 +
</code>
 +
 +
De esta forma, escribimos el test de manera que al leer los métodos a los que se invoca, se entiende paso a paso lo que el test realiza, sin confundirnos con la implementación. Utilizando los patrones "method chaining" ,  "builder", "Page object" ayuda a realizar una abstracción de la implementación.
 +
 +
Si lo hubieramos realizado solo con selenium, el mismo test quedaría de la siguiente forma:
 +
 +
==== ReservaSeleniumTest ====
 +
 +
<code java>
 +
    @Test
 +
    public void comoBibliotecarioQuieroRealizarUnaReserva() {
 +
        //Ingresar
 +
        selenium.open("");
 +
        selenium.waitForPageToLoad(TIEMPO_ESPERA);
 +
        selenium.type("username", username);
 +
        selenium.type("password", password);
 +
        selenium.click("submitbutton");
 +
        selenium.waitForPageToLoad(TIEMPO_ESPERA);
 +
        //ir Pagina reserva de Libro
 +
        selenium.click("link=ReservaLibro");
 +
        selenium.waitForPageToLoad(Usuario.TIEMPO_ESPERA);
 +
        //reservar
 +
        selenium.type("libro", "El señor de los anillos");
 +
        selenium.type("codSocio", "0001");
 +
        selenium.type("fechaHasta", "2011-01-01");
 +
        //Aceptar       
 +
        selenium.click("submitbutton");
 +
        selenium.waitForPageToLoad(TIEMPO_ESPERA)
 +
        //verficiar
 +
        Assert.assertTrue(selenium.isTextPresent("El señor de los anillos"));
 +
        Assert.assertTrue(selenium.isTextPresent("0001"));
 +
        Assert.assertTrue(selenium.isTextPresent("2011-01-01"));
 +
        //aceptar para volver a la home
 +
        selenium.click("submitbutton");
 +
        selenium.waitForPageToLoad(TIEMPO_ESPERA)
 +
        //salir
 +
        selenium.click("link=logout");     
 +
}   
 +
</code>
 +
 +
 +
A continuación  las implementaciones de las clases utilizadas en el test.
 +
 +
==== Usuario ====
 +
 +
<code java>
 +
package com.test.dsl;
 +
 +
import org.openqa.selenium.server.SeleniumServer;
 +
 +
import com.test.dsl.pagina.HomeBibliotecario;
 +
import com.test.dsl.pagina.HomeUsuario;
 +
import com.thoughtworks.selenium.DefaultSelenium;
 +
import com.thoughtworks.selenium.Selenium;
 +
 +
public class Usuario {
 +
 +
    public static final String TIEMPO_ESPERA = "90000";
 +
    public static final String VELOCIDAD_CERO = "0";
 +
    public static final String VELOCIDAD_TEST = "350";
 +
   
 +
    private static SeleniumServer seleniumServer;
 +
    private static Selenium selenium ;
 +
 +
   
 +
    public static void inicializar() throws Exception {
 +
        seleniumServer = new SeleniumServer();
 +
        seleniumServer.start();
 +
        selenium = new DefaultSelenium("localhost", 4444, "*chrome", "http://localhost:8585/");
 +
        selenium.start();
 +
    }
 +
 +
    public static void finalizar() {
 +
        selenium.stop();
 +
        seleniumServer.stop();
 +
    }
 +
 +
    public static HomeBibliotecario ingresaComoBibliotecario() {
 +
        Usuario.login("bibliotecario_test","123456");
 +
        return new HomeBibliotecario(selenium);     
 +
    }
 +
   
 +
    public static HomeUsuario ingresaComoUsuario() {
 +
        Usuario.login("usuario_test","123456");
 +
        return new HomeUsuario(selenium);     
 +
    }
 +
   
 +
    private static void login(String username, String password) {
 +
        selenium.open("");
 +
        selenium.waitForPageToLoad(TIEMPO_ESPERA);
 +
        selenium.type("username", username);
 +
        selenium.type("password", password);
 +
        selenium.click("submitbutton");
 +
        selenium.waitForPageToLoad(TIEMPO_ESPERA);
 +
 
     }
 
     }
 
}
 
}
  
−
</code java>
+
</code>
 +
 
 +
Esta clase es la que determina con que rol vamos a probar la aplicación.
 +
El método '''ingresarComoBibliotecario''' instancia y devuelve un objeto de la clase '''HomeBibliotecario''' cuya implementación es:
 +
 
 +
==== HomeBibliotecario ====
 +
<code java>
 +
package com.test.dsl.pagina;
 +
 
 +
import com.test.dsl.Usuario;
 +
import com.thoughtworks.selenium.Selenium;
 +
 
 +
public class HomeBibliotecario {
 +
   
 +
    private Selenium selenium;
 +
 
 +
    public HomeBibliotecario(Selenium selenium) {
 +
      this.selenium = selenium;
 +
    }
 +
 
 +
    public ReservaDeLibro irReservaDeLibro() {
 +
        selenium.click("link=ReservaLibro");
 +
        selenium.waitForPageToLoad(Usuario.TIEMPO_ESPERA);
 +
        return new ReservaDeLibro(selenium);
 +
    }
 +
 
 +
    public void salir() {
 +
        selenium.click("link=logout");       
 +
    }
 +
}
 +
</code>
 +
 
 +
Volvemos a utilizar el patrón builder y el método ingresar denuncia devuelve un objeto de la clase AltaDenuncia. De esta manera, cada clase representa a una pantalla de la aplicación, y expone cada funcionalidad que la misma ofrece. AltaDenuncia sería así:
 +
Volvemos a utilizar el patrón method chaining y el método '''irReservaDeLibro''' devuelve un objeto de la clase '''ReservaDeLibro'''. De esta manera, cada clase representa a una pantalla de la aplicación (page object), y expone cada funcionalidad que la misma ofrece (acciones que puedo realizar en la página y páginas a la que puedo acceder)
 +
 
 +
==== ReservaDeLibro ==== 
 +
<code java>
 +
package com.test.dsl.pagina;
 +
 
 +
import com.test.dsl.Usuario;
 +
import com.thoughtworks.selenium.Selenium;
 +
 
 +
public class ReservaDeLibro {
 +
 
 +
    private Selenium selenium;
 +
 
 +
    public ReservaDeLibro(Selenium selenium) {
 +
      this.selenium = selenium;
 +
    }
 +
 
 +
    public ReservaDeLibro reservar() {
 +
        selenium.type("libro", "El señor de los anillos");
 +
        selenium.type("codSocio", "0001");
 +
        selenium.type("fechaHasta", "2011-01-01");
 +
        return this;
 +
    }
 +
 
 +
    public ComprobanteDeLibro aceptar() {
 +
        selenium.click("submitbutton");
 +
        selenium.waitForPageToLoad(Usuario.TIEMPO_ESPERA);
 +
        return new ComprobanteDeLibro(selenium);
 +
    } 
 +
}
 +
</code>
 +
 
 +
==== ComprobanteDeLibro ==== 
 +
<code java>
 +
package com.test.dsl.pagina;
 +
 
 +
import org.junit.Assert;
 +
 
 +
import com.test.dsl.Usuario;
 +
import com.thoughtworks.selenium.Selenium;
 +
 
 +
public class ComprobanteDeLibro {
 +
    private Selenium selenium;
 +
 
 +
    public ComprobanteDeLibro(Selenium selenium) {
 +
      this.selenium = selenium;
 +
    }
 +
 
 +
    public ComprobanteDeLibro verificarReserva() {
 +
        Assert.assertTrue(selenium.isTextPresent("El señor de los anillos"));
 +
        Assert.assertTrue(selenium.isTextPresent("0001"));
 +
        Assert.assertTrue(selenium.isTextPresent("2011-01-01"));
 +
        return this;
 +
    }
 +
   
 +
    public HomeBibliotecario aceptar() {
 +
        selenium.click("submitbutton");
 +
        selenium.waitForPageToLoad(Usuario.TIEMPO_ESPERA);
 +
        return new HomeBibliotecario(selenium);
 +
    }
 +
}
 +
 
 +
</code>
 +
 
 +
Tanto el  aceptar (como el cancelar en ReservaDeLibro), devuelven la home del bibliotecario.
 +
 
 +
== Conclusiones ==
 +
 
 +
El resultado de hacer los test de esta manera, es la facilidad de escritura y mantenimiento del test en si mismo. A su vez, se podría diseñar las clases a utilizar en el DSL a conveniencia.
 +
 
 +
== Enlaces ==
 +
[[DSL]]
 +
 
 +
[[Selenium]]
 +
 
 +
[http://code.google.com/p/selenium/wiki/PageObjects Page Objects]
 +
 
 +
[http://www.slideshare.net/alimenkou/dsl-page-object-and-selenium-a-way-to-reliable-functional-tests Diapositiva de Dsl+Page Object + Selenium]

Revisión actual del 13:06 29 abr 2011

Selenium es una herramienta para pruebas de aplicaciones web. Quién tuvo la posibilidad de utilizarla, sabrá lo poderosa que es la herramienta, la cuál tiene diversas funciones para ejecutar con nuestra aplicación web. Puede ocurrir, que nuestros test de Selenium se vayan complejizando a medida que nuestra aplicación crece, por lo que esta es una posible solución, combinando el poder de Selenium con un enfoque DSL.

Ejemplo

A continuación mostramos una propuesta de como encarar un test de Seleniumcon DSL. Para el ejemplo, suponemos un sistema de biblioteca, con las siguientes pantallas y su navegación. Se puede observar que pare este sistemas planteamos dos roles de usuario, el Bibliotecario y el Socio.

ReservaLibro.jpg

Creando un test

En el siguiente test, vamos a probar la funcionalidad de la reserva de libro. Para escribir el siguiente test, se utilizó una sintaxis acotada y simple con las siguientes reglas:

  • ir<NombreDeLaPagina>: Los métodos que comiencen con el prefijo “ir”, nos retorna el nuevo contexto (página).
  • verificar<Descripción>: Los métodos que comiencen con el prefijo "verificar", poseen los "assert" para comprobar alguna acción realizada en la página, este método siempre retona la misma página (this).
  • ingresarComo<Nombre del Rol>: Rol con el que se probará el sistema.
  • aceptar, cancelar, volver, buscar: Son nombre de las acciones básica que se realizan en un página y pueden (o nó) devolver otra página.
  • <acciones propias de la página> : Estos métodos realizan acciones sobre el sistema sin ir a otra página. Ej.: reservar


ReservaSeleniumDslTest

package com.test.dsl;

import org.junit.AfterClass; import org.junit.Assert; import org.junit.BeforeClass; import org.junit.Test;


public class ReservaSeleniumDslTest { 

   @BeforeClass
   public static void setUpClass() throws Exception {
       Usuario.inicializar();
   }

   @AfterClass
   public static void tearDownClass() throws Exception {
       Usuario.finalizar();
   }

   @Test
   public void comoBibliotecarioQuieroRealizarUnaReserva() {
       Usuario.ingresaComoBibliotecario()
       .irReservaDeLibro()
       .reservar()
       .aceptar()
       .verificarReserva()
       .aceptar()
       .salir();
   }

}

De esta forma, escribimos el test de manera que al leer los métodos a los que se invoca, se entiende paso a paso lo que el test realiza, sin confundirnos con la implementación. Utilizando los patrones "method chaining" , "builder", "Page object" ayuda a realizar una abstracción de la implementación.

Si lo hubieramos realizado solo con selenium, el mismo test quedaría de la siguiente forma:

ReservaSeleniumTest

   @Test
   public void comoBibliotecarioQuieroRealizarUnaReserva() {
       //Ingresar
       selenium.open("");
       selenium.waitForPageToLoad(TIEMPO_ESPERA);
       selenium.type("username", username);
       selenium.type("password", password);
       selenium.click("submitbutton");
       selenium.waitForPageToLoad(TIEMPO_ESPERA);
       //ir Pagina reserva de Libro
       selenium.click("link=ReservaLibro");
       selenium.waitForPageToLoad(Usuario.TIEMPO_ESPERA);
       //reservar
       selenium.type("libro", "El señor de los anillos");
       selenium.type("codSocio", "0001");
       selenium.type("fechaHasta", "2011-01-01");
       //Aceptar        
       selenium.click("submitbutton");
       selenium.waitForPageToLoad(TIEMPO_ESPERA)
       //verficiar
       Assert.assertTrue(selenium.isTextPresent("El señor de los anillos"));
       Assert.assertTrue(selenium.isTextPresent("0001"));
       Assert.assertTrue(selenium.isTextPresent("2011-01-01"));
       //aceptar para volver a la home
       selenium.click("submitbutton");
       selenium.waitForPageToLoad(TIEMPO_ESPERA)
       //salir
       selenium.click("link=logout");      
}


A continuación las implementaciones de las clases utilizadas en el test.

Usuario

package com.test.dsl;

import org.openqa.selenium.server.SeleniumServer;

import com.test.dsl.pagina.HomeBibliotecario; import com.test.dsl.pagina.HomeUsuario; import com.thoughtworks.selenium.DefaultSelenium; import com.thoughtworks.selenium.Selenium;

public class Usuario { 

   public static final String TIEMPO_ESPERA = "90000";
   public static final String VELOCIDAD_CERO = "0";
   public static final String VELOCIDAD_TEST = "350";
   
   private static SeleniumServer seleniumServer;
   private static Selenium selenium ;



   public static void inicializar() throws Exception {
       seleniumServer = new SeleniumServer();
       seleniumServer.start();
       selenium = new DefaultSelenium("localhost", 4444, "*chrome", "http://localhost:8585/");
       selenium.start();
   }

   public static void finalizar() {
       selenium.stop();
       seleniumServer.stop();
   }

   public static HomeBibliotecario ingresaComoBibliotecario() {
       Usuario.login("bibliotecario_test","123456");
       return new HomeBibliotecario(selenium);       
   }
   
   public static HomeUsuario ingresaComoUsuario() {
       Usuario.login("usuario_test","123456");
       return new HomeUsuario(selenium);       
   }
   
   private static void login(String username, String password) {
       selenium.open("");
       selenium.waitForPageToLoad(TIEMPO_ESPERA);
       selenium.type("username", username);
       selenium.type("password", password);
       selenium.click("submitbutton");
       selenium.waitForPageToLoad(TIEMPO_ESPERA);

   }

}

Esta clase es la que determina con que rol vamos a probar la aplicación. El método ingresarComoBibliotecario instancia y devuelve un objeto de la clase HomeBibliotecario cuya implementación es:

HomeBibliotecario

package com.test.dsl.pagina;

import com.test.dsl.Usuario; import com.thoughtworks.selenium.Selenium;

public class HomeBibliotecario { 

   private Selenium selenium;

   public HomeBibliotecario(Selenium selenium) {
      this.selenium = selenium;
   }

   public ReservaDeLibro irReservaDeLibro() {
       selenium.click("link=ReservaLibro");
       selenium.waitForPageToLoad(Usuario.TIEMPO_ESPERA);
       return new ReservaDeLibro(selenium);
   }

   public void salir() {
       selenium.click("link=logout");        
   }

}

Volvemos a utilizar el patrón builder y el método ingresar denuncia devuelve un objeto de la clase AltaDenuncia. De esta manera, cada clase representa a una pantalla de la aplicación, y expone cada funcionalidad que la misma ofrece. AltaDenuncia sería así: Volvemos a utilizar el patrón method chaining y el método irReservaDeLibro devuelve un objeto de la clase ReservaDeLibro. De esta manera, cada clase representa a una pantalla de la aplicación (page object), y expone cada funcionalidad que la misma ofrece (acciones que puedo realizar en la página y páginas a la que puedo acceder)

ReservaDeLibro

package com.test.dsl.pagina;

import com.test.dsl.Usuario; import com.thoughtworks.selenium.Selenium;

public class ReservaDeLibro { 

   private Selenium selenium;

   public ReservaDeLibro(Selenium selenium) {
      this.selenium = selenium;
   }

   public ReservaDeLibro reservar() {
       selenium.type("libro", "El señor de los anillos");
       selenium.type("codSocio", "0001");
       selenium.type("fechaHasta", "2011-01-01");
       return this;
   }

   public ComprobanteDeLibro aceptar() {
       selenium.click("submitbutton");
       selenium.waitForPageToLoad(Usuario.TIEMPO_ESPERA);
       return new ComprobanteDeLibro(selenium);
   }

}

ComprobanteDeLibro

package com.test.dsl.pagina;

import org.junit.Assert;

import com.test.dsl.Usuario; import com.thoughtworks.selenium.Selenium;

public class ComprobanteDeLibro { 

   private Selenium selenium;

   public ComprobanteDeLibro(Selenium selenium) {
      this.selenium = selenium;
   }

   public ComprobanteDeLibro verificarReserva() {
       Assert.assertTrue(selenium.isTextPresent("El señor de los anillos"));
       Assert.assertTrue(selenium.isTextPresent("0001"));
       Assert.assertTrue(selenium.isTextPresent("2011-01-01"));
       return this;
   }
   
   public HomeBibliotecario aceptar() {
       selenium.click("submitbutton");
       selenium.waitForPageToLoad(Usuario.TIEMPO_ESPERA);
       return new HomeBibliotecario(selenium);
   }

}

Tanto el aceptar (como el cancelar en ReservaDeLibro), devuelven la home del bibliotecario.

Conclusiones

El resultado de hacer los test de esta manera, es la facilidad de escritura y mantenimiento del test en si mismo. A su vez, se podría diseñar las clases a utilizar en el DSL a conveniencia.

Enlaces

DSL

Selenium

Page Objects

Diapositiva de Dsl+Page Object + Selenium

Obtenido de «https://dosideas.com/wiki/index.php?title=Selenium_con_DSL&oldid=5760»