rochdev/playwright-tools

playwright-tools

镜像概述和主要用途

playwright-tools是一个基于playwright/chromium构建的Docker镜像，在保留Playwright Chromium浏览器自动化能力的基础上，额外集成了Bun、Git和Yarn工具。该镜像适用于需要结合浏览器自动化测试、版本控制及现代JavaScript包管理的开发和测试场景。

核心功能和特性

基础能力

• 继承playwright/chromium的全部功能，包含Chromium浏览器及Playwright测试框架，支持网页自动化、截图、PDF生成等操作。

额外集成工具

• Bun：高性能JavaScript运行时和包管理器，支持快速安装依赖、运行脚本，兼容npm/yarn生态。
• Git：分布式版本控制系统，支持代码克隆、提交、分支管理等版本控制操作。
• Yarn：经典JavaScript包管理器，提供可靠的依赖安装和版本锁定能力。

使用场景和适用范围

• 前端自动化测试：结合Playwright进行浏览器自动化测试，同时使用Git管理测试代码版本，Bun/Yarn管理测试依赖。
• CI/CD流程集成：在持续集成环境中执行自动化测试、代码拉取及依赖安装，简化环境配置。
• 快速原型开发：临时启动包含浏览器环境、版本控制和包管理工具的容器，进行快速开发验证。

使用方法和配置说明

基本使用

通过以下命令启动交互式容器，默认进入bash终端：

bash
docker run -it --rm docker.xuanyuan.run/playwright-tools

挂载本地目录

如需使用本地项目文件，可通过-v参数挂载目录（例如挂载当前目录到容器内/app路径）：

bash
docker run -it --rm -v $(pwd):/app docker.xuanyuan.run/playwright-tools

执行自动化测试示例

在容器内可直接使用Playwright运行测试脚本，结合Git拉取代码和Bun安装依赖：

bash
# 克隆代码仓库
git clone https://github.com/example/frontend-test.git /app
cd /app

# 使用Bun安装依赖
bun install

# 运行Playwright测试
npx playwright test

Docker Compose配置示例

创建docker-compose.yml文件，定义服务配置：

yaml
version: '3'
services:
  playwright-test:
    image: docker.xuanyuan.run/playwright-tools
    volumes:
      - ./:/app
    working_dir: /app
    command: sh -c "git pull && bun install && npx playwright test"

启动服务：

bash
docker-compose up

配置说明

该镜像默认继承playwright/chromium的配置，无额外环境变量或配置文件需求。如需自定义浏览器参数、工具版本等，可通过Dockerfile基于此镜像进一步构建：

dockerfile
FROM playwright-tools
# 自定义配置示例：安装额外依赖
RUN bun add -g some-package