amplifylearning/node-chrome-selenium

镜像概述

该Docker镜像集成了Node.js、Chrome浏览器、ChromeDriver和Selenium，提供完整的自动化测试环境，可直接在容器内运行各类Web应用测试，无需在本地系统安装相关依赖，确保测试环境的一致性和可移植性。

核心功能和特性

• 完整测试栈：预安装Node.js（支持JavaScript测试脚本运行）、Chrome浏览器（提供真实浏览器环境）、ChromeDriver（与Chrome版本匹配的驱动程序）及Selenium（Web自动化测试框架）
• 即开即用：无需额外配置依赖关系，镜像启动后即可直接执行测试
• 环境一致性：避免因本地环境差异导致的测试结果不一致问题
• 轻量高效：优化的镜像结构，平衡功能完整性和资源占用

使用场景和适用范围

• 前端应用自动化测试（如React、Vue、Angular等框架项目）
• Web UI自动化测试和端到端（E2E）测试
• 持续集成/持续部署（CI/CD）流程中的自动化测试环节
• 跨平台测试环境快速搭建
• 开发团队共享统一的测试环境

使用方法和配置说明

基本使用（docker run）

挂载本地测试项目目录并执行测试命令：

bash
# 启动容器并运行测试
docker run -v /本地测试项目路径:/app -w /app [镜像名称] npm test

参数说明：

• -v /本地测试项目路径:/app：将本地测试代码目录挂载到容器内/app目录
• -w /app：设置工作目录为/app
• npm test：执行项目中的测试命令（可根据实际测试脚本调整）

环境变量配置

示例（启用有界面模式）：

bash
docker run -e CHROME_HEADLESS=false -v /本地测试项目路径:/app -w /app [镜像名称] npm test

docker-compose配置示例

创建docker-compose.yml文件：

yaml
version: '3.8'
services:
  test-runner:
    image: [镜像名称]
    volumes:
      - ./test-project:/app  # 挂载本地测试项目
    working_dir: /app
    environment:
      - CHROME_HEADLESS=true
      - NODE_ENV=test
    command: npm run test:e2e  # 执行自定义测试命令

启动命令：

bash
docker-compose up

注意事项

• 测试代码中Selenium配置需指向本地ChromeDriver，通常无需额外设置（镜像已预设路径）
• 如遇文件权限问题，可添加-u $(id -u):$(id -g)参数解决：

  bash
  docker run -u $(id -u):$(id -g) -v /本地测试项目路径:/app -w /app [镜像名称] npm test
  

• 建议根据测试需求选择特定版本标签的镜像，确保依赖版本兼容性
• 运行有界面模式（CHROME_HEADLESS=false）时，需配置X11转发（适用于Linux/macOS）或使用VNC连接（Windows）