Grabación de pruebas con Selenium y JUnit

Ejemplo 1: Busqueda en Google de la página oficial de Selenium

Descripción de la prueba

1. Abrir la página de Google
2. Escribir el valor a buscar
3. Pulsar sobre el botón de búsqueda y esperar
4. Pulsar sobre el resultado y esperar
5. Comprobar que es la página correcta

Grabación de la prueba con Selenium IDE

1. Abrir la página de Google: el comando grabado es un “open” que lo que tiene como parámetro es la dirección de la página que se desea abrir.
2. Escribir el valor a buscar: a continuación, una vez abierta la página, se localiza el campo donde hay que introducir el texto, en este caso a través de “//input[@name='q']”, lo que indica que es un tipo “input” cuyo nombre es 'q'. A este elemento se le hace un “type” y se fija el texto que se quiere buscar, “selenium”.
3. Pulsar sobre el botón de búsqueda y esperar: pulsa sobre el botón “Buscar con Google”, en este caso identificado por “input[@name='btnG']”, y espera a que la página se cargue completamente con el “clickAndWait”
4. Pulsar sobre el resultado y esperar: Ahora pulsa sobre un link que contenga el texto “Selenium web application testing system” y espera a la carga de la página.
5. Comprobar que es la página correcta: para comprobar que la página es la deseada, se verifica con “assertTittle” si el título de la página es el esperado.

Exportar la prueba a Junit

El resultado tras haber exportado la prueba, haber cambiado la declaración sobre el paquete y el nombre de la clase para que sea más claro, y haber cambiado el nombre del método generado, es el siguiente:

package selenium.ejemplos.utilidades;

public final class Constantes{
    // Constantes generales
    public static final String NAVEGADOR = "*firefox";

    // Constantes de la pantalla del buscador de Google
    public static final String URL_GOOGLE = "http://www.google.es/";
    public static final String CAMPO_BUSQUEDA = "//input[@name='q']";
    public static final String BTN_BUSCAR = "//input[@name='btnG']";
    public static final String TXT_SELENIUM = "selenium";
    public static final String LNK_SELENIUM = "link=Selenium web application
                                                 testing system";

    // Constantes de la ventana de Selenium
    public static final String TITULO_PANTALLA = "Selenium web application
                                                    testing system";
}
Clase con constantes

Además toda clase haga uso de Selenium debe extender de la clase SeleneseTestCase. Ésta contiene el objeto “selenium” que es el que da acceso a todas las funciones que ofrece para realizar las pruebas:

package selenium.ejemplos;

import com.thoughtworks.selenium.*;
import java.util.regex.Pattern;
import selenium.ejemplos.utilidades.Constantes;

public class Ejemplo1 extends SeleneseTestCase {

    public void setUp() throws Exception {
        setUp(Constantes.URL_GOOGLE , Constantes.NAVEGADOR);
    }

    public void testBuscaEnGoogleSelenium() throws Exception {
        selenium.open(Constantes.URL_GOOGLE);
        selenium.type(Constantes.CAMPO_BUSQUEDA, Constantes.TXT_SELENIUM);
        selenium.click(Constantes.BTN_BUSCAR);
        selenium.waitForPageToLoad("30000");
        selenium.click(Constantes.LNK_SELENIUM);
        selenium.waitForPageToLoad("30000");
        assertEquals(Constantes.TITULO_PANTALLA , selenium.getTitle());
    }
}
Texto 2: Clase con la prueba

Ejecución de la prueba

Para ejecutar esta prueba desde eclipse solo habría que lanzarla como prueba JUnit a través del menú “Ejecutar como / test JUnit”, o incluyéndola como un test más en un Test Suite.

Ejemplo 2: Buscar en la página de Selenium información sobre los comandos

Descripción de la prueba

Este ejemplo amplia al anterior haciendo que una vez se encuentre en Google la página principal de Selenium, se interactúe con ella, en este caso se va a ir a la parte de documentación y va a mostrar la información de los comandos de Selenium.

Grabación de la prueba con Selenium IDE

Como los pasos para realizar la búsqueda en Google ya se tienen en el ejemplo anterior, sólo se debe que grabar en Selenium IDE los pasos para buscar la documentación en la página principal de Selenium.

Exportar la prueba a Junit

El resultado tras haber exportado la prueba es el siguiente:

package selenium.ejemplos.utilidades;

public final class Constantes {
    // Constantes generales
    public static final String NAVEGADOR = "*firefox";

    // Constantes de la pantalla del buscador de Google
    public static final String URL_GOOGLE = "http://www.google.es/";
    public static final String CAMPO_BUSQUEDA = "//input[@name='q']";
    public static final String BTN_BUSCAR = "//input[@name='btnG']";
    public static final String TXT_SELENIUM = "selenium";
    public static final String LNK_SELENIUM = "link=Selenium web application
                                                 testing system";

    // Constantes de la ventana de Selenium
    public static final String TITULO_PANTALLA = "Selenium web application
                                                    testing system";
    public static final String LNK_DOCUMENTACION = "link=Documentation";
    public static final String TXT_DOCUMENTACION = "Selenium Documentation";
    public static final String LNK_COMANDOS = "link=Selenium Commands";
    public static final String TIT_COMANDOS = "Selenium Commands — Selenium
                                                 Documentation";
}
Texto 3: Clase con constantes ampliada

En la clase principal que controla la prueba es “testBuscaEnGoogleYSelenium”, se ha usado el log de la aplicación para meter indicaciones al comenzar y al terminar cada prueba, para poder llevar un control de las mismas y poder saber cuáles se ejecutan correctamente y cuáles son las que fallan.

package selenium.ejemplos;

import com.thoughtworks.selenium.*;
import java.util.regex.Pattern;
import selenium.ejemplos.utilidades.Constantes;
import org.apache.log4j.Logger;

public class Ejemplo2 extends SeleneseTestCase {
    private static final Logger LOGGER = Logger.getLogger(Ejemplo2.class);

    public void setUp() throws Exception {
        setUp(Constantes.URL_GOOGLE , Constantes.NAVEGADOR);
    }

    public void testBuscaEnGoogleYSelenium() throws Exception {
        boolean continuar = true;
        if(continuar){
            LOGGER.info("Inicio la prueba de búsqueda en Google");
            // Llamamos a la primera prueba y guardamos el valor devuelto
            continuar = buscaEnGoogle();
            LOGGER.info("Ejecutada la prueba de búsqueda en Google");
        }
        // Si el valor devuelto por la prueba anterior indica que podemos 
        // seguir, lanzamos la siguiente prueba y guardamos el valor devuelto
        if(continuar){
            LOGGER.info("Inicio la prueba de búsqueda en Selenium");
            continuar = buscaEnSelenium();
            LOGGER.info("Ejecutada la prueba de búsqueda en Selenium");
        }
    }

    protected boolean buscaEnGoogle() throws Exception {
        selenium.open(Constantes.URL_GOOGLE);
        selenium.type(Constantes.CAMPO_BUSQUEDA, Constantes.TXT_SELENIUM);
        selenium.click(Constantes.BTN_BUSCAR);
        selenium.waitForPageToLoad("30000");
        selenium.click(Constantes.LNK_SELENIUM);
        selenium.waitForPageToLoad("30000");
        return Constantes.TITULO_PANTALLA.equals(selenium.getTitle());
    }

    protected boolean buscaEnSelenium() throws Exception {
        selenium.click(Constantes.LNK_DOCUMENTACION );
        selenium.waitForPageToLoad("30000");
        assertTrue(selenium.isTextPresent(Constantes.TXT_DOCUMENTACION));
        selenium.click(Constantes.LNK_COMANDOS );
        selenium.waitForPageToLoad("30000");
        return Constantes.TIT_COMANDOS.equals(selenium.getTitle());
    }
}
Texto 4: Clase con la prueba de busqueda en selenium

Ejecución de la prueba

Para ejecutar esta prueba desde eclipse solo habría que lanzarla como prueba JUnit a través del menú “Ejecutar como / test JUnit”, o incluyéndola como un test más en un Test Suite.

Ejemplo 3: Definición de un Test Suite

Descripción de la prueba

Se han visto ejemplos de cómo crear casos de pruebas, a continuación se muestra cómo crear un Test Suite que los llame a todos y así, con una simple ejecución se podrá lanzar toda una batería de pruebas automatizadas.

Grabación de la prueba con Selenium IDE

Consiste en la grabar los dos ejemplos anteriores.

Exportar la prueba a Junit

Se crea un objeto de tipo “TestSuite” con una descripción adecuada, y se añaden todas las clases que contienen los tests que se van a ejecutar:

package selenium.ejemplos;

import junit.framework.Test;
import junit.framework.TestSuite;

public class TodosLosTests {

    public static Test suite() {
        TestSuite suite = new TestSuite("Conjunto de pruebas de ejemplo");

        suite.addTestSuite(Ejemplo1.class);
        suite.addTestSuite(Ejemplo2.class);

        return suite;
    }

}
Texto 5: Test Suite

Ejecución de la prueba

Para ejecutar esta prueba desde Eclipse solo habría que lanzarla como prueba JUnit a través del menú “Ejecutar como / test JUnit”, o incluyéndola como un test más en un Test Suite.