ermishincompliance/playwright

Playwright 1.45.1-jammy 镜像文档

镜像概述

Playwright 1.45.1-jammy是基于Ubuntu 22.04（Jammy Jellyfish）构建的Docker镜像，集成了Playwright 1.45.1自动化测试框架，并预安装Google Chrome和Microsoft Edge浏览器。该镜像旨在提供开箱即用的Web自动化测试环境，消除浏览器及驱动的手动配置步骤，简化测试流程。

核心功能与特性

• Playwright 1.45.1：集成最新稳定版Playwright，支持JavaScript/TypeScript、Python、Java、C#等多语言自动化测试
• Ubuntu 22.04基础：基于长期支持版(LTS)操作系统，提供稳定可靠的运行环境
• 预安装浏览器：包含Google Chrome和Microsoft Edge浏览器，满足主流浏览器测试需求
• 零配置启动：无需手动安装浏览器驱动，拉取镜像后可直接执行测试脚本
• 跨平台兼容：可在Linux、macOS、Windows等支持Docker的环境中运行

使用场景与适用范围

• Web应用自动化测试：前端功能测试、UI交互测试、端到端流程验证
• 跨浏览器兼容性测试：在Chrome和Edge环境中验证网页渲染及功能一致性
• 网页数据采集：利用Playwright的自动化能力进行结构化数据提取
• CI/CD集成：作为持续集成流程的测试环境，自动化执行测试用例
• 开发环境标准化：统一团队测试环境，避免"在我机器上能运行"的问题

使用方法与配置说明

基本使用（Docker Run）

验证镜像版本

bash
docker run -it --rm mcr.microsoft.com/playwright:v1.45.1-jammy playwright --version

运行测试脚本

将本地测试脚本目录挂载到容器中执行：

bash
# 假设本地测试脚本位于 ./tests 目录
docker run -it --rm \
  -v $(pwd)/tests:/workspace/tests \
  -w /workspace \
  mcr.microsoft.com/playwright:v1.45.1-jammy \
  node tests/example-test.js

Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: '3.8'
services:
  playwright-test:
    image: mcr.microsoft.com/playwright:v1.45.1-jammy
    volumes:
      - ./tests:/workspace/tests  # 挂载本地测试脚本
      - ./reports:/workspace/reports  # 挂载测试报告目录
    working_dir: /workspace
    command: ["node", "tests/run-all-tests.js"]
    environment:
      - NODE_ENV=test
      - TEST_REPORT_PATH=/workspace/reports

启动测试服务：

bash
docker-compose up

高级配置

自定义浏览器路径

如需指定浏览器可执行路径，可通过Playwright配置文件设置：

javascript
// playwright.config.js
module.exports = {
  use: {
    browserName: 'chromium',  // 或 'msedge'
    executablePath: '/usr/bin/google-chrome'  // Chrome路径
    // executablePath: '/usr/bin/microsoft-edge'  // Edge路径
  }
};

无头模式运行

默认以无头模式运行浏览器，如需可视化界面，可添加--headed参数：

bash
docker run -it --rm \
  -v $(pwd)/tests:/workspace/tests \
  mcr.microsoft.com/playwright:v1.45.1-jammy \
  playwright test --headed

注意事项

• 确保Docker引擎版本≥19.03，以支持完整的容器功能
• 挂载本地目录时注意文件权限，避免因权限不足导致脚本无法读取
• 如需使用Firefox浏览器，需选择包含Firefox的Playwright镜像变体
• 在CI环境中使用时，建议设置适当的资源限制（CPU/内存）以确保测试稳定性