macroactive/playwright

Playwright Docker镜像文档

镜像概述

本镜像为Playwright的Docker化部署版本，Playwright是由微软开发的开源端到端测试框架，旨在简化Web应用的自动化测试流程。该镜像基于微软容器注册表（MCR）构建，提供了预配置的测试环境，方便快速集成到CI/CD流程或本地开发环境中。

项目官网：https://playwright.dev
源代码仓库：https://github.com/microsoft/playwright

核心功能与特性

• 跨浏览器支持：原生支持Chrome、Firefox、WebKit等主流浏览器，无需额外配置浏览器驱动
• 自动等待机制：智能等待页面元素加载，减少手动等待代码
• 多语言支持：兼容JavaScript/TypeScript、Python、Java、C#等多种编程语言
• 网络控制：支持请求拦截、模拟网络条件（如慢网络、离线状态）
• 多页面管理：可同时操作多个浏览器页面，支持页面间交互测试
• 截图与录屏：内置截图、录屏功能，便于测试结果分析

使用场景

• Web应用功能测试：验证用户交互流程（如登录、表单提交）的正确性
• UI兼容性测试：在不同浏览器环境下验证页面渲染一致性
• 自动化回归测试：集成到CI/CD pipeline，实现代码提交后的自动测试
• 性能测试辅助：模拟用户行为，收集页面加载性能数据
• 爬虫与数据采集：基于浏览器自动化实现动态内容抓取

使用方法

1. 拉取镜像

从MCR仓库拉取最新版本镜像：

bash
docker pull ***-mcr.xuanyuan.run/artifact/mar/playwright:latest

2. 基本运行示例

运行容器并执行测试脚本（假设本地测试文件位于./tests目录）：

bash
docker run -v $(pwd)/tests:/tests ***-mcr.xuanyuan.run/artifact/mar/playwright \
  npx playwright test /tests

3. 交互式使用

进入容器环境进行测试调试：

bash
docker run -it -v $(pwd)/tests:/tests ***-mcr.xuanyuan.run/artifact/mar/playwright /bin/bash

在容器内可直接使用playwright命令行工具，例如初始化测试项目：

bash
npx playwright init

4. Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  playwright:
    image: ***-mcr.xuanyuan.run/artifact/mar/playwright:latest
    volumes:
      - ./tests:/tests
    command: npx playwright test /tests
    environment:
      - PLAYWRIGHT_BROWSERS_PATH=/ms-playwright  # 指定浏览器二进制文件路径

启动服务：

bash
docker-compose up

配置说明

环境变量

• PLAYWRIGHT_BROWSERS_PATH：自定义浏览器驱动存放路径（默认：/ms-playwright）
• PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD：设置为1可跳过浏览器自动下载（适用于已预安装浏览器的场景）

常用命令

• npx playwright test：运行测试套件
• npx playwright codegen <url>：自动生成测试代码
• npx playwright show-report：查看测试报告

更多详细配置与使用方法请参考https://playwright.dev/docs%E3%80%82