Compartir a través de

Inicio rápido: Ejecución de pruebas de un extremo a otro a gran escala con Microsoft Playwright Testing Preview

  • Artículo

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

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.

  1. Inicie sesión en el portal de Playwright con su cuenta de Azure.

  2. 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.

  3. 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.

    Captura de pantalla que muestra la página

  4. 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.

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:

  1. 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.

    Captura de pantalla que muestra cómo copiar el punto de conexión de la región del área de trabajo en el portal de Playwright Testing.

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.

  1. Agregue el módulo dotenv al proyecto:

    npm i --save-dev dotenv

  2. Cree un archivo .env junto con el archivo playwright.config.ts en 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 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.

  1. La autenticación mediante tokens de acceso está deshabilitada de manera predeterminada. Para su uso, Habilite la autenticación basada en tokens de acceso

  2. Configuración de la autenticación mediante 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

Ejecución de pruebas a gran escala 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 a escala

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.

  1. Abra una ventana de terminal.

  2. 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.ts

    Una 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, puede incurrir en cargos adicionales por los minutos de prueba posteriores a los minutos de prueba gratuitos asignados y los resultados de las pruebas gratuitas.

Ejecución de un conjunto de pruebas completo a escala

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.

  1. Abra una ventana de terminal.

  2. 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=20

    En 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)

To open last HTML report run:

    npx playwright show-report

Visualización de ejecuciones de pruebas y resultados en el portal de Playwright

Vaya al Portal de Playwright para ver las ejecuciones de pruebas y los resultados de las pruebas del área de trabajo.

Captura de pantalla que muestra las ejecuciones de pruebas de un área de trabajo en el portal de Playwright Testing.

La ejecución de pruebas contiene la información de CI, el estado de ejecución de pruebas, los trabajos usados, la duración y los minutos facturables. Si abre una ejecución de prueba, puede ver los resultados y artefactos de cada prueba junto con otra información.

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.

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.

Configuración de pruebas continuas de un extremo a otro en CI/CD