TestNG Tutorial

¿Qué es TestNG?

TestNG es un marco de pruebas de automatización donde “NG” significa “Next Generation” (próxima generación). TestNG está inspirado en JUnit y utiliza Java anotaciones (@) para controlar el flujo de la prueba. Supera JUnitlimitaciones anteriores y está diseñado para hacer pruebas de extremo a extremo más fácil.

Con TestNG Puedes generar un informe detallado y ver de inmediato cuántas pruebas se aprobaron, fallaron o se omitieron. También puedes volver a ejecutar solo los casos que fallaron.

Por ejemplo:

• Supongamos que tiene cinco casos de prueba, cada uno en su propio método, escritos sin TestNGTres pasan; la cuarta falla. Después de corregir la cuarta, conviene volver a ejecutar solo esa, ya que las tres primeras pasaron. Esto es difícil de hacer con código simple del método main().
• TestNG proporciona una testng-failed.xml presentar en el test-output carpeta. Al ejecutar ese XML, solo se vuelven a ejecutar los casos que fallaron.

Más allá de eso, aprenderás las ventajas de TestNG, cómo escribir métodos de prueba con anotaciones @Test y cómo convertir sus clases en un conjunto de pruebas que se ejecuta desde Eclipse o la línea de comandos.

Por qué usar TestNG con Selenium?

Por defecto, Selenium Las pruebas no producen resultados con un formato adecuado. Con TestNG Una vez conectado, el ejecutor de pruebas genera un informe estructurado que puedes compartir con el equipo.

La mayoría de las Selenium los usuarios prefieren TestNG más del JUnit debido a su conjunto de características más amplio. Las características clave para Selenium son:

• Informes que incluyen el número de casos de prueba ejecutados, aprobados, fallidos y omitidos.
• Grupo fácilping de casos de prueba a través de un testng.xml archivo, con prioridades de ejecución.
• Repita una prueba varias veces sin bucles usando invocationCount.
• Ejecutar múltiples pruebas en múltiples navegadores: entre navegadores.prueba del navegador apoyo.
• Integración fluida con Maven, Jenkinsy otras herramientas de CI.
• Readable anotaciones — por ejemplo, @BeforeMethod, @AfterMethod, @BeforeTest, @AfterTest.
• Selenium WebDriver no tiene funciones de generación de informes nativas; TestNG Cubre esa laguna con un informe HTML limpio como el que se muestra a continuación.

• TestNG Simplifica el código de prueba. Ya no necesitas un método main estático; las anotaciones deciden qué se ejecuta y cuándo.

• Las excepciones no capturadas se manejan de manera elegante por TestNGSe informan como pasos fallidos sin que se interrumpa la ejecución completa.

Ventajas de TestNG más del JUnit

TestNG ofrece tres ventajas principales sobre JUnit:

• Las anotaciones son más fáciles de entender y usar.
• Los casos de prueba se pueden agrupar y priorizar con menos esfuerzo.
• La ejecución de pruebas en paralelo viene incluida de serie.

¿Qué es una anotación en TestNG?

Anotaciones en TestNG Son líneas de código que se colocan encima de un método para controlar cómo se ejecuta. Siempre comienzan con el símbolo @. A continuación se muestra un ejemplo sencillo.

Las anotaciones se tratan en detalle en la sección “Anotaciones utilizadas en TestNG" Más adelante en este tutorial, por lo que el ejemplo anterior solo sirve para establecer expectativas. TestNG Las anotaciones son más fáciles de codificar y leer que las JUnit equivalentes, y son esenciales al realizar pruebas en Selenium Cuadrícula donde la ejecución en paralelo es importante.

Cómo escribir casos de prueba en TestNG

Escribiendo un TestNG El caso de prueba consta de tres pasos:

1. Escribe tu lógica de negocio y colócala TestNG anotaciones encima de cada método.
2. Agregue metadatos como el nombre de la clase, el nombre del grupo y el nombre del paquete.
3. Ejecute el TestNG clase desde su IDE o la línea de comandos.

Crear un caso de prueba utilizando TestNG Anotaciones

Ahora crearemos nuestro primer caso de prueba utilizando TestNG anotaciones en Selenium. Antes de escribir la prueba, configure una nueva TestNG proyecto en Eclipse y llámalo Nombre TestNGProyectos.

Configurando un nuevo TestNG Proyectos

Paso 1) Haga clic en Archivo > Nuevo > Java Proyectos.

Paso 2) entrar: Nombre TestNGProyectos como nombre del proyecto y haga clic Siguiente.

Paso 3) Importar el TestNG bibliotecas. Haga clic en el Bibliotecas pestaña y luego Agregar biblioteca….

Paso 4) En la sección Agregar biblioteca diálogo, elegir TestNG y hacer clic en Siguiente.

Paso 5) Haga clic en Termine.

TestNG Ahora debería aparecer en la lista de Bibliotecas.

Paso 6) Agregue los archivos JAR que contienen el Selenium API. Estos provienen de la Java Controlador de cliente descargado de selenium.dev/descargas.

Navegue a la carpeta donde se encuentra Selenium Los archivos JAR se almacenan.

Después de agregar los archivos JAR externos, la pantalla debería verse así.

Paso 7) Haga clic en Termine. El nuevo Nombre TestNGProyectos aparece en el Explorador de paquetes.

Cómo crear un nuevo TestNG Archivo de prueba

Con el proyecto listo, crea uno nuevo. TestNG .

Paso 1) Haga clic derecho en src carpeta y elegir Nuevo > Otros….

Paso 2) Ampliar la opción TestNG carpeta, seleccione TestNG claseY haga clic en Siguiente.

Paso 3) Introduzca los valores que se muestran a continuación y haga clic. Termine. La función de Java el archivo se llama Nombre TestNGArchivo.

Paso 4) Eclipse genera el TestNG Plantilla que se muestra a continuación.

Codificando tu primer TestNG Caso de prueba

Crea el primero caso de prueba que verifica el título de la Mercury Página de inicio de excursiones.

package firsttestngpackage;

import org.openqa.selenium.WebDriver;
import org.openqa.selenium.firefox.FirefoxDriver;
import org.testng.Assert;
import org.testng.annotations.Test;

public class FirstTestNGFile {

    public String baseUrl = "https://demo.guru99.com/test/newtours/";
    public WebDriver driver;

    @Test
    public void verifyHomepageTitle() {
        System.out.println("launching firefox browser");
        // Selenium 4 ships Selenium Manager, so the driver path is no longer required.
        driver = new FirefoxDriver();
        driver.get(baseUrl);
        String expectedTitle = "Welcome: Mercury Tours";
        String actualTitle = driver.getTitle();
        Assert.assertEquals(actualTitle, expectedTitle);
        driver.quit();
    }
}

Cosas a tener en cuenta:

• TestNG no necesita un main() método.
• Los métodos no tienen por qué ser estáticos.
• El @Prueba marcas de anotación verifyHomepageTitle() como caso de prueba.
• Las anotaciones se encuentran en el org.testng.annotations.* Pack
• El Afirmar clase de org.testng.Assert realiza verificaciones.

Puede tener varias anotaciones @Test en una sola TestNG El archivo. Lo cubrimos en el “Anotaciones utilizadas en TestNG" .

Ejecución de la prueba

Haga clic con el botón derecho en el archivo y ejecútelo como un TestNG prueba. Eclipse produce dos resultados: un resultado de texto en la ventana de la consola y un resultado gráfico en la TestNG Ventana de resultados.

Comprobación de informes creados por TestNG

La ventana de la consola proporciona un resumen basado en texto mientras que la TestNG La ventana de resultados muestra una vista gráfica.

Generando informes HTML

TestNG También puede generar informes HTML completos.

Paso 1) despues de correr Nombre TestNGArchivo, haga clic con el botón derecho en el proyecto y elija Refrescar.

Paso 2) A salida de prueba Aparece una carpeta. Expándala y localícela. index.html — el informe HTML de la ejecución más reciente.

Paso 3) Double-hacer clic index.html para abrirlo por dentro EclipseNavegador de [nombre del navegador]. Pulse F5 para actualizar después de futuras ejecuciones.

Anotaciones utilizadas en TestNG

Ya has visto la anotación @Test. El resto de esta sección cubre las anotaciones avanzadas más útiles.

Múltiples casos de prueba

Un único TestNG El archivo puede contener múltiples anotaciones @Test. Por defecto, los métodos anotados con @Test se ejecutan en orden alfabético. En el código siguiente, los métodos c_test, a_test, y b_test Se ejecutan alfabéticamente independientemente del orden de origen.

Ejecuta el código y abre index.html. Haga clic en Visión cronológica.

Parámetros

Para anular el orden predeterminado, utilice el priority parámetro. Los parámetros son palabras clave que modifican el comportamiento de una anotación.

• Asignar un valor con =.
• Envuelva los parámetros entre paréntesis inmediatamente después de la anotación, como se muestra a continuación.

TestNG Ejecuta las anotaciones @Test desde el valor de prioridad más bajo hasta el más alto. Los números de prioridad no tienen por qué ser consecutivos.

El informe HTML confirma que los métodos se ejecutaron en orden de prioridad ascendente.

Múltiples parámetros

Además de priority, @Test acepta el alwaysRun parámetro (verdadero o falso). Para usar dos o más parámetros en una sola anotación, sepárelos con una coma:

@Test(priority = 0, alwaysRun = true)

@Antes de la prueba y @Después de la prueba

@AntesTest	Los métodos bajo esta anotación se ejecutan antes del primer caso de prueba en el TestNG listo para importar.
@Después de la prueba	Los métodos bajo esta anotación se ejecutan después de todos los casos de prueba en el TestNG archivo finalizado.

Considere el código a continuación.

package firsttestngpackage;

import org.openqa.selenium.WebDriver;
import org.openqa.selenium.firefox.FirefoxDriver;
import org.testng.Assert;
import org.testng.annotations.*;

public class FirstTestNGFile {

    public String baseUrl = "https://demo.guru99.com/test/newtours/";
    public WebDriver driver;

    @BeforeTest
    public void launchBrowser() {
        System.out.println("launching firefox browser");
        driver = new FirefoxDriver();
        driver.get(baseUrl);
    }

    @Test
    public void verifyHomepageTitle() {
        String expectedTitle = "Welcome: Mercury Tours";
        String actualTitle = driver.getTitle();
        Assert.assertEquals(actualTitle, expectedTitle);
    }

    @AfterTest
    public void terminateBrowser() {
        driver.quit();
    }
}

A partir de la tabla y el código, podemos predecir que la secuencia será:

• 1º — launchBrowser()
• 2º — verifyHomepageTitle()
• 3º — terminateBrowser()

La ubicación de los bloques de anotación en el archivo fuente no afecta su orden de ejecución. Intenta reorganizar los métodos como se muestra a continuación.

package firsttestngpackage;

import org.openqa.selenium.WebDriver;
import org.openqa.selenium.firefox.FirefoxDriver;
import org.testng.Assert;
import org.testng.annotations.*;

public class FirstTestNGFile {

    public String baseUrl = "https://demo.guru99.com/test/newtours/";
    public WebDriver driver;

    @AfterTest                              // Jumbled
    public void terminateBrowser() {
        driver.quit();
    }

    @BeforeTest                             // Jumbled
    public void launchBrowser() {
        System.out.println("launching firefox browser");
        driver = new FirefoxDriver();
        driver.get(baseUrl);
    }

    @Test                                   // Jumbled
    public void verifyHomepageTitle() {
        String expectedTitle = "Welcome: Mercury Tours";
        String actualTitle = driver.getTitle();
        Assert.assertEquals(actualTitle, expectedTitle);
    }
}

Ejecuta el código y verifica el resultado.

@BeforeMethod y @AfterMethod

@Antes del método	Los métodos bajo esta anotación se ejecutan antes de cada método de prueba.
@Después del método	Los métodos bajo esta anotación se ejecutan después de cada método de prueba.

In Mercury En el caso de los tours, supongamos que queremos verificar los títulos de dos páginas de destino a las que se accede desde la página de inicio.

El flujo de la prueba es el siguiente:

• Abre la página de inicio y verifica su título.
• Haga clic en REGISTRAR y verifique el título de su página de destino.
• Vuelve a la página principal y verifica el título.
• Haga clic en SOPORTE y verifique el título de su página de destino.
• Vuelve a la página principal y verifica el título de nuevo.

El código que aparece a continuación muestra cómo @BeforeMethod y @AfterMethod gestionan los pasos repetidos.

package firsttestngpackage;

import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.firefox.FirefoxDriver;
import org.testng.Assert;
import org.testng.annotations.*;

public class FirstTestNGFile {

    public String baseUrl = "https://demo.guru99.com/test/newtours/";
    public WebDriver driver;
    public String expected = null;
    public String actual = null;

    @BeforeTest
    public void launchBrowser() {
        System.out.println("launching firefox browser");
        driver = new FirefoxDriver();
        driver.get(baseUrl);
    }

    @BeforeMethod
    public void verifyHomepageTitle() {
        String expectedTitle = "Welcome: Mercury Tours";
        String actualTitle = driver.getTitle();
        Assert.assertEquals(actualTitle, expectedTitle);
    }

    @Test(priority = 0)
    public void register() {
        driver.findElement(By.linkText("REGISTER")).click();
        expected = "Register: Mercury Tours";
        actual = driver.getTitle();
        Assert.assertEquals(actual, expected);
    }

    @Test(priority = 1)
    public void support() {
        driver.findElement(By.linkText("SUPPORT")).click();
        expected = "Under Construction: Mercury Tours";
        actual = driver.getTitle();
        Assert.assertEquals(actual, expected);
    }

    @AfterMethod
    public void goBackToHomepage() {
        driver.findElement(By.linkText("Home")).click();
    }

    @AfterTest
    public void terminateBrowser() {
        driver.quit();
    }
}

Después de ejecutar la prueba, TestNG informa la siguiente secuencia.

En resumen: coloque los pasos de configuración dentro @Antes del método y limpieza o restablecimiento de navegación en el interior @Después del método De este modo, cada caso de prueba comienza y termina en un estado conocido.

Resumen de TestNG Anotaciones

• @BeforeSuite: Se ejecuta antes que todas las demás pruebas del conjunto.
• @AfterSuite: Se ejecuta después de todas las pruebas del conjunto.
• @AntesDeLaPrueba: se ejecuta antes de cualquier método de prueba perteneciente a las clases dentro de un etiqueta.
• @DespuésDeLaPrueba: se ejecuta después de todos los métodos de prueba pertenecientes a las clases dentro de un etiqueta.
• @BeforeGroups: se ejecuta poco antes del primer método de prueba que pertenece a cualquier grupo listado.
• @AfterGroups: se ejecuta poco después del último método de prueba que pertenece a cualquier grupo listado.
• @AntesDeClase: se ejecuta antes del primer método de prueba en la clase actual.
• @DespuésDeClase: Se ejecuta después de todos los métodos de prueba en la clase actual.
• @BeforeMethod: Se ejecuta antes de cada método de prueba.
• @AfterMethod: Se ejecuta después de cada método de prueba.
• @Prueba: marca el método como un caso de prueba.

Preguntas Frecuentes