Robotframework-Puppeteer-Percy

机器人框架 Puppeteer的Percy视觉测试。

关键字文档

有关keyword documentation可用的关键字和有关该库的更多信息，请参阅。

需要 [robotframework-puppeteer]]( https://github.com/qahive/robotframework-puppeteer ) 版本 2 或以上。

安装

推荐的安装方法是使用 pip：

pip install --upgrade robotframework-puppeteer-percy

或者通过运行以下命令手动安装

pip install -r requirements.txt
python setup.py install

用法

(1) 到percy.io注册新账号

(2) 创建新项目并保存 PERCY_TOKEN

(3) 运行导出令牌

• 窗户：set PERCY_TOKEN=<your percy token>
• Linux： export PERCY_TOKEN=<your percy token>

(4) 创建文件名 quick-start.robot，内容如下：

*** Settings ***
Library    PuppeteerLibrary
Library    PuppeteerPercy
Test Teardown    Close Browser


*** Test Cases ***
Capture home page screenshot
    ${HEADLESS}     Get variable value    ${HEADLESS}    ${False}
    &{options} =    create dictionary   headless=${HEADLESS}
    Open browser    http://example.com  options=${options}
    Maximize Browser Window
    Percy Snapshot    Home page

(5) 使用以下命令运行机器人脚本：

npx percy exec -- robot quick-start.robot

npx percy exec测试完成后将启动 percy 代理并自动停止

局限性

• 不支持限制其他站点资源文件的网站。

常问问题

• 快照抛出错误ElementHandleError: Evaluation failed: Event。您的网站不允许注入第 3 方 javascript。需要要求开发人员允许执行 localhost javascript。

发展

生成更新关键字文档

python -m robot.libdoc -f html PuppeteerPercy docs/PuppeteerPercy.html