README

构建状态:

简介

Mink Extension for Behat 是快速启动 Web 接受测试的绝佳方式。它允许用户使用常见的属性，如 'title'、'alt' 和 'value'，在页面上指定 HTML 元素。某些步骤允许在 Gherkin 文件中使用内联 CSS 选择器。

虽然这种方法很棒，但也有几个缺点

1) 属性值可能不一定是最适合商业的，可能会降低 Gherkin 场景的可读性。

2) 有时候无法使用 MinkExtension 提供的属性来识别元素。

3) 通过在 Gherkin 文件中直接使用这些属性，它们变得与前端实现紧密耦合。Gherkin 应该表达业务需求，而不是实现细节。

Behat 的业务选择器允许用户使用与 MinkExtension 提供的步骤非常相似的步骤，以业务术语描述页面上的元素。在测试运行时，业务术语将被 YML 文件中维护的 CSS 选择器所替换。

示例

使用 BusinessSelectorsExtension 提供的步骤编写的 Gherkin

Given I go to the page "Home Page" 
When I follow the link "Add Subscription"
And I fill in the "first name box" field with "ben"
Then the "first name box" form field should contain "ben"
And I press the "test" button
And the "Widget" should contain "Area One Text"

引号中的值映射到 behat.yml 中通过 'selectorFilePath' 参数配置的文件中的值。

Add Subscription: "a.self-link"
first name box: "form#name_form input[name=first_name]"
test: "form#name_form input[name=submit]"
Widget: div#user_widget

安装

通过 composer 安装上下文是最佳方式。

1) 关于 Behat 安装的说明，请参阅：behat.org

2) 将以下内容添加到您想要测试的项目中的 composer.json 文件。

{   
    "minimum-stability": "dev",
    "require": {
        "behat/behat": ">v2.4@stable",
        "orangedigital/business-selector-extension": "*"
    }
}

3) 将以下 OrangeDigital\BusinessSelectorExtension\Extension 部分添加到您的 behat.yml 文件中，如下例所示。

default:
    context:
        parameters:
            javascript_session: selenium
            browser: firefox
            show_cmd: open %s
    extensions:
        OrangeDigital\BusinessSelectorExtension\Extension:
          urlFilePath: urls.yml
          selectorFilePath: selectors.yml
          assetPath: path
          timeout: 30
          contexts:
            UIBusinessSelector: ~
        Behat\MinkExtension\Extension:
            base_url: "http://local.dev"
            default_session: goutte
            goutte: ~
            selenium: ~
            selenium2: ~

4) 修改您的 FeatureContext 文件以使用 BusinessSelectorContext 文件。

<?php

use Behat\Behat\Context\ClosuredContextInterface,
    Behat\Behat\Context\TranslatedContextInterface,
    Behat\Behat\Context\BehatContext,
    Behat\Behat\Exception\PendingException;
use Behat\Gherkin\Node\PyStringNode,
    Behat\Gherkin\Node\TableNode;
use Behat\MinkExtension\Context\MinkContext,
    OrangeDigital\BusinessSelectorExtension\Context\BusinessSelectorContext;

class FeatureContext extends BehatContext
{
    public function __construct(array $parameters)
    {
        $this->useContext('mink', new MinkContext($parameters));
        $this->useContext('BusinessSelectors', new BusinessSelectorContext($parameters));
    }
}

安装：示例

通过将 'example/www' 中的 html 文件移动到本地服务器的根目录或将虚拟主机指向 'example/www' 来安装提供的示例。

编辑 'example/behat.yml' 中的 'base_url' 以指向上述 web 根的 URL。

运行 ../bin/behat

Business Selectors 提供的步骤

以下是业务选择器扩展提供的步骤列表。在 <BRACKETS> 中的值表示应与相关配置文件（在 behat.yml 中通过 'urlFilePath' 和 'selectorFilePath' 指定）中的 CSS 选择器匹配的任意商业友好名称。有关详细信息，请参阅提供的示例实现。

以下 URL 应放置在 behat.yml 中通过 "urlFilePath" 参数指定的 URLs 文件中。

Given I go to the page "<PAGE NAME>" 

Given I attach "<FILE NAME> to <IMAGE INPUT>"

注意：这需要将assetPath配置为包含您的资产（例如，assetPath: assets/）的相对目录。文件名必须包含与文件关联的扩展名（例如，example.jpeg）。

以下所有CSS选择器应放置在behat.yml文件中通过参数"selectorFilePath"指定的CSS选择器文件中。

When I follow the link "<LINK>"

When I click the "<CLICKABLE ELEMENT>"

When I press the "<BUTTON>" button

When I fill in the "<TEXT INPUT>" field with "value"

When the "<TEXT INPUT>" form field should not contain "value"

When I select "value" from the "<SELECT OR MULTISELECT>" selector

When I additionally select "value" from the "<MULTISELECT>" selector

When I check the "<CHECKBOX>" checkbox

When I uncheck the "<CHECKBOX>" checkbox

When I focus on the "<IFRAME (RELATES TO ID OR INDEX)>" iframe

注意：上面的步骤是唯一必须将选择器指定为ID的步骤。如果iframe没有ID，您可以提供iframe的索引，其中0表示第一个iframe，1表示第二个等。一个示例可以在example/features/example.feature中找到。

When I refocus on the primary page

When I hover over "<PAGE ELEMENT>"

When I wait for the "<PAGE ELEMENT>" component to [dis]appear

Then the "<PAGE ELEMENT>" should contain "value"

Then the "<PAGE ELEMENT>" should not contain "value"

Then I should see "<PAGE ELEMENT>" component

Then I should not see "<PAGE ELEMENT>" component

Then "<PAGE ELEMENT>" should contain "<PAGE ELEMENT>"

Then "<PAGE ELEMENT>" should not contain "<PAGE ELEMENT>"

Then the "<CHECKBOX>" should be checked

Then the "<CHECKBOX>" should not be checked

Then the "<TEXT INPUT>" form field should contain "value"