Inicio rápido: Ejecución de pruebas de un extremo a otro a gran escala con Microsoft Playwright Testing Preview
En este inicio rápido, aprenderá a ejecutar las pruebas de Playwright con exploradores en la nube muy paralelos y a solucionar problemas de pruebas erróneas fácilmente mediante Microsoft Playwright Testing Preview. Use la infraestructura en la nube para validar la aplicación en varios exploradores, dispositivos y sistemas operativos. Publique los resultados y artefactos generados por Playwright en el servicio y visualícelas en el portal de servicios.
Después de completar este inicio rápido, tiene un área de trabajo de Microsoft Playwright Testing para ejecutar las pruebas de Playwright a escala y ver los resultados y artefactos de las pruebas en el portal de servicios.
Importante
Microsoft Playwright Testing se encuentra actualmente en versión preliminar. Para conocer los términos legales que se aplican a las características de Azure que se encuentran en la versión beta, en versión preliminar o que todavía no se han publicado para que estén disponibles con carácter general, consulte los Términos de uso complementarios para las versiones preliminares de Microsoft Azure.
Requisitos previos
- Una cuenta de Azure con una suscripción activa. Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.
- La cuenta de Azure necesita el propietario, colaborador, o uno de los roles de administrador clásicos.
- Un proyecto de Playwright. Si no tiene un proyecto, créelo mediante la documentación de introducción de Playwright o use nuestro proyecto de ejemplo de Microsoft Playwright Testing.
- Azure CLI. Si no tiene la CLI de Azure, consulte Instalación de la CLI de Azure.
Crear un área de trabajo
Para empezar a ejecutar las pruebas de Playwright a gran escala en exploradores en la nube, primero debe crear un área de trabajo de Microsoft Playwright Testing en el portal de Playwright.
Inicie sesión en el portal de Playwright con su cuenta de Azure.
Si ya tiene un área de trabajo, seleccione un área de trabajo existente y vaya al paso siguiente.
Sugerencia
Si tiene varias áreas de trabajo, puede cambiar a otra área de trabajo seleccionando su nombre en la parte superior de la página; después, seleccione Administrar todas las áreas de trabajo.
Si aún no tiene un área de trabajo, seleccione + Nueva área de trabajo y proporcione la siguiente información:
Campo Descripción Workspace name (Nombre del área de trabajo) Escriba un nombre único para identificar el área de trabajo.
El nombre solo puede constar de caracteres alfanuméricos y tener una longitud entre 3 y 64 caracteres.Suscripción de Azure Seleccione la suscripción de Azure que desea usar para esta área de trabajo de Microsoft Playwright Testing. Región Seleccione una ubicación geográfica para hospedar el área de trabajo.
Esta es la ubicación donde se almacenan los datos de ejecución de pruebas para el área de trabajo.
Seleccione Crear área de trabajo para crear el área de trabajo en la suscripción.
Durante la creación del área de trabajo, se crea un nuevo grupo de recursos y un recurso de Azure de Microsoft Playwright Testing en la suscripción de Azure.
Cuando finalice la creación del área de trabajo, se le redirigirá a la guía de configuración.
Instalación del paquete Microsoft Playwright Testing
Para usar el servicio, instale el paquete Microsoft Playwright Testing.
npm init @azure/microsoft-playwright-testing
Esto genera un archivo playwright.service.config.ts que sirve para:
- Dirigir y autenticar Playwright en el servicio Microsoft Playwright Testing.
- Agrega un periodista para publicar resultados y artefactos de prueba.
Si ya tiene este archivo, el paquete le pide que lo invalide.
Para usar el servicio, instale el paquete Microsoft Playwright Testing.
dotnet add package Azure.Developer.MicrosoftPlaywrightTesting.NUnit --prerelease
Configuración del punto de conexión de la región de servicio
En la configuración, debe proporcionar el punto de conexión de servicio específico de la región. El punto de conexión depende de la región de Azure seleccionada al crear el área de trabajo.
Para obtener la dirección URL del punto de conexión de servicio, siga estos pasos:
En Agregar punto de conexión de región en la configuración, copie el punto de conexión de región del área de trabajo.
La dirección URL del punto de conexión coincide con la región de Azure que ha seleccionado al crear el área de trabajo. Asegúrese de que esta dirección URL esté disponible en la variable de entorno
PLAYWRIGHT_SERVICE_URL.
Configurar el entorno
Para configurar el entorno, debe configurar la variable de entorno PLAYWRIGHT_SERVICE_URL con el valor que obtuvo en los pasos anteriores.
Se recomienda usar el módulo dotenv para administrar el entorno. Con dotenv, defina las variables de entorno en el archivo .env.
Agregue el módulo
dotenval proyecto:npm i --save-dev dotenvCree un archivo
.envjunto con el archivoplaywright.config.tsen el proyecto de Playwright:PLAYWRIGHT_SERVICE_URL={MY-REGION-ENDPOINT}Asegúrese de reemplazar el marcador de posición de texto
{MY-REGION-ENDPOINT}por el valor que copió anteriormente.
Configuración del servicio
Cree un archivo PlaywrightServiceSetup.cs en el proyecto con el siguiente contenido.
using Azure.Developer.MicrosoftPlaywrightTesting.NUnit;
namespace PlaywrightTests; // Remember to change this as per your project namespace
[SetUpFixture]
public class PlaywrightServiceSetup : PlaywrightServiceNUnit {};
Nota:
Asegúrese de que su proyecto utiliza la versión Microsoft.Playwright.NUnit 1.47 o superior.
Configuración de la autenticación
Para ejecutar las pruebas de Playwright en el área de trabajo de Microsoft Playwright Testing, debe autenticar el cliente Playwright donde ejecuta las pruebas con el servicio. Esto podría ser la máquina de desarrollo local o la máquina de CI.
El servicio ofrece dos métodos de autenticación: Microsoft Entra ID y Tokens de acceso.
Microsoft Entra ID usa las credenciales de Azure, lo que requiere un inicio de sesión en su cuenta de Azure para el acceso seguro. Como alternativa, puede generar un token de acceso desde el área de trabajo de Playwright y usarlo en la configuración.
Configuración de la autenticación mediante Microsoft Entra ID
Microsoft Entra ID es la autenticación predeterminada y recomendada para el servicio. Desde la máquina de desarrollo local, puede usar la CLI de Azure para iniciar sesión.
az login
Nota:
Si forma parte de varios inquilinos de Microsoft Entra, asegúrese de iniciar sesión en el inquilino al que pertenece el área de trabajo. Puede obtener el identificador de inquilino de Azure Portal. Consulte Buscar el inquilino de Microsoft Entra. Una vez que obtenga el identificador, inicie sesión con el comando az login --tenant <TenantID>
Configuración de la autenticación mediante tokens de acceso
Puede generar un token de acceso desde el área de trabajo Playwright Testing y usarla en la configuración. Sin embargo, se recomienda encarecidamente el Microsoft Entra ID para la autenticación debido a su seguridad mejorada. Los tokens de acceso, aunque convenientes, funcionan como contraseñas de larga duración y son más susceptibles de estar en peligro.
La autenticación mediante tokens de acceso está deshabilitada de manera predeterminada. Para su uso, Habilite la autenticación basada en tokens de acceso
Precaución
Se recomienda encarecidamente usar Microsoft Entra ID para la autenticación en el servicio. Si usa tokens de acceso, consulte Administración de tokens de acceso
Habilitación de artefactos en su configuración de Playwright
En el archivo playwright.config.ts del proyecto, asegúrese de que recopila todos los artefactos necesarios.
use: {
trace: 'on-first-retry',
video:'retain-on-failure',
screenshot:'on'
}
Habilite artefactos como recortes de pantalla, vídeos y seguimientos para que Playwright pueda capturarlos.
- Para obtener recortes de pantalla, consulte las capturas de recortes de pantalla
- Para ver vídeos, consulte la grabación de vídeos para las pruebas
- Para ver seguimientos, consulte la grabación de un seguimiento
Una vez recopilados estos artefactos, adjúntelos al TestContext para asegurarse de que estén disponibles en los informes de prueba. Para obtener más información, consulte nuestro proyecto de ejemplo de NUnit
Ejecución de pruebas a escala y solución de problemas fácilmente con Microsoft Playwright Testing
Ahora ha preparado la configuración para ejecutar las pruebas de Playwright en la nube con Microsoft Playwright Testing. Puede usar la CLI de Playwright para ejecutar las pruebas o usar la extensión Playwright Test de Visual Studio Code.
Ejecución de una sola prueba con el servicio
Con Microsoft Playwright Testing, se le cobra en función del número total de minutos de prueba y del número de resultados de pruebas publicados. Si es un usuario o empezar a trabajar con una prueba gratuita, puede empezar a ejecutar una sola prueba a escala en lugar de su conjunto de pruebas completo para evitar agotar los límites de evaluación gratuita.
Nota:
La característica de informes está habilitada de forma predeterminada para las áreas de trabajo existentes. Esto se está implementando en fases y tardará unos días. Para evitar errores, confirme que Rich diagnostics using reporting configuración está activada para el área de trabajo antes de continuar. Consulte Habilitación de informes para el área de trabajo.
Después de validar que la prueba se ejecuta correctamente, puede aumentar gradualmente la carga de pruebas ejecutando más pruebas con el servicio.
Realice los pasos siguientes para ejecutar una sola prueba de Playwright con Microsoft Playwright Testing:
Para usar la CLI de Playwright para ejecutar las pruebas con Microsoft Playwright Testing, pase el archivo de configuración del servicio como parámetro de línea de comandos.
Abra una ventana de terminal.
Escriba el siguiente comando para ejecutar la prueba de Playwright en exploradores remotos en el área de trabajo:
Reemplace el marcador de posición de texto
{name-of-file.spec.ts}por el nombre del archivo de especificación de prueba.npx playwright test {name-of-file.spec.ts} --config=playwright.service.config.tsUna vez completada la prueba, puede ver el estado de la prueba en el terminal.
Running 1 test using 1 worker 1 passed (2.2s) To open last HTML report run: npx playwright show-report
Ahora puede ejecutar varias pruebas con el servicio o ejecutar todo el conjunto de pruebas en exploradores remotos.
Precaución
En función del tamaño del conjunto de pruebas, es posible que incurra en cargos adicionales por los minutos de prueba y los resultados de las pruebas que superen los que tiene asignados de forma gratuita.
Ejecución de un conjunto de pruebas completo con el servicio
Ahora que ha validado que puede ejecutar una sola prueba con Microsoft Playwright Testing, puede ejecutar un conjunto de pruebas de Playwright completo a escala.
Realice los pasos siguientes para ejecutar un conjunto de pruebas de Playwright completo con Microsoft Playwright Testing:
Al ejecutar varias pruebas de Playwright o un conjunto de pruebas completo con Microsoft Playwright Testing, puede especificar opcionalmente el número de trabajos paralelos como parámetro de línea de comandos.
Abra una ventana de terminal.
Escriba el siguiente comando para ejecutar el conjunto de pruebas de Playwright en exploradores remotos en el área de trabajo:
npx playwright test --config=playwright.service.config.ts --workers=20En función del tamaño del conjunto de pruebas, este comando ejecuta las pruebas en hasta 20 trabajos paralelos.
Una vez completada la prueba, puede ver el estado de la prueba en el terminal.
Running 6 tests using 6 workers 6 passed (18.2s) Test report: https://playwright.microsoft.com/workspaces/<workspace-id>/runs/<run-id>
Ejecute pruebas de Playwright en exploradores administrados por el servicio y vea los resultados en el portal unificado mediante la configuración que creó anteriormente.
dotnet test --settings:.runsettings --logger "microsoft-playwright-testing" -- NUnit.NumberOfTestWorkers=20
La configuración de la ejecución de pruebas se define en archivo .runsettings. Consulte cómo usar las opciones del paquete de servicio
Una vez completada la ejecución de la prueba, puede ver el estado de la prueba en el terminal.
Starting test execution, please wait...
Initializing reporting for this test run. You can view the results at: https://playwright.microsoft.com/workspaces/<workspace-id>/runs/<run-id>
A total of 100 test files matched the specified pattern.
Test Report: https://playwright.microsoft.com/workspaces/<workspace-id>/runs/<run-id>
Passed! - Failed: 0, Passed: 100, Skipped: 0, Total: 100, Duration: 59 s - PlaywrightTestsNUnit.dll (net7.0)
Workload updates are available. Run `dotnet workload list` for more information.
Visualización de ejecuciones de pruebas y resultados en el portal de Playwright
Ahora puede solucionar los casos de prueba con errores en el portal de Playwright.
Una vez que se completa la ejecución de la prueba, se genera un vínculo al portal de Playwright. Abra este vínculo para ver los resultados detallados de las pruebas y los artefactos asociados. En el portal se muestra información esencial, como la siguiente:
- Detalles de la compilación de CI
- Estado general de la ejecución de pruebas
- Identificador de confirmación vinculado a la ejecución de pruebas
En el portal de Playwright se proporciona toda la información necesaria para solucionar problemas. Puede:
- Cambio entre reintentos.
- Vea registros de errores detallados, pasos de prueba y artefactos adjuntos, como recortes de pantalla o vídeos.
- Vaya directamente al Visor de seguimiento para un análisis más profundo.
El Visor de seguimiento le permite recorrer paso a paso visualmente la ejecución de pruebas. Puede:
- Use la escala de tiempo para mantener el puntero sobre los pasos individuales y mostrar el estado de la página antes y después de cada acción.
- Inspeccione registros detallados, instantáneas de DOM, la actividad de red, los errores y la salida de la consola para cada paso.
Sugerencia
Puede usar las características del servicio Microsoft Playwright Testing de forma independiente. Puede publicar resultados de prueba en el portal sin usar la característica exploradores hospedados en la nube y también puede usar solo exploradores hospedados en la nube para acelerar el conjunto de pruebas sin publicar resultados de pruebas.
Nota:
Los resultados de pruebas y artefactos que publica se conservan en el servicio durante 90 días. Después, se eliminan automáticamente.
Optimización de la configuración del trabajo paralelo
Una vez que las pruebas se ejecutan sin problemas con el servicio, experimente con la variación del número de trabajos paralelos para determinar la configuración óptima que minimiza el tiempo de finalización de la prueba.
Con Microsoft Playwright Testing, puede ejecutar hasta 50 trabajos paralelos. Varios factores influyen en la mejor configuración del proyecto, como la CPU, la memoria y los recursos de red de la máquina cliente, la capacidad de control de carga de la aplicación de destino y el tipo de acciones realizadas en las pruebas.
Puede especificar el número de trabajos paralelos en la línea de comandos de la CLI de Playwright o configurar la propiedad workers en el archivo de configuración del servicio Playwright.
Puede especificar el número de trabajos paralelos en la línea de comandos de la CLI de Playwright o configurar la propiedad NumberOfTestWorkers en el archivo .runsettings.
Obtenga más información sobre cómo determinar la configuración óptima para optimizar la ejecución del conjunto de pruebas.
Paso siguiente
Ha creado correctamente un área de trabajo de Microsoft Playwright Testing en el portal de Playwright y ha ejecutado las pruebas de Playwright en exploradores en la nube.
Pase al siguiente inicio rápido para configurar las pruebas continuas de un extremo a otro mediante la ejecución de las pruebas de Playwright en el flujo de trabajo de CI/CD.