Playwright in Docker Containers

Running Playwright tests in Docker containers provides a powerful, consistent environment for cross-platform test execution. By containerizing your Playwright test suite, you can eliminate "it works on my machine" problems and create reproducible testing environments across different development and CI/CD platforms.

Prerequisites#

Before diving into Playwright and Docker integration, ensure you have the following:

• Docker Desktop (version 20.10.17 or later)
• Node.js (version 16.x or higher)
• npm (version 8.x or higher)
• Basic understanding of Docker and containerization
• Familiarity with TypeScript and Playwright
• Git for version control

Estimated Setup Time: 30-45 minutes

Why Use Docker for Playwright Tests?#

Docker containers offer several significant advantages for test automation:

Consistent Environment#

Containers ensure identical test environments across different machines and CI/CD platforms. Every team member runs tests in the same predictable setup.

Isolation and Reproducibility#

Each test run happens in a clean, isolated container, preventing interference between test executions and system-level dependencies.

Scalability#

Docker makes it easy to parallelize tests across multiple containers, dramatically reducing overall test execution time.

Creating a Dockerized Playwright Test Setup#

Let's create a comprehensive Playwright Docker configuration step by step:

Dockerfile Configuration#

# Use official Playwright base image
FROM mcr.microsoft.com/playwright:v1.35.0-jammy

# Set working directory
WORKDIR /app

# Copy package files
COPY package*.json ./

# Install dependencies
RUN npm ci

# Copy test files
COPY . .

# Default command to run tests
CMD ["npm", "test"]

# Use official Playwright base image
FROM mcr.microsoft.com/playwright:v1.35.0-jammy

# Set working directory
WORKDIR /app

# Copy package files
COPY package*.json ./

# Install dependencies
RUN npm ci

# Copy test files
COPY . .

# Default command to run tests
CMD ["npm", "test"]

Docker Compose Integration#

version: "3.8"
services:
  playwright-tests:
    build: .
    volumes:
      - ./:/app
    environment:
      - CI=true

version: "3.8"
services:
  playwright-tests:
    build: .
    volumes:
      - ./:/app
    environment:
      - CI=true

TypeScript Test Example#

import { test, expect } from "@playwright/test";

test("login functionality", async ({ page }) => {
  try {
    await page.goto("https://example.com/login");

    // Realistic login scenario
    await page.fill("#username", "testuser");
    await page.fill("#password", "securePassword123");

    await page.click('button[type="submit"]');

    // Assert successful login
    await expect(page).toHaveURL(/dashboard/);
  } catch (error) {
    console.error("Login test failed:", error);
    throw error;
  }
});

import { test, expect } from "@playwright/test";

test("login functionality", async ({ page }) => {
  try {
    await page.goto("https://example.com/login");

    // Realistic login scenario
    await page.fill("#username", "testuser");
    await page.fill("#password", "securePassword123");

    await page.click('button[type="submit"]');

    // Assert successful login
    await expect(page).toHaveURL(/dashboard/);
  } catch (error) {
    console.error("Login test failed:", error);
    throw error;
  }
});

Performance Optimization Strategies#

1. Leverage Alpine-based images
2. Use .dockerignore to exclude unnecessary files
3. Implement layer caching
4. Minimize layer count in Dockerfile

Troubleshooting Common Docker-Playwright Issues#

Best Practices#

• Always specify explicit image versions
• Use multi-stage builds
• Implement comprehensive error handling
• Keep containers lightweight
• Use environment-specific configurations
• Regularly update Playwright and browser versions

Next Steps#

1. Explore GitHub Actions integration with Playwright Docker
2. Implement parallel test execution
3. Learn advanced Docker networking for complex test scenarios
4. Investigate container orchestration with Kubernetes
5. Set up comprehensive CI/CD pipelines

By mastering Playwright in Docker containers, you'll create more reliable, consistent, and scalable test automation strategies that work seamlessly across different environments.