docksal/backstopjs

BackstopJS Docker镜像

一个独立的Docker镜像，用于运行https://github.com/garris/BackstopJS%EF%BC%8C%E6%97%A0%E9%9C%80%E5%A4%96%E9%83%A8%E4%BE%9D%E8%B5%96%E3%80%82

核心功能和特性

• https://github.com/garris/BackstopJS
• PhantomJS
• SlimerJS（含Firefox ESR）
• CasperJS
• Chromium

版本信息

• docksal/backstopjs:2 - BackstopJS 2.x（旧版）
• docksal/backstopjs（docksal/backstopjs:3）- BackstopJS 3，支持Chrome Headless

使用方法

将此镜像当作可执行程序使用。工作目录需挂载到容器内的/src路径。

基础使用

bash
$ docker run --rm -v $(pwd):/src docksal/backstopjs --version
BackstopJS v3.0.25
BackstopJS 3.0.25

设置别名（推荐）

在.bashrc、.zshrc等配置文件中添加别名，方便使用：

bash
alias backstop='docker run --rm -v $(pwd):/src docksal/backstopjs "$@"'

重启终端或打开新终端后即可直接使用：

bash
$ backstop --version
BackstopJS v3.0.25
BackstopJS 3.0.25

测试示例

BackstopJS 2.x

bash
docker run --rm -v $(pwd):/src docksal/backstopjs genConfig
docker run --rm -v $(pwd):/src docksal/backstopjs reference
docker run --rm -v $(pwd):/src docksal/backstopjs test

BackstopJS 3.x

bash
docker run --rm -v $(pwd):/src docksal/backstopjs init
docker run --rm -v $(pwd):/src docksal/backstopjs test
docker run --rm -v $(pwd):/src docksal/backstopjs approve
docker run --rm -v $(pwd):/src docksal/backstopjs test

浏览器引擎配置

默认情况下，BackstopJS使用Chrome Headless进行截图。也可通过在backstop.json中设置"engine": "phantomjs"或"engine": "slimerjs"分别使用PhantomJS或SlimerJS/Firefox。

容器内已预装PhantomJS、SlimerJS和Firefox ESR（扩展支持版本）。

限制说明

• backstop openReport暂不支持，需通过运行Web服务器查看BackstopJS生成的HTML报告。
• 运行SlimerJS时，容器运行用户必须有主目录才能正常启动Slimer。可通过设置HOME环境变量解决：

  bash
  docker run --rm --user 1000 -e HOME=/tmp/home docksal/backstopjs test
  

调试方法

通过以下命令可在容器内启动bash会话：

bash
docker run --rm -v $(pwd):/src -it --entrypoint=bash docksal/backstopjs