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

// Ruta del archivo: playwright.config.ts
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

import { defineConfig, devices } from '@playwright/test';

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 preajusteTipo de dispositivoTamaño del viewport
Desktop ChromeEscritorio1280×720
Desktop FirefoxEscritorio1280×720
Desktop SafariEscritorio1280×720
iPhone 15Móvil393×852
Pixel 7Móvil412×915
iPad ProTableta1024×1366

Configuración personalizada de proyectos

Puedes, dentro del Project,usesobrescribir la configuración global:

Ejemplo

export default defineConfig({
  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

export default defineConfig({
  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

// Ruta del archivo: playwright.config.ts
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',
      },
    },
  ],
});
Otras extensiones