gominerva/playwright Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

Playwright E2E测试镜像

镜像概述和主要用途

该Docker镜像集成Playwright自动化测试工具及运行端到端(E2E)测试所需的完整依赖，提供开箱即用的测试环境，简化Web应用自动化测试的部署与执行流程，适用于开发、测试及CI/CD场景。

核心功能和特性

• 预装Playwright：包含最新版Playwright，支持Chromium、Firefox、WebKit等主流浏览器
• 完整依赖集：集成运行测试所需的系统依赖（如字体、浏览器驱动、系统库等）
• 环境一致性：确保不同环境下测试结果一致，避免"环境差异"导致的测试问题
• 即开即用：无需额外配置即可启动测试，减少环境准备时间

使用场景和适用范围

• CI/CD集成：嵌入自动化构建流程，实现代码提交后的自动E2E测试验证
• 本地开发测试：为开发人员提供标准化测试环境，简化本地测试流程
• 跨浏览器兼容性测试：在同一环境中验证Web应用在不同浏览器的表现
• 自动化回归测试：定期执行关键业务流程测试，及时发现回归问题

使用方法和配置说明

基本使用（docker run）

bash
docker run -v $(pwd):/tests -w /tests playwright-e2e-image npx playwright test

• 参数说明：
  • -v $(pwd):/tests：将本地测试代码目录挂载到容器内/tests目录
  • -w /tests：设置工作目录为/tests
  • npx playwright test：执行Playwright测试命令

Docker Compose配置示例

yaml
version: '3'
services:
  e2e-test:
    image: playwright-e2e-image
    volumes:
      - ./test-suite:/tests  # 挂载本地测试代码
      - ./test-results:/tests/results  # 挂载测试结果目录
    working_dir: /tests
    command: npx playwright test --reporter=html  # 生成HTML测试报告

常用配置选项

• 测试文件挂载：通过-v参数挂载本地测试文件到容器内，确保测试代码可被执行
• 测试报告输出：使用--reporter参数指定报告格式（如html、json等），并挂载报告目录持久化结果
• 浏览器选择：通过Playwright配置文件指定测试浏览器，例如：

  javascript
  // playwright.config.js
  module.exports = {
    projects: [
      { name: 'chromium', use: { browserName: 'chromium' } },
      { name: 'firefox', use: { browserName: 'firefox' } },
    ],
  };
  

环境变量说明

• PLAYWRIGHT_BROWSERS_PATH：自定义浏览器二进制文件路径（默认使用容器内预安装路径）
• PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD：设置为1可跳过浏览器下载（适用于已预安装浏览器场景）
• NODE_ENV：设置运行环境，如test、ci等，可用于条件化测试配置