Diferencia entre revisiones de «Selenium con DSL»
(→Ejemplo) |
(→Creando un test) |
||
(No se muestran 8 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. | ||
− | + | [[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 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; | ||
− | |||
− | |||
− | |||
+ | 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 | + | public void comoBibliotecarioQuieroRealizarUnaReserva() { |
− | Usuario. | + | Usuario.ingresaComoBibliotecario() |
− | . | + | .irReservaDeLibro() |
− | . | + | .reservar() |
+ | .aceptar() | ||
+ | .verificarReserva() | ||
.aceptar() | .aceptar() | ||
− | |||
.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> | </code> | ||
− | + | ||
+ | A continuación las implementaciones de las clases utilizadas en el test. | ||
+ | |||
+ | ==== Usuario ==== | ||
<code java> | <code java> | ||
− | package com.test | + | package com.test.dsl; |
import org.openqa.selenium.server.SeleniumServer; | 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.DefaultSelenium; | ||
import com.thoughtworks.selenium.Selenium; | import com.thoughtworks.selenium.Selenium; | ||
− | |||
public class Usuario { | public class Usuario { | ||
− | + | ||
public static final String TIEMPO_ESPERA = "90000"; | public static final String TIEMPO_ESPERA = "90000"; | ||
public static final String VELOCIDAD_CERO = "0"; | public static final String VELOCIDAD_CERO = "0"; | ||
Línea 62: | Línea 115: | ||
private static SeleniumServer seleniumServer; | private static SeleniumServer seleniumServer; | ||
private static Selenium selenium ; | private static Selenium selenium ; | ||
+ | |||
public static void inicializar() throws Exception { | public static void inicializar() throws Exception { | ||
seleniumServer = new SeleniumServer(); | seleniumServer = new SeleniumServer(); | ||
seleniumServer.start(); | seleniumServer.start(); | ||
− | selenium = new DefaultSelenium( "localhost", 4444, "*chrome", "http://localhost:8585/"); | + | selenium = new DefaultSelenium("localhost", 4444, "*chrome", "http://localhost:8585/"); |
selenium.start(); | selenium.start(); | ||
} | } | ||
− | + | ||
− | |||
− | |||
− | |||
− | |||
− | |||
public static void finalizar() { | public static void finalizar() { | ||
selenium.stop(); | selenium.stop(); | ||
seleniumServer.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) { | + | private static void login(String username, String password) { |
− | |||
selenium.open(""); | selenium.open(""); | ||
selenium.waitForPageToLoad(TIEMPO_ESPERA); | selenium.waitForPageToLoad(TIEMPO_ESPERA); | ||
− | |||
− | |||
− | |||
− | |||
selenium.type("username", username); | selenium.type("username", username); | ||
+ | selenium.type("password", password); | ||
selenium.click("submitbutton"); | selenium.click("submitbutton"); | ||
selenium.waitForPageToLoad(TIEMPO_ESPERA); | selenium.waitForPageToLoad(TIEMPO_ESPERA); | ||
− | + | ||
− | |||
} | } | ||
− | |||
− | |||
} | } | ||
</code> | </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> | <code java> | ||
− | package com.test | + | package com.test.dsl.pagina; |
− | |||
− | |||
+ | import com.test.dsl.Usuario; | ||
import com.thoughtworks.selenium.Selenium; | import com.thoughtworks.selenium.Selenium; | ||
− | |||
− | public class | + | public class HomeBibliotecario { |
− | |||
private Selenium selenium; | private Selenium selenium; | ||
− | + | ||
− | public | + | public HomeBibliotecario(Selenium selenium) { |
− | + | this.selenium = selenium; | |
} | } | ||
− | + | ||
− | public | + | public ReservaDeLibro irReservaDeLibro() { |
− | selenium. | + | selenium.click("link=ReservaLibro"); |
− | |||
selenium.waitForPageToLoad(Usuario.TIEMPO_ESPERA); | selenium.waitForPageToLoad(Usuario.TIEMPO_ESPERA); | ||
− | + | return new ReservaDeLibro(selenium); | |
− | |||
− | |||
− | return new | ||
} | } | ||
− | + | ||
− | |||
public void salir() { | public void salir() { | ||
− | selenium. | + | 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 | + | public ReservaDeLibro reservar() { |
− | + | selenium.type("libro", "El señor de los anillos"); | |
+ | selenium.type("codSocio", "0001"); | ||
+ | selenium.type("fechaHasta", "2011-01-01"); | ||
return this; | return this; | ||
} | } | ||
+ | public ComprobanteDeLibro aceptar() { | ||
+ | selenium.click("submitbutton"); | ||
+ | selenium.waitForPageToLoad(Usuario.TIEMPO_ESPERA); | ||
+ | return new ComprobanteDeLibro(selenium); | ||
+ | } | ||
} | } | ||
− | |||
</code> | </code> | ||
− | + | ==== ComprobanteDeLibro ==== | |
+ | <code java> | ||
+ | package com.test.dsl.pagina; | ||
− | + | import org.junit.Assert; | |
− | |||
+ | import com.test.dsl.Usuario; | ||
import com.thoughtworks.selenium.Selenium; | import com.thoughtworks.selenium.Selenium; | ||
− | |||
− | public class | + | public class ComprobanteDeLibro { |
− | |||
− | |||
private Selenium selenium; | private Selenium selenium; | ||
− | + | ||
− | public | + | public ComprobanteDeLibro(Selenium selenium) { |
− | + | this.selenium = selenium; | |
} | } | ||
− | + | ||
− | public | + | 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; | return this; | ||
} | } | ||
− | public | + | public HomeBibliotecario aceptar() { |
− | + | selenium.click("submitbutton"); | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | selenium.click(" | ||
selenium.waitForPageToLoad(Usuario.TIEMPO_ESPERA); | selenium.waitForPageToLoad(Usuario.TIEMPO_ESPERA); | ||
− | + | return new HomeBibliotecario(selenium); | |
− | return new | ||
} | } | ||
− | |||
− | |||
} | } | ||
</code> | </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.
Contenido
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.
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.