Grupos en TestNG

Por: Krishna rungta Krishna rungta
Hours Actualizado

⚡ Resumen inteligente

Grupos en TestNG Permite etiquetar los métodos de prueba con etiquetas lógicas y luego incluirlos o excluirlos mediante un conjunto de XML. Este enfoque simplifica las ejecuciones de pruebas de humo, regresión y basadas en dependencias sin necesidad de reescribir el código. Java código.

  • 🏷️ Sintaxis de anotación: Usar @Test(groups = {"smoke","regression"}) etiquetar cualquier método con uno o más nombres de grupo lógicos.
  • 📜 Control XML: El <groups><run><include> y <exclude> Las etiquetas dentro de testng.xml deciden qué métodos etiquetados se ejecutan realmente.
  • 🔗 Dependencias: El dependsOnGroups El orden de los atributos obliga a que los grupos de prerrequisitos siempre terminen antes de que comiencen las pruebas dependientes.
  • 🤖 Selección por IA: Las herramientas de IA para el análisis del impacto de las pruebas asignan los cambios de código a los grupos pertinentes, de modo que solo se ejecutan los conjuntos de pruebas afectados en cada confirmación.
  • 🧪 TestNG 7.x: Las versiones modernas mantienen la compatibilidad total de los grupos con la ejecución paralela, los oyentes y las canalizaciones de Maven Surefire.
Descubre más

Grupos en TestNG

TestNG es un marco de pruebas que cubre pruebas unitarias, funcionales, de extremo a extremo, de interfaz de usuario y de integración para Java de proyectos.

Puedes ejecutar un único paquete o varios paquetes (un paquete encapsula clases relacionadas en una estructura de directorios definida) creando un conjunto XML y activándolo a través de Maven.

TestNG Grupos con ejemplo

Usted utiliza grupos en TestNG cuando:

  • No es conveniente dispersar los métodos de prueba en muchas clases simplemente por área funcional, y
  • Desea omitir (no ejecutar) los casos de prueba seleccionados como si no estuvieran presentes en el código fuente.
  • Para lograr ambos objetivos, debes agrupar los métodos de forma lógica. TestNG Luego, respeta los filtros "incluir" y "excluir" declarados en el conjunto XML.

El fragmento que aparece a continuación muestra la sintaxis de etiquetado de grupos utilizada en un método de prueba.

@Prueba (grupos = { “vínculo”, “lazos fuertes” })

Aquí se utilizan dos nombres de grupo, a saber: bonding y strong_tiesEstas son etiquetas lógicas que puedes renombrar para adaptarlas a tu proyecto.

El <groups> La etiqueta marca el inicio de los filtros de grupo dentro del conjunto XML.

A continuación, personaliza el XML para seleccionar un grupo específico de las clases etiquetadas. El siguiente ejemplo muestra la sintaxis de declaración de grupo.

<grupos>
<puedes seguir>
<incluir nombre =“vínculo” />
</puedes seguir>
</grupos>

Supongamos que una sola clase contiene 10 métodos de prueba.

De entre esos métodos:

  • 6 métodos llevan el bonding grupo y
  • 4 métodos llevan el strong_ties grupo.

A continuación, configura Maven y Java rutas y uso del Eclipse IDE para demostrar el uso de grupos a través de archivos XML dentro de un JavaProyecto basado en Maven.

No te pierdas

Crear XML para TestNG con etiquetas

  • El archivo XML (Lenguaje de Marcado Extensible) en el marco de trabajo Maven almacena la configuración para una o más pruebas, declaradas dentro del </head>.
  • Cada entrada de prueba está envuelta en un etiqueta y puede contener uno o más TestNG clases.
  • A Java clase con uno o más @Prueba Las anotaciones en sus métodos se tratan como una TestNG clase.

Varias etiquetas aparecen en secuencia para construir un archivo testng.xml funcional, a saber: , , y .

  • El La etiqueta contiene el nombre de nivel de suite utilizado en TestNG informes para resúmenes de ejecución.
  • El <test name=”Guru 99 Demostración de prueba de humo”> La etiqueta contiene un nombre lógico para la prueba; el informe la utiliza para el recuento de pruebas aprobadas, fallidas y omitidas, además del tiempo total de ejecución y los metadatos del grupo.
  • El La etiqueta apunta a la clase de prueba, donde com.group.guru99 es el paquete y TC_Class1 es el nombre de la clase.

<!DOCTYPE suite LITE PARA TECHOS PLANOS “http://testng.org/testng-1.0.dtd”>
<suite nombre ="Suite">
<compruébalo nombre ="Guru Demostración de prueba de humo 99>
<grupos>
<puedes seguir>
<incluir nombre =“lazos fuertes” />
</puedes seguir>
</grupos>
<privadas>
<clase nombre =“com.group.guru99.TC_Class1” />
</privadas>
</compruébalo>
</suite>

Esta configuración XML se menciona en los tutoriales en vídeo de las siguientes secciones.

"excluir" o "incluir" en XML de prueba

Si el mecanismo de agrupación resulta engorroso para un filtro pequeño, el conjunto de herramientas testng.xml también permite excluir o incluir métodos de prueba individuales por nombre.

Etiqueta de exclusión: Sintaxis para la etiqueta de exclusiónexcluir nombre =“${TEST_CASE_NAME}” />
Incluir etiqueta: Sintaxis para la etiqueta includeincluir nombre =“${TEST_CASE_NAME}” />

Nota: Puedes incluir o excluir varios casos de prueba en una sola ejecución, y la misma sintaxis se aplica a los filtros de grupo.

Uso de dependsOnGroups para la ejecución ordenada

Más allá de la simple inclusión, TestNG permite que un grupo dependa de otro usando el dependsOnGroups atributo. El ejecutor garantiza que cada método del grupo padre finalice antes de que comience cualquier método dependiente, lo que mantiene la fiabilidad de las precondiciones.

  • Primero inicia sesión, luego realiza transacciones: Métodos de inicio de sesión de etiquetas con group = "auth"y pruebas de transferencia de etiquetas con dependsOnGroups = {"auth"}Las pruebas de transferencia se ejecutan únicamente después de que el inicio de sesión sea exitoso.
  • Saltar en caso de fallo: Si falla un método en el grupo padre, TestNG En lugar de hacer que fallen directamente, marca los métodos dependientes como omitidos, lo que garantiza la veracidad de los informes.
  • Combinar con alwaysRun: Los métodos de limpieza deben establecerse alwaysRun = true Por lo tanto, el proceso de desmontaje continúa ejecutándose incluso cuando falla un grupo anterior.

Este patrón es común en conjuntos de pruebas integrales donde la configuración de la API debe completarse antes de que se inicien las aserciones de la interfaz de usuario.

Ejecutar TestNG Agrupar, incluir, excluir código (demostración en vídeo)

A continuación se muestra un recorrido por el Java código y el conjunto XML que impulsan el agrupar, excluir e incluir comportamiento.

Escenario de prueba: Inicie el GuruSitio web de banca de demostración 99, verifique algunos elementos en la página de inicio de sesión, ingrese sus credenciales y vuelva a verificar algunos elementos en el panel de control después de iniciar sesión.

Ejecutar TestNG Agrupar, Incluir, Excluir Code

Nota: Cada paso reside en su propio método, pero en tiempo de ejecución el orden depende de las entradas en el conjunto XML.

  • Método 1: Inicializa el navegador y ejecuta el URL (tc01LaunchURL()).
  • Método 2: Verifique el encabezado de la página de inicio de sesión (tc02VerifyLaunchPage()).
  • Método 3: Introduzca su nombre de usuario y contraseña en el formulario de inicio de sesión (tc03EnterCredentials()).
  • Método 4: Verifique la presencia del ID de administrador en el panel de usuario (tc04VerifyLoggedInPage()).
  • Método 5: Verifique los enlaces adicionales en el panel de usuario (tc05VerifyHyperlinks()).

Code para el escenario:

PARA DOS com.group.guru99;

importar java.util.concurrent.TimeUnit;

importar org.openqa.selenium.By;
importar org.openqa.selenium.WebDriver;
importar org.openqa.selenium.firefox.FirefoxConductor;
importar org.testng.Assert;
importar org.testng.anotaciones.Prueba;

clase pública TC_Clase1 {
final estática pública Controlador web webDriver = ¡nuevos Socios! de FirefoxDestornillador();

Cordón launchPageHeading = “//h3[text()='Guru99 Banco']”;
final Cordón elemento_nombre_usuario = “//input[@name='uid']”, elemento_de_contraseña = “//input[@name='password']”,
elemento_de_inicio_de_sesión = “//input[@name='btnLogin']”;
final Cordón valor_nombre_usuario = “mngr28642”, valor_de_contraseña = “ydAnate”;
final Cordón ID del gerente = “//td[contiene(texto(),'ID del gerente')]”;
final Cordón nuevoCliente = “//a[@href='addcustomerpage.php']”, transferencia de fondos = “//a[@href='FundTransInput.php']”;

/** Este caso de prueba inicializa el webDriver */
@Prueba(grupos = { “vínculo”, “lazos fuertes” })
vacío público tc01LaunchURL() {
webDriver.manage().window().maximize();
webDriver.manage().timeouts().implicitlyWait(20, Unidad de tiempo.SEGUNDOS);
webDriver.get(“https://www.demo.guru99.com/V4/”);
}

/** Comprueba la presencia del encabezado en la página de inicio de sesión */
@Prueba(grupos = { “vínculo” })
vacío público tc02VerifyLaunchPage() {
Assert.assertTrue(webDriver.findElement(By.xpath(launchPageHeading)).isDisplayed(),
“El encabezado de la página de inicio no se muestra”);
System.out.println (Se muestra el encabezado de la página de inicio.);
}

/** Introduce el nombre de usuario y la contraseña, y luego haz clic en Iniciar sesión */
@Prueba(grupos = { “vínculo”, “lazos fuertes” })
vacío público tc03IngresarCredenciales() {
webDriver.findElement(By.xpath(userName_element)).sendKeys(userName_value);
webDriver.findElement(By.xpath(password_element)).sendKeys(password_value);
webDriver.findElement(By.xpath(signIn_element)).click();
}

/** Verifica el ID del administrador en el panel de control */
@Prueba(grupos = { “lazos fuertes” })
vacío público tc04VerifyLoggedInPage() {
Assert.assertTrue(webDriver.findElement(By.xpath(managerID)).isDisplayed(),
“La etiqueta de identificación del gerente no se muestra”);
System.out.println (Se muestra la etiqueta de ID del gerente.);
}

/** Comprueba el enlace de Nuevo cliente y el enlace de Transferencia de fondos en el panel de control */
@Prueba(grupos = { “vínculo” })
vacío público tc05VerificarHipervínculos() {
Assert.assertTrue(webDriver.findElement(By.xpath(newCustomer)).isEnabled(),
El enlace para nuevos clientes no se muestra.);
System.out.println (Se muestra el enlace para nuevos clientes.);

Assert.assertTrue(webDriver.findElement(By.xpath(fundTransfer)).isEnabled(),
El enlace para transferir fondos no se muestra.);
System.out.println (Se muestra el enlace de transferencia de fondos.);
}
}

Tenga en cuenta que las credenciales bancarias de demostración siguen siendo válidas durante aproximadamente 20 días, por lo que una ejecución local podría mostrar un error de credenciales no válidas una vez transcurrido ese plazo.

Explicación del código:

Cinco métodos de prueba, uno por acción, cada uno conlleva una groups Atributo en el @Test anotación.

Las dos etiquetas de grupo lógicas son strong_ties y bonding.

  • El primer y el tercer método conllevan ambos bonding y strong_ties, por lo que se ejecutan siempre que cualquiera de los grupos se incluya en el conjunto. Este es un patrón común para los compartidos. caso de prueba pasos.
  • El segundo método está etiquetado únicamente con bonding, por lo que solo se ejecuta cuando el bonding El grupo está incluido.
  • El cuarto método está etiquetado únicamente con strong_ties, por lo que solo se ejecuta cuando ese grupo está incluido.
  • El quinto método está etiquetado únicamente con bonding, por lo que solo se ejecuta cuando el bonding El grupo está incluido.

A continuación se presentan cuatro escenarios de ejecución:

Escenario 1: Ejecutar todos los métodos de prueba independientemente del grupo. Eliminar el <groups> Bloquear desde el XML en ejecución.

Escenario 2: Ejecutar únicamente los métodos vinculados a un grupo elegido, a saber: strong_ties or bondingConsulte el vídeo a continuación.

  • En la primera parte del video, el <groups> El bloque está comentado, por lo que se ejecutan todos los métodos de prueba.
  • En la segunda parte, se restablece el filtro de grupo y solo se ejecutan los métodos coincidentes.

Escenario 3: Aplique el filtro de exclusión para omitir los casos de prueba seleccionados. Consulte el vídeo.

  • La demostración excluye tc02 aparece por su nombre en el XML en ejecución, y el informe de resultados confirma que el método excluido no se ejecuta.

Escenario 4: Aplique el filtro de inclusión para ejecutarlo únicamente. tc01LaunchURL, tc03EnterCredentials, y tc05VerifyHyperlinksConsulte el vídeo.

En esta ejecución, solo se ejecutan los métodos enumerados en el filtro de inclusión, exactamente como están configurados.

Descarga el proyecto de ejemplo desde el siguiente enlace.

Descarga lo anterior Code

Conclusión

Grupos en TestNG aportar estructura a grandes Selenium y conjuntos de unidades reemplazando las divisiones de clases únicas con filtros XML declarativos.

Etiqueta tus métodos con @Test(groups = {...}), luego use <include>, <exclude>, y dependsOnGroups para impulsar pruebas de humo, regresión y ejecuciones de extremo a extremo desde el mismo proyecto Maven en TestNG 7.x.

Preguntas Frecuentes

Un grupo es una etiqueta lógica adjunta a un método de prueba a través de la groups atributo en @TestEl conjunto de herramientas XML selecciona grupos mediante filtros de inclusión y exclusión, de modo que usted decide en tiempo de ejecución qué métodos etiquetados se ejecutan.

Inside <groups><run>, <include name="..."> grupos de listas blancas de etiquetas para la ejecución y <exclude name="..."> los bloquea. TestNG Aplica exclusiones después de inclusiones, por lo que un grupo excluido siempre se omite, incluso cuando también aparece en la lista de inclusiones.

El dependsOnGroups atributo en @Test efectivo TestNG ejecutar todos los métodos del grupo listado antes de que comience el método dependiente. Si falla algún método de prerrequisito, TestNG marca el método dependiente como omitido en lugar de como fallido.

Sí. La groups El atributo acepta una matriz, por lo que @Test(groups = {"smoke", "regression"}) coloca un método en ambos grupos. TestNG Este método se ejecuta siempre que cualquiera de los grupos se incluya en el conjunto de pruebas, lo que evita que los pasos compartidos se repitan.

TestNG 7.x es la línea mantenida, con lanzamientos bajo la org.testng:testng Maven coordina. Mantiene los grupos, la ejecución paralela y los oyentes totalmente compatibles con las tecnologías modernas. Selenium Proyectos 4 y JDK 17.

Las herramientas de IA para el análisis del impacto de las pruebas analizan las diferencias de código y luego asignan las clases modificadas a los grupos que las cubren. El proceso ejecuta solo esos grupos etiquetados en cada solicitud de extracción, lo que reduce el tiempo de retroalimentación y mantieneping Rutas arriesgadas bajo prueba.

Sí. Los algoritmos de agrupamiento de IA leen los registros históricos de fallas, marcan las pruebas inestables y proponen un subconjunto estable etiquetado como regressionLos ingenieros aprueban la lista y luego... TestNG Ese grupo trabaja todas las noches, lo que mantiene la suite compacta sin perder cobertura.

Resumir este post con: