Versión preliminar de Microsoft Playwright Testing

Microsoft Playwright Testing es un servicio de Azure totalmente administrado que usa la nube para permitirle ejecutar pruebas de Playwright con una paralelización mucho mayor en diferentes combinaciones de explorador del sistema operativo simultáneamente. Esto significa ejecuciones de pruebas más rápidas con una cobertura de escenario más amplia, lo que ayuda a acelerar la entrega de características sin sacrificar la calidad. El servicio también le permite publicar resultados de prueba y artefactos relacionados con el servicio y verlos en el portal de servicios, lo que permite una solución de problemas más rápida y sencilla. Con el servicio Microsoft Playwright Testing, puede publicar características de forma más rápida y segura.

¿Listo para empezar? Vaya a nuestra guía de inicio rápido de !

Vínculos útiles

• Inicio rápido: Ejecución de pruebas de un extremo a otro a escala
• Inicio rápido: Configuración de pruebas continuas de un extremo a otro en distintos exploradores y sistemas operativos
• Explorar características y ventajas
• documentación de
• de precios
• Compartir comentarios

Comenzar

Siga estos pasos para ejecutar el conjunto de pruebas de Playwright existente con el servicio.

Prerrequisitos

• Una cuenta de Azure con una suscripción activa. Si no tiene una suscripción de Azure, cree una cuenta gratuita antes de comenzar.
• A su cuenta de Azure se le debe asignar elpropietario de , colaboradoro uno de los roles de administrador clásico .
• de la CLI de Azure debe instalarse en la máquina desde donde se ejecutan las pruebas de Playwright.

Creación de un área de trabajo

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

2. Cree el área de trabajo.

   

   Campo	Descripción
   de nombre del área de trabajo de	Un nombre único para identificar el área de trabajo. El nombre no puede contener caracteres especiales ni espacios en blanco.
   de suscripción de Azure	Seleccione una suscripción de Azure en la que quiera crear el área de trabajo.
   región de	Aquí es donde los datos de ejecución de pruebas se almacenarán para el área de trabajo.

Si no ve esta pantalla, seleccione un área de trabajo existente y vaya a la sección siguiente.

Instalación del paquete microsoft Playwright Testing

1. Ejecute este comando para instalar el paquete de servicio.

   npm init @azure/microsoft-playwright-testing
   

La instalación del paquete de servicio creará un archivo de configuración de servicio denominado playwright.service.config.ts

La configuración del servicio sirve para:

• Dirigir y autenticar Playwright en el servicio Microsoft Playwright Testing.
• Agregue los informes de Microsoft Playwright Testing a la configuración.
• Invalide los tiempos de espera de las operaciones de servicio, si es necesario.

Asegúrese de que el proyecto usa @playwright/test versión 1.47 o posterior.

Obtención del punto de conexión de la región

1. En el portal de Playwright, copie el comando en Agregar punto de conexión de región en la configuración.

   de punto de conexión del área de trabajo

   La dirección URL del punto de conexión corresponde a la región del área de trabajo. Es posible que vea una dirección URL de punto de conexión diferente en el portal de Playwright, en función de la región que haya seleccionado al crear el área de trabajo.

Configuración del entorno

Asegúrese de que la PLAYWRIGHT_SERVICE_URL que obtuvo en el paso anterior está disponible en su entorno.

Se recomienda usar dotenv módulo para administrar el entorno. Con dotenv usará el archivo .env para definir las variables de entorno.

No olvide agregar .env archivo a su archivo .gitignore para no filtrar los secretos.

npm i --save-dev dotenv

archivo .env

PLAYWRIGHT_SERVICE_URL=wss://eastus.api.playwright.microsoft.com/accounts/workspace-id/browsers

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.

El identificador de Microsoft Entra 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 el identificador de Entra de Microsoft

Microsoft Entra ID es la autenticación predeterminada y recomendada para el servicio. Desde la máquina de desarrollo local, puede usar 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 Búsqueda del 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 identificador de Entra de Microsoft 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. Para usar la autenticación basada en tokens de acceso, Habilitar la autenticación basada en tokens de acceso

2. Configuración de la autenticación mediante tokens de acceso

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

NOTA: Para usar microsoft Playwright Testing en canalizaciones de CI, debe configurar la autenticación con el servicio desde la canalización, consulte configurar pruebas continuas de un extremo a otro en distintos exploradores y sistemas operativos

Ejecución de las pruebas

Ejecute pruebas de Playwright en exploradores administrados por el servicio mediante la configuración que creó anteriormente.

npx playwright test --config=playwright.service.config.ts --workers=20

Pasos siguientes

• Ejecute pruebas en una canalización de CI/CD de .

• Aprenda a administrar el acceso al área de trabajo creada.

• Experimente con un número diferente de trabajos para determinar la configuración óptima del conjunto de pruebas.

Contribuyendo

Este proyecto da la bienvenida a las contribuciones y sugerencias. La mayoría de las contribuciones requieren que acepte un Contrato de licencia de colaborador (CLA) declarando que tiene derecho a, y en realidad, concedanos los derechos para usar su contribución. Para obtener más información, visite https://cla.opensource.microsoft.com.

Al enviar una solicitud de incorporación de cambios, un bot CLA determinará automáticamente si necesita proporcionar un CLA y decorar la solicitud de incorporación de cambios adecuadamente (por ejemplo, comprobación de estado, comentario). Solo tiene que seguir las instrucciones proporcionadas por el bot. Solo tendrá que hacerlo una vez en todos los repositorios mediante nuestro CLA.

Este proyecto ha adoptado el código abierto de conducta de Microsoft. Para obtener más información, consulte el de preguntas más frecuentes sobre el código de conducta de o póngase en contacto con con preguntas o comentarios adicionales.

Marcas

Este proyecto puede contener marcas comerciales o logotipos para proyectos, productos o servicios. El uso autorizado de marcas comerciales o logotipos de Microsoft está sujeto a y debe seguir las Directrices de marca comercial de Microsoft &. El uso de marcas comerciales o logotipos de Microsoft en versiones modificadas de este proyecto no debe causar confusión ni implicar el patrocinio de Microsoft. Cualquier uso de marcas o logotipos de terceros está sujeto a las directivas de terceros.