Disabling Tests

Sometimes you might need to disable a test for a variety of reasons. With AsyncUnit you can disable your tests, TestCases, and TestSuites with the Disabled Attribute!

In a complex test suite there might be times where you need to disable tests for a variety of reasons. If you're familiar with PHPUnit their nomenclature is skipped or ignored. In AsyncUnit we consolidate this into one concept; a disabled test. You can disable not only a test but an entire TestCase or even a whole TestSuite with the #[Disabled] attribute!
Conditional test disabling is a feature that is coming in the 0.6 version!
Disabling a single test
If you just need to disable a single test simple annotate that method with the #[Disabled] Attribute!
1
<?php
2
​
3
use Cspray\Labrador\AsyncUnit\TestCase;
4
use Cspray\Labrador\AsyncUnit\Attribute\Test;
5
use Cspray\Labrador\AsyncUnit\Attribute\Disabled;
6
​
7
class MyDisabledTest extends TestCase {
8
​
9
   #[Test]
10
   #[Disabled]
11
   public function checkSomething() {
12
      // none of this matters because this is never executed
13
   }   
14
​
15
​
16
}
Copied!
When disabling a single test any #[BeforeEach] or #[AfterEach] hook defined on the TestCase will not be executed.
Disabling a TestCase
Chances are if one test in a TestCase needs to be disabled so do all the other tests. In those situations you can simply annotate the class with the #[Disabled] Attribute.
1
<?php
2
​
3
use Cspray\Labrador\AsyncUnit\TestCase;
4
use Cspray\Labrador\AsyncUnit\Attribute\Test;
5
use Cspray\Labrador\AsyncUnit\Attribute\Disabled;
6
​
7
#[Disabled]
8
class MyDisabledTestCase extends TestCase {
9
​
10
   #[Test]
11
   public function checkSomething() {
12
      // none of this matters because this is never executed
13
   }   
14
   
15
   #[Test]
16
   public function checkSomethingElse() {
17
      // this doesn't matter either... it will never run!
18
   }
19
   
20
   #[Test]
21
   public function anotherDisabledTest() {
22
      // more stuff that won't ever run
23
   }
24
​
25
}
Copied!
When disabling an entire TestCase not only are none of the tests executed but none of the hooks associated with that TestCase are executed either.
Disabling a TestSuite
If you're utilizing an explicit TestSuite it might be beneficial to disable all of the TestCase associated to the TestSuite. Just like with the TestCase simply annotate the appropriate class with the #[Disabled] Attribute!
1
<?php
2
​
3
use Cspray\Labrador\AsyncUnit\TestCase;
4
use Cspray\Labrador\AsyncUnit\TestSuite;
5
use Cspray\Labrador\AsyncUnit\Attribute\Test;
6
use Cspray\Labrador\AsyncUnit\Attribute\DefaultTestSuite;
7
use Cspray\Labrador\AsyncUnit\Attribute\Disabled;
8
​
9
#[Disabled]
10
#[DefaultTestSuite]
11
class MyTestSuite extends TestSuite {}
12
​
13
class FirstTestCase extends TestCase {
14
​
15
   #[Test]
16
   public function checkSomething() {
17
      // none of this matters because this is never executed
18
   }   
19
   
20
   #[Test]
21
   public function checkSomethingElse() {
22
      // this doesn't matter either... it will never run!
23
   }
24
   
25
   #[Test]
26
   public function anotherDisabledTest() {
27
      // more stuff that won't ever run
28
   }
29
​
30
}
31
​
32
class SecondTestCase extends TestCase {
33
​
34
   #[Test]
35
   public function checkSomething() {
36
      // none of this matters because this is never executed
37
   }   
38
   
39
   #[Test]
40
   public function checkSomethingElse() {
41
      // this doesn't matter either... it will never run!
42
   }
43
   
44
   #[Test]
45
   public function anotherDisabledTest() {
46
      // more stuff that won't ever run
47
   }
48
​
49
}
Copied!
When disabling a TestSuite no tests or hooks for the TestSuite or any of its TestCase will be invoked! 

Tutorials - Previous

Test Suites

Next - Tutorials

Data Providers

Last modified 1yr ago

Copy link

Contents

Disabling a single test

Disabling a TestCase

Disabling a TestSuite