PHPUnit 通过配置中没有断言的测试

Question

我想通过获得以下内容的测试：“此测试没有执行任何断言”

我知道我可以添加类似 assertTrue(true) 的内容，但是是否可以在配置中添加一些内容来使这些测试通过得更干净吗？

我很确定这只发生在 PHPUnit 3.5.0 版本之后，引入了 --严格

Answer 1

编辑：您有几种选择，具体取决于您使用的版本、是否要忽略所有有风险的测试或只是少数，以及是否需要是永久的还是临时的。

在 5.6 之前，如果您不想在所有测试中添加虚假断言，则必须避免将 --strict 传递给 PHPUnit 或添加 strict="false"到您的 phpunit.xml。此选项的要点是“如果未做出断言，则将测试标记为不完整”。

在某些时候，PHPUnit 添加了相关的 --dont-report-useless-tests 命令行开关和 beStrictAboutTestsThatDoNotTestAnything="false" 配置选项。我还没有检查它们是否是替代品或额外的细粒度版本。

上述选项影响所有有风险的测试。使用它们会让您意外地编写没有断言的测试。以下新选项更安全，因为您必须有目的地标记您希望允许的每个有风险的测试。

PHPUnit 5.6 添加了 @doesNotPerformAssertions 注释将单个测试用例标记为“没有风险”，即使他们没有做出任何断言。

/**
 * @doesNotPerformAssertions
 */
public function testWithoutAsserting() {
    $x = 5;
}

PHPUnit 7.2 引入了TestCase::expectNotToPerformAssertions() 其中做同样的事情。

public function testWithoutAsserting() {
    $this->expectNotToPerformAssertions();
    $x = 5;
}

Answer 2

使用 PHPUnit 7.2，您可以获得另一种选择：

public function testCodeWithoutUsingAssertions()
{
    $this->expectNotToPerformAssertions();
    // do stuff...
}

另请参阅 https://github.com/sebastianbergmann/phpunit/pull /3042。

Answer 3

使用 @doesNotPerformAssertions 注解：

/**
 * @doesNotPerformAssertions
 */
public function testCodeWithoutUsingAssertions()
{
    // do stuff...
}

Answer 4

使用$this->addToAssertionCount(1)。见下文。

class NoAssertTest extends PHPUnit_Framework_TestCase
{
    function testWithoutAssertions() {
        $x = 5;

        // Increment the assertion count to signal this test passed.
        // This is important if you use a @depends on this test
        $this->addToAssertionCount(1);
    }
}

Answer 5

就我而言，测试没有断言，因为我只是使用 prophecy lib 检查所有内容来模拟并检查方法是否按预期调用...

PHPUnit 默认情况下期望测试至少有一个断言，并警告你这样说。

只需在测试的任何部分添加这一行就足够了。

$this->expectNotToPerformAssertions();

但你也可以设计一个测试，在某些情况下有断言或没有断言

public function testCodeNoAssertions()
{
    if ($something === true) {
        $this->expectNotToPerformAssertions();
    }
    // do stuff...

    if ($somethingElse === true) {
    //do any assertion
    }
}

总之，这不是一个错误......这是一个功能。

Answer 6

如果您有 PHP SimpleTest，另一种方法是使用：

$this->pass();

这会将测试标记为已完成并通过。

另一方面，对于您想要失败的测试，您可以使用：

$this->fail();

例如：

if (someComplicatedLogicValidation) {
    // Do more stuff and asserts
} else{
    $this->fail();
}

我在 PHP 5.5 中尝试了这个并且有效：

function testThatWorks() {
    $this->pass();
}

function testThatFails() {
    $this->fail();
}

输出：

1) 在 [...ExampleTest.unit.php 第 23 行] 处失败
在测试失败中
在示例测试中
在.../ExampleTest.unit.php
3.02秒后失败

也许方法传递在 PHPUnit 中仍然可以轻松实现。来源来自SimpleTest：

function pass($message = "Pass") {
    if (! isset($this->reporter)) {
        trigger_error('Can only make assertions within test methods');
    }
    $this->reporter->paintPass(
    $message . $this->getAssertionLine());
    return true;
}

Answer 7

PHPUnit 7.2+。如果您有条件，可以使用 $this->expectNotToPerformAssertions() ，这可能会禁用断言。似乎不在官方文档中，但可以在这里找到： https://github .com/sebastianbergmann/phpunit/pull/3042/files

public function testCodeNoAssertions()
{
    $this->expectNotToPerformAssertions();
}

至少 PHPUnit 7.0+。可以使用@doesNotPerformAssertions。当前文档没有说明何时添加此内容。 https://phpunit.readthedocs.io/en/7.0/annotations.html# doesnotperformassertions

/**
 * @doesNotPerformAssertions
 */
public function testCodeWithoutUsingAssertions()
{

}

如果您的测试只是不完整，您应该使用 $this->markTestIncomplete() https://phpunit.readthedocs.io/en/7.0/incomplete- and-skipped-tests.html

public function testCodeThatIsIncomplete()
{
    $this->markTestIncomplete('Implementation of this test is not complete.');
}

如果您想暂时禁用测试，应使用$this->markTestSkipped()。 https://phpunit.readthedocs.io/ en/7.0/incomplete-and-skipped-tests.html#skipping-tests

public function testCodeThatIsDisabledTemporarily()
{
    $this->markTestSkipped('This test is disabled to test, if it is interfering with other tests.');
}

Answer 8

我创建了一个超类并在那里放置了类似 SimpleTest 的函数：

/**
 * Pass a test
 */
public function pass()
{
    //phpunit is missing pass()
    $this->assertTrue(true);
}

然后你可以调用它

$this->pass();