如何在 Codeception 中强制测试失败

Question

I am making WebServices tests with Codeception, here is my code:

//Making first query for getting needed parameter
$I->wantTo('Make something');
$I->sendPOST($this->route, [
    'token' => Fixtures::get('token'),
    'id' => Fixtures::get('some_id')
]);
$I->seeResponseCodeIs(200);
$I->seeResponseIsJson();
$I->seeResponseContains('"error_message"');

//Then I get what I need with regexp
if (preg_match('/^.*\s(?<value_i_need>\d+)\.$/', $I->grabDataFromResponseByJsonPath('$.status.error_message')[0], $matches)) {
    $I->sendPOST($this->route, [
        'token' => Fixtures::get('token'),
        'id' => Fixtures::get('some_id')
    ]);
    $I->seeResponseCodeIs(200);
    $I->seeResponseIsJson();
    $I->seeResponseContains('"something"');
    $I->seeResponseContains('"something_else"');   
} else {
    //And if I don't get needed parameter with regular expression, here I have to force test fail
}

Does anybody know how to force test fail?

Thanks in advance!

Answer 1

You can use the fail action on your actor. ie

$I->fail('this test fails... just because');

Answer 2

You can mark your test as skipped or incomplete. Here is example:

public function tryToMakeAwesomeThings(ApiTester $I, Scenario $scenario)
{
    if ( ... ) {
        // do something
    } elseif ( ... ) {
        $scenario->incomplete();
    } elseif ( ... ) {
        $scenario->skip();
    }
}

Answer 3

您可以使用PHPUnit\\Framework\\Assert::fail()或抛出PHPUnit\\Framework\\AssertionFailedError异常。

Answer 4

Use assertInstanceOf() from https://codeception.com/docs/modules/Asserts

Example:

public function test_array_result() {
    /** @var Demo $demo */
    $demo = Common::get_which_class( $this->post_id );

    self::assertInstanceOf( Demo::class, $demo, 'Unable to instantiate the Demo class.');

    $x = [ 'a', 'b', 'c' ];

    $this->assertEqualSetsWithIndex( $x, $demo->get_result() );
}

Answer 5

There is another problem with Codeception 4 and upper. Method fail now in Assertion module https://codeception.com/docs/modules/Asserts This module not included in codeception by default, you must install it separately. When you install it, this module must be added in config file, such as "api.suite.yml"

actor: ApiTester
modules:
  enabled:
    ...
    - \Codeception\Module\Asserts

After this, you need to rebuild codeception and this method appear to use.