stakater/protractor

Protractor + 无头Chrome Docker镜像

镜像概述

本镜像集成无头Chrome与Protractor，专为AngularJS应用的端到端（E2E）测试设计。它可直接替代本地安装的Protractor，通过xvfb运行真实Chrome浏览器的无头模式，避免PhantomJS的稳定性缺陷（官方已不推荐使用PhantomJS）。

核心功能

• 基于真实Chrome浏览器执行测试，结果更可靠
• 支持多种Chrome版本标签（如chrome59、chrome58等）
• 可自定义屏幕分辨率与颜色深度
• 兼容Docker 1.10+的--shm-size参数，解决内存不足导致的页面崩溃问题
• 自动加载项目目录下的node_modules依赖（如Jasmine、Mocha）

使用场景

• CI/CD流水线中的自动化E2E测试
• 本地开发环境快速验证AngularJS应用功能
• 跨Chrome版本的兼容性测试场景

配置说明

基础运行命令

bash
docker run -it --privileged --rm --net=host -v /dev/shm:/dev/shm -v $(pwd):/protractor stakater/protractor [protractor选项]

Docker 1.10+优化命令

bash
docker run -it --privileged --rm --net=host --shm-size 2g -v $(pwd):/protractor stakater/protractor [protractor选项]

自定义屏幕分辨率

通过SCREEN_RES环境变量设置（默认1280x1024x24）：

bash
docker run -it --privileged --rm --net=host -e SCREEN_RES=1920x1080x24 -v /dev/shm:/dev/shm -v $(pwd):/protractor stakater/protractor [protractor选项]

参数解释

• --privileged：满足Chrome沙箱运行需求，赋予容器接近主机的权限
• --net=host：测试目标为宿主机localhost时，共享主机网络栈
• --shm-size：设置共享内存大小（推荐2g），避免Chrome页面崩溃
• -v $(pwd):/protractor：挂载当前目录到容器测试工作目录

便捷脚本示例

创建/usr/local/bin/protractor-headless脚本：

bash
#!/bin/bash
docker run -it --privileged --rm --net=host --shm-size 2g -v $(pwd):/protractor stakater/protractor $@

赋予执行权限后，可直接运行：

bash
protractor-headless [protractor选项]