strategicblue/clj-deps-playwright

Playwright + Clojure 集成Docker镜像

镜像概述

本镜像整合微软Playwright自动化测试框架与Clojure开发工具链，为Clojure开发者提供一站式自动化测试与开发环境。通过预配置Playwright（含浏览器驱动）及Clojure工具（Leiningen、Clojure CLI），实现环境隔离与快速部署，适用于Clojure应用的端到端测试、UI交互自动化及CI/CD流程集成。

核心功能与特性

Playwright核心能力

• 跨浏览器测试：集成Chromium、Firefox、WebKit浏览器及对应驱动，支持多浏览器兼容性测试
• 自动化控制：提供API用于页面导航、元素交互、网络请求模拟等端到端测试操作
• 多场景覆盖：支持无头模式运行、截图/录屏、测试报告生成等测试全流程需求

Clojure工具链

• 构建工具：预装Leiningen及Clojure CLI（clj），支持Clojure项目构建与依赖管理
• 测试框架：集成clojure.test标准测试库，兼容Clojure生态测试工具（如eftest）
• interop支持：通过Java interop无缝调用Playwright Java API，适配Clojure开发范式

环境特性

• 即开即用：预装所有依赖组件，拉取镜像后无需额外配置即可执行测试
• 环境隔离：容器化运行避免本地环境冲突，保证测试一致性与可重复性
• 轻量设计：基于Debian slim基础镜像，平衡功能完整性与镜像体积

使用场景

• Clojure Web应用端到端测试：验证用户交互全流程（如登录、表单提交、数据展示）
• UI组件自动化测试：针对前端组件（React/Vue）编写Clojure测试脚本，验证渲染逻辑
• CI/CD集成：嵌入持续集成流程，在代码提交或部署前自动执行测试用例
• 团队协作环境：统一开发与测试环境，新成员无需手动配置即可参与开发

使用方法

基础运行命令

bash
# 拉取镜像（假设镜像标签为playwright-clojure:latest）
docker pull playwright-clojure:latest

# 运行容器并挂载Clojure项目目录执行测试
docker run -it --rm \
  -v $(pwd):/app \
  -w /app \
  playwright-clojure:latest \
  lein test  # 或使用clj -M:test执行测试（根据项目构建工具调整）

测试用例示例

在Clojure项目中编写Playwright测试用例（通过Java interop调用）：

clojure
(ns example.e2e-test
  (:require [clojure.test :refer :all])
  (:import [com.microsoft.playwright Playwright Browser Page]))

(deftest ^:e2e basic-navigation-test
  (with-open [playwright (Playwright/create)
              browser (.chromium playwright)
              page (.newPage browser)]
    (.goto page "https://example.com")
    (is (= "Example Domain" (.title page)))
    (.click page "a")  ; 模拟点击链接
    (is (.contains (.url page) "iana.org"))))

执行测试：

bash
docker run -it --rm \
  -v $(pwd):/app \
  -w /app \
  playwright-clojure:latest \
  clj -M:test  # 假设项目deps.edn中配置了:test别名

Docker Compose配置示例

创建docker-compose.yml：

yaml
version: '3.8'
services:
  e2e-test:
    image: playwright-clojure:latest
    volumes:
      - ./:/app
    working_dir: /app
    command: lein test :e2e  # 执行标记为:e2e的测试用例
    environment:
      - TEST_REPORT_PATH=/app/target/reports  # 测试报告输出目录
      - PLAYWRIGHT_BROWSER=firefox  # 指定使用Firefox浏览器
      - HEADLESS=true  # 无头模式运行（适合CI环境）

启动测试：

bash
docker-compose up e2e-test

环境变量说明

注意事项

• 首次运行特定浏览器版本可能需要补充驱动，可通过容器内执行playwright install [browser]完成
• 挂载项目目录时确保本地用户ID与容器内用户ID一致，避免文件权限问题（可通过-u $(id -u):$(id -g)参数调整）
• 如需持久化测试报告或日志，建议将对应目录挂载为本地卷