class BanAdminTest
Tests the BanAdmin form.
Attributes
#[CoversClass(BanAdmin::class)]
#[Group('ban')]
#[IgnoreDeprecations]
  Hierarchy
- class \Drupal\Tests\UnitTestCase uses \Drupal\Tests\PhpUnitCompatibilityTrait, \Prophecy\PhpUnit\ProphecyTrait, \Drupal\TestTools\Extension\DeprecationBridge\ExpectDeprecationTrait, \Drupal\Tests\RandomGeneratorTrait extends \PHPUnit\Framework\TestCase- class \Drupal\Tests\ban\Unit\BanAdminTest extends \Drupal\Tests\UnitTestCase
 
Expanded class hierarchy of BanAdminTest
File
- 
              core/modules/ ban/ tests/ src/ Unit/ BanAdminTest.php, line 22 
Namespace
Drupal\Tests\ban\UnitView source
class BanAdminTest extends UnitTestCase {
  
  /**
   * Tests various user input to confirm correct validation.
   *
   * @legacy-covers ::validateForm
   */
  public function testIpValidation(string $ip, bool $isBanned, ?string $error) : void {
    $manager = $this->getIpManagerMock();
    $manager->expects($this->once())
      ->method('isBanned')
      ->with($ip)
      ->willReturn($isBanned);
    $formObject = new BanAdmin($manager);
    $formObject->setStringTranslation($this->getStringTranslationStub());
    $formObject->setRequestStack($this->getRequestStackMock());
    $formState = $this->createMock(FormStateInterface::class);
    $formState->expects($this->any())
      ->method('getValue')
      ->with('ip')
      ->willReturn($ip);
    if ($error === NULL) {
      $formState->expects($this->never())
        ->method('setErrorByName');
    }
    else {
      $formState->expects($this->once())
        ->method('setErrorByName')
        ->with('ip', $error);
    }
    $form = [];
    $formObject->validateForm($form, $formState);
  }
  
  /**
   * Test form submission.
   */
  public function testSubmit() : void {
    $ip = '1.2.3.4';
    $manager = $this->getIpManagerMock();
    $manager->expects($this->once())
      ->method('banIp')
      ->with($ip);
    $messenger = $this->createMock(MessengerInterface::class);
    $messenger->expects($this->once())
      ->method('addStatus');
    $formObject = new BanAdmin($manager);
    $formObject->setStringTranslation($this->getStringTranslationStub());
    $formObject->setMessenger($messenger);
    $formState = $this->createMock(FormStateInterface::class);
    $formState->expects($this->any())
      ->method('getValue')
      ->with('ip')
      ->willReturn($ip);
    $form = [];
    $formObject->submitForm($form, $formState);
  }
  
  /**
   * Test passing an IP address as a route parameter.
   *
   * @legacy-covers ::buildForm
   */
  public function testRouteParameter() : void {
    $ip = '1.2.3.4';
    $formObject = new BanAdmin($this->getIpManagerMock());
    $formObject->setStringTranslation($this->getStringTranslationStub());
    $formState = $this->createMock(FormStateInterface::class);
    $form = $formObject->buildForm([], $formState, $ip);
    $this->assertSame($ip, $form['ip']['#default_value']);
  }
  
  /**
   * Data provider for testIpValidation().
   */
  public static function providerIpValidation() : array {
    return [
      'valid ip' => [
        '1.2.3.3',
        FALSE,
        NULL,
      ],
      'already blocked' => [
        '1.2.3.3',
        TRUE,
        'This IP address is already banned.',
      ],
      'reserved ip' => [
        '255.255.255.255',
        FALSE,
        'Enter a valid IP address.',
      ],
      'fqdn' => [
        'test.example.com',
        FALSE,
        'Enter a valid IP address.',
      ],
      'empty' => [
        '',
        FALSE,
        'Enter a valid IP address.',
      ],
      'client ip' => [
        '127.0.0.1',
        FALSE,
        'You may not ban your own IP address.',
      ],
    ];
  }
  
  /**
   * Get a request stack with a dummy IP.
   */
  protected function getRequestStackMock() : RequestStack {
    $request = $this->createMock(Request::class);
    $request->expects($this->any())
      ->method('getClientIp')
      ->willReturn('127.0.0.1');
    $requestStack = $this->createMock(RequestStack::class);
    $requestStack->expects($this->any())
      ->method('getCurrentRequest')
      ->willReturn($request);
    return $requestStack;
  }
  
  /**
   * Get the mocked IP manager service.
   */
  protected function getIpManagerMock() : BanIpManagerInterface {
    $manager = $this->createMock(BanIpManagerInterface::class);
    $manager->expects($this->any())
      ->method('findAll')
      ->willReturn([]);
    return $manager;
  }
}Members
| Title Sort descending | Modifiers | Object type | Summary | Overrides | 
|---|---|---|---|---|
| BanAdminTest::getIpManagerMock | protected | function | Get the mocked IP manager service. | |
| BanAdminTest::getRequestStackMock | protected | function | Get a request stack with a dummy IP. | |
| BanAdminTest::providerIpValidation | public static | function | Data provider for testIpValidation(). | |
| BanAdminTest::testIpValidation | public | function | Tests various user input to confirm correct validation. | |
| BanAdminTest::testRouteParameter | public | function | Test passing an IP address as a route parameter. | |
| BanAdminTest::testSubmit | public | function | Test form submission. | |
| ExpectDeprecationTrait::expectDeprecation | public | function | Adds an expected deprecation. | |
| ExpectDeprecationTrait::setUpErrorHandler | public | function | Sets up the test error handler. | |
| ExpectDeprecationTrait::tearDownErrorHandler | public | function | Tears down the test error handler. | |
| RandomGeneratorTrait::getRandomGenerator | protected | function | Gets the random generator for the utility methods. | |
| RandomGeneratorTrait::randomMachineName | protected | function | Generates a unique random string containing letters and numbers. | |
| RandomGeneratorTrait::randomObject | public | function | Generates a random PHP object. | |
| RandomGeneratorTrait::randomString | public | function | Generates a pseudo-random string of ASCII characters of codes 32 to 126. | |
| UnitTestCase::$root | protected | property | The app root. | |
| UnitTestCase::getClassResolverStub | protected | function | Returns a stub class resolver. | |
| UnitTestCase::getConfigFactoryStub | public | function | Returns a stub config factory that behaves according to the passed array. | |
| UnitTestCase::getContainerWithCacheTagsInvalidator | protected | function | Sets up a container with a cache tags invalidator. | |
| UnitTestCase::getStringTranslationStub | public | function | Returns a stub translation manager that just returns the passed string. | |
| UnitTestCase::setDebugDumpHandler | public static | function | Registers the dumper CLI handler when the DebugDump extension is enabled. | |
| UnitTestCase::setUp | protected | function | 366 | |
| UnitTestCase::setupMockIterator | protected | function | Set up a traversable class mock to return specific items when iterated. | 
Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.
