huahuibao/vendor/yiisoft/yii2-codeception/docs/guide-ja/basic-usage.md

基本的な使用方法

Codeception のページオブジェクトを使用するとき、同じようなコードがあるのに気付きます。 コードの重複を避けるために、そういうコードを抽出して BasePage クラスに置いています。 このクラスからあなたのページオブジェクトを派生させてください。 yii2-app-basic と yii2-app-advanced のボイラープレートでも、そのようにしています。

単体テストのためには TestCase クラスがあり、このクラスがいくつかの共通機能、たとえば、各テスト前のアプリケーションの生成や、各テスト後のアプリケーションの破壊などを保持しています。 このクラスを使って、模擬アプリケーションを構成することが出来ます。 TestCase は Codeception\TestCase\Case から拡張されているため、Codeception の全てのメソッドやアサーションが利用できます。 あなたのテストで Codeception のモジュールを使ったり、イベントを発生させたりすることも、そのメソッドを使って出来ます。

Codeception のモジュールを取得する

単体テストの中で Codeception のモジュールやヘルパを使いたいときは、次のようにしてすることが出来ます。

<?php
# あなたの単体テストの中で
$this->getModule('CodeHelper'); # または、その他のモジュール

アクターのインスタンスにアクセスして、アクターの全てのメソッドを使うことも出来ます。

<?php
$this->unitTester->someMethodFromModule();

Codeception イベント

イベントを発生させるためには、次のようにします。

<?php
use Codeception\Event\TestEvent;

public function testSomething()
{
    $this->fire('myevent', new TestEvent($this));
}

このイベントは、モジュールおよびヘルパの中でキャッチすることが出来ます。 あなたのテストがグループに属している場合は、例えば myevent.somegroup のように、イベント名の後にグループ名が付きます。

スペシャルテストメソッドのチェーン

スペシャルテストメソッドの実行は、例えば、UserTest クラスの場合、次のようになります。

tests\unit\models\UserTest::setUpBeforeClass();

    tests\unit\models\UserTest::_before();

        tests\unit\models\UserTest::setUp();

            tests\unit\models\UserTest::testSomething();

        tests\unit\models\UserTest::tearDown();

    tests\unit\models\UserTest::_after();

tests\unit\models\UserTest::tearDownAfterClass();

スペシャルテストメソッドを使うときは、その親を呼ぶのを忘れないようにしてください。