Playwright configuración de múltiples proyectos (Projects)
Este capítulo explica cómo configurar Projects para ejecutar pruebas en múltiples navegadores y dispositivos, así como el uso de dependencias de proyectos.
¿Qué es un Project?
En Playwright, un Project representa un grupode pruebas que se ejecutan bajo una configuración específica de navegador y dispositivo.
Configurando múltiples Projects, puedes ejecutar el mismo conjunto de código de pruebas en Chromium, Firefox, WebKit y dispositivos móviles.
Configuración básica de múltiples navegadores
Ejemplo
import { defineConfig, devices } from '@playwright/test';
export default defineConfig({
projects: [
{
name: 'chromium',
use: { ...devices['Desktop Chrome'] },
},
{
name: 'firefox',
use: { ...devices['Desktop Firefox'] },
},
{
name: 'webkit',
use: { ...devices['Desktop Safari'] },
},
],
});
Ejecutar las pruebas de un navegador específico:
# 仅在 Chromium 上运行 npx playwright test --project=chromium # 在 Chromium 和 Firefox 上运行 npx playwright test --project=chromium --project=firefox
devices: preajustes de dispositivos
Playwright incluye una gran cantidad de preajustes de dispositivos (de@playwright/testdedevices), que simulan el viewport, el User-Agent, la relación de píxeles, etc. de dispositivos reales.
Ejemplo
export default defineConfig({
projects: [
// Escritorio
{
name: 'desktop-chrome',
use: { ...devices['Desktop Chrome'] },
},
// Móvil
{
name: 'mobile-iphone',
use: { ...devices['iPhone 15'] },
},
{
name: 'mobile-pixel',
use: { ...devices['Pixel 7'] },
},
// Tableta
{
name: 'tablet-ipad',
use: { ...devices['iPad Pro'] },
},
],
});
Preajustes de dispositivos de uso común:
| Nombre del preajuste | Tipo de dispositivo | Tamaño del viewport |
|---|---|---|
Desktop Chrome | Escritorio | 1280×720 |
Desktop Firefox | Escritorio | 1280×720 |
Desktop Safari | Escritorio | 1280×720 |
iPhone 15 | Móvil | 393×852 |
Pixel 7 | Móvil | 412×915 |
iPad Pro | Tableta | 1024×1366 |
Configuración personalizada de proyectos
Puedes, dentro del Project,usesobrescribir la configuración global:
Ejemplo
use: {
baseURL: 'http://localhost:3000',
locale: 'zh-CN',
timezone: 'Asia/Shanghai',
},
projects: [
{
name: 'chromium-desktop',
use: {
...devices['Desktop Chrome'],
// Heredar la locale y la timezone globales
},
},
{
name: 'chromium-mobile',
use: {
...devices['Pixel 7'],
// Sobrescribir al entorno en inglés
locale: 'en-US',
timezone: 'America/New_York',
},
},
// Probar el modo oscuro
{
name: 'chromium-dark',
use: {
...devices['Desktop Chrome'],
colorScheme: 'dark',
},
},
// Probar el modo claro
{
name: 'chromium-light',
use: {
...devices['Desktop Chrome'],
colorScheme: 'light',
},
},
],
});
Dependencias de proyectos (dependencies)
Un proyecto puede depender de otro, asegurando que el proyecto del que depende se ejecute primero.
El uso más común es que el proyecto Setup (autenticación) se ejecute primero, y que otros proyectos dependan de él.
Ejemplo
projects: [
// Proyecto Setup — genera el estado de autenticación
{
name: 'setup',
testMatch: /auth\.setup\.ts/,
},
// El proyecto de pruebas depende de setup, garantizando que el estado de autenticación se genere primero.
{
name: 'chromium',
use: {
...devices['Desktop Chrome'],
storageState: 'playwright/.auth/user.json',
},
dependencies: ['setup'],
},
{
name: 'firefox',
use: {
...devices['Desktop Firefox'],
storageState: 'playwright/.auth/user.json',
},
dependencies: ['setup'],
},
],
});
setupEl proyecto solo se ejecuta una vez, y todos los proyectos que dependen de él esperarán a que termine antes de iniciarse.
Compartir configuración mediante testProject
Si deseas que varios proyectos compartan configuración sin repetirla, puedes extraer un proyecto base:
Ejemplo
import { defineConfig, devices } from '@playwright/test';
const desktopProject = {
use: {
...devices['Desktop Chrome'],
viewport: { width: 1920, height: 1080 },
locale: 'zh-CN',
},
} as const;
export default defineConfig({
projects: [
{
name: 'chromium',
...desktopProject, // Hereda la configuración de desktopProject
use: {
...desktopProject.use, // Primero heredar
browserName: 'chromium', // Luego sobrescribir
},
},
{
name: 'firefox',
use: {
...devices['Desktop Firefox'],
// Sobrescribir viewport y locale
viewport: { width: 1920, height: 1080 },
locale: 'zh-CN',
},
},
],
});