README

Behat 3 扩展，可从测试结果生成惊人的报告。

Twig 报告

实时演示可在： http://www.bug-hunter.nl/testreport/index.html (每日生成)

功能

• 在失败的步骤上创建截图。
• 在结果步骤（Then）上创建截图。
• 在失败的步骤上保存源代码到 html（易于调试）。
• 可以在测试报告中设置项目标题、描述和标志。
• 打印报告按钮
• 按成功或失败的场景过滤

很简单！！

• 此工具可以使用 composer 轻松安装。
• 在 behat.yml 文件中定义格式化器
• 在 behat.yml 文件中修改设置
• 可选：更新 FeatureContext.php 以生成截图。

安装

先决条件

此扩展需要

• PHP 5.3.x 或更高版本
• Behat 3.x 或更高版本

通过 composer

保持测试套件更新的最简单方法是使用 Composer

使用 composer 安装

$ composer require --dev elkan/behatformatter

使用 composer.json 安装

将 BehatFormatter 添加到 composer.json 中依赖项列表。

{
    "require": {
        "behat/behat": "3.*@stable",
        "elkan/behatformatter": "v1.0.*",
    },
    "minimum-stability": "dev",
    "config": {
        "bin-dir": "bin/"
    }
}

然后只需使用 composer 安装它

$ composer install --dev --prefer-dist

您可以在其 官方网站 上了解有关 Composer 的更多信息。

基本用法

通过在 behat.yml 中指定其类来激活扩展

# behat.yml
default:
  suites:
    ... # All your awesome suites come here
  
  formatters: 
    html:
      output_path: %paths.base%/build/
      
  extensions:
    elkan\BehatFormatter\BehatFormatterExtension:
      projectName: BehatTest
      name: html
      renderer: Twig,Behat2
      file_name: Index
      print_args: true
      print_outp: true
      loop_break: true
      show_tags: true

配置

• output_path - Behat 将保存 HTML 报告的位置。此处定义的路径相对于 %paths.base%，如果省略，则默认设置为相同的路径。
• renderer - Behat 将用于渲染的引擎，因此 Behat 应输出的报告格式类型（允许多个报告格式，用逗号分隔）。允许的值有
• Behat2 - 生成类似于 Behat 2 生成的 HTML 报告。
• Twig - 基于 Twig 的新颖且更现代的格式。
• Minimal - 超级简约的 HTML 输出。
• file_name - （可选）Behat 将使用固定文件名，并在每次构建后覆盖相同的文件。默认情况下，Behat 将使用随机名称创建新的 HTML 文件（例如，“renderer name”_“date hour”）。
• projectName - （可选）为报告提供一个页面标题。
• projectDescription - （可选）在测试报告中包含项目描述。
• projectImage - （可选）在测试报告中包含项目图像。
• print_args - （可选）如果设置为 true，Behat 将将每个步骤的所有参数添加到报告中。（例如，表格）
• print_outp - （可选）如果设置为 true，Behat 将将每个步骤的输出添加到报告中。（例如，异常）
• loop_break - （可选）如果设置为 true，当打印场景轮廓时，Behat 将在每个执行后添加分隔断行。
• show_tags - （可选）如果设置为 true，当打印场景和功能时，Behat 将添加标签。

截图

要生成测试报告中的截图，您必须更改您的 FeatureContext.php

从

# FeatureContext.php
class FeatureContext extends MinkContext
{
...
}

到

# FeatureContext.php
class FeatureContext extends elkan\BehatFormatter\Context\BehatFormatterContext
{
...
}

额外功能：占位符

在功能步骤中可以使用占位符。将包含 setTransformValues() 行动的 BeforeStep、BeforeScenario 或 BeforeSuite 动作添加到您的上下文文件中。您可以通过使用数组来添加自定义占位符。

示例上下文规则

    /**
     * @BeforeScenario
     */
    public function createTransformValues(){
        $this->setTransformValues(array(
            "<test>" => "A simple test value",
            "<timestamp>" => time()
        ));
    }

示例功能

  @test
  Scenario: Sign up for the newsletter
    When I fill in "email" with "test+<timestamp>+behat@bug-hunter.nl"
    And I press "Sign up"

示例输出

  @test
  Scenario: Sign up for the newsletter
    When I fill in "email" with "test+1461777849+behat@bug-hunter.nl"
    And I press "Sign up"

待办

• 在失败时保存 HTML
• 在测试报告中保存 REST 响应
• 是否需要 JSON 输出？
• 打印样式表中的颜色
• 自定义页脚图片/文本

许可和作者

作者：https://github.com/ElkanRoelen/BehatFormatter/graphs/contributors