jamesmortensen/webkitwebdriver-epiphany

Docker上的Epiphany和WebKitWebDriver

镜像概述和主要用途

在Safari中进行跨浏览器测试需要昂贵的Apple硬件，且在非macOS操作系统上难以自动化。但核心在于浏览器UI下的浏览器引擎。虽然无法在Linux上运行Safari，但有一些基于WebKit的替代方案可在Linux上运行，它们使用相同的底层浏览器引擎WebKit。本镜像提供了在Linux环境下运行WebKit引擎浏览器（Epiphany和MiniBrowser）的能力，支持自动化测试。

核心功能和特性

容器启动时运行以下服务并监听相应端口：

• xvfb和fluxbox
• VNC - 5900端口
• noVNC - 7900端口
• WebKitWebBrowser - 4444端口

注意：VNC/noVNC密码为'secret'

使用场景和适用范围

• 需要在Linux环境下进行基于WebKit引擎的浏览器测试
• 自动化Selenium测试，特别是针对WebKit内核的兼容性测试
• 手动测试Web应用在WebKit浏览器中的表现

使用方法和配置说明

启动容器

bash
docker run --rm -it --shm-size=3g -p 7900:7900 -p 4444:4444 -p 5900:5900 jamesmortensen/webkitwebdriver-epiphany:latest

访问桌面环境

• 通过浏览器访问 http://localhost:7900 查看Debian桌面
• 或通过VNCViewer连接到 127.0.0.1:5900

Selenium测试配置

WebdriverIO配置示例（针对Epiphany浏览器）

javascript
capabilities: [{
    maxInstances: 1,
    browserName: 'Epiphany',
    browserVersion: '3.38.2',
    'webkitgtk:browserOptions': {
        args: [
            '--automation-mode'
        ],
        binary: 'epiphany'
    }
}],

WebdriverIO配置示例（针对WebKitGTK2 MiniBrowser）

WebKitWebDriver包还捆绑了MiniBrowser，这是一个轻量级的WebKitGTK2构建版本。

javascript
capabilities: [{
    maxInstances: 1,
    browserName: 'MiniBrowser',
    browserVersion: '2.34.1',
    'webkitgtk:browserOptions': {
        args: [
            '--automation'
        ],
        binary: `/usr/lib/${ARCH}-linux-gnu/webkit2gtk-4.0/MiniBrowser`
    }
}],

注意：${ARCH}必须根据您的平台替换为x86_64或arm64，因为MiniBrowser的位置因架构而异。不确定时，可在终端中输入arch查看。arm64或aarch64表示运行在arm64平台上。

查看测试过程

要在测试运行时查看浏览器中的情况，在浏览器中导航至 http://localhost:7900。noVNC的密码为"secret"。

手动测试

启动Epiphany或MiniBrowser

1. 通过VNC/noVNC进入容器，右键点击并选择"Application -> Shells -> Bash"打开终端
2. 输入epiphany并按Enter启动Epiphany浏览器
3. 输入/usr/lib/x86_64-linux-gnu/webkit2gtk-4.0/MiniBrowser启动MiniBrowser

注意：如果运行在arm64平台（如Mac M1），将x86_64替换为aarch64。

更多信息：https://github.com/jamesmortensen/WebKitWebDriver-Browser-Images