class PagerPluginBaseTest

Same name in other branches
  1. 9 core/modules/views/tests/src/Unit/Plugin/pager/PagerPluginBaseTest.php \Drupal\Tests\views\Unit\Plugin\pager\PagerPluginBaseTest
  2. 8.9.x core/modules/views/tests/src/Unit/Plugin/pager/PagerPluginBaseTest.php \Drupal\Tests\views\Unit\Plugin\pager\PagerPluginBaseTest
  3. 10 core/modules/views/tests/src/Unit/Plugin/pager/PagerPluginBaseTest.php \Drupal\Tests\views\Unit\Plugin\pager\PagerPluginBaseTest

@coversDefaultClass \Drupal\views\Plugin\views\pager\PagerPluginBase @group views

Hierarchy

Expanded class hierarchy of PagerPluginBaseTest

File

core/modules/views/tests/src/Unit/Plugin/pager/PagerPluginBaseTest.php, line 15

Namespace

Drupal\Tests\views\Unit\Plugin\pager
View source
class PagerPluginBaseTest extends UnitTestCase {
    
    /**
     * The mock pager plugin instance.
     *
     * @var \Drupal\views\Plugin\views\pager\PagerPluginBase|\PHPUnit\Framework\MockObject\MockObject
     */
    protected $pager;
    
    /**
     * {@inheritdoc}
     */
    protected function setUp() : void {
        parent::setUp();
        $this->pager = $this->getMockBuilder('Drupal\\views\\Plugin\\views\\pager\\PagerPluginBase')
            ->disableOriginalConstructor()
            ->getMockForAbstractClass();
        $view = $this->getMockBuilder('Drupal\\views\\ViewExecutable')
            ->disableOriginalConstructor()
            ->getMock();
        $display = $this->getMockBuilder('Drupal\\views\\Plugin\\views\\display\\DisplayPluginBase')
            ->disableOriginalConstructor()
            ->getMock();
        $options = [
            'items_per_page' => 5,
            'offset' => 1,
        ];
        $this->pager
            ->init($view, $display, $options);
        $this->pager->current_page = 1;
    }
    
    /**
     * Tests the getItemsPerPage() method.
     *
     * @see \Drupal\views\Plugin\views\pager\PagerPluginBase::getItemsPerPage()
     */
    public function testGetItemsPerPage() : void {
        $this->assertEquals(5, $this->pager
            ->getItemsPerPage());
    }
    
    /**
     * Tests the setItemsPerPage() method.
     *
     * @see \Drupal\views\Plugin\views\pager\PagerPluginBase::setItemsPerPage()
     */
    public function testSetItemsPerPage() : void {
        $this->pager
            ->setItemsPerPage(6);
        $this->assertEquals(6, $this->pager
            ->getItemsPerPage());
    }
    
    /**
     * Tests the getOffset() method.
     *
     * @see \Drupal\views\Plugin\views\pager\PagerPluginBase::getOffset()
     */
    public function testGetOffset() : void {
        $this->assertEquals(1, $this->pager
            ->getOffset());
    }
    
    /**
     * Tests the setOffset() method.
     *
     * @see \Drupal\views\Plugin\views\pager\PagerPluginBase::setOffset()
     */
    public function testSetOffset() : void {
        $this->pager
            ->setOffset(2);
        $this->assertEquals(2, $this->pager
            ->getOffset());
    }
    
    /**
     * Tests the getCurrentPage() method.
     *
     * @see \Drupal\views\Plugin\views\pager\PagerPluginBase::getCurrentPage()
     */
    public function testGetCurrentPage() : void {
        $this->assertEquals(1, $this->pager
            ->getCurrentPage());
    }
    
    /**
     * Tests the setCurrentPage() method.
     *
     * @see \Drupal\views\Plugin\views\pager\PagerPluginBase::setCurrentPage()
     */
    public function testSetCurrentPage() : void {
        $this->pager
            ->setCurrentPage(2);
        $this->assertEquals(2, $this->pager
            ->getCurrentPage());
        // A non numeric number or number below 0 should return 0.
        $this->pager
            ->setCurrentPage('two');
        $this->assertEquals(0, $this->pager
            ->getCurrentPage());
        $this->pager
            ->setCurrentPage(-2);
        $this->assertEquals(0, $this->pager
            ->getCurrentPage());
    }
    
    /**
     * Tests the getTotalItems() method.
     *
     * @see \Drupal\views\Plugin\views\pager\PagerPluginBase::getTotalItems()
     */
    public function testGetTotalItems() : void {
        // Should return 0 by default.
        $this->assertEquals(0, $this->pager
            ->getTotalItems());
        $this->pager->total_items = 10;
        $this->assertEquals(10, $this->pager
            ->getTotalItems());
    }
    
    /**
     * Tests the getPagerId() method.
     *
     * @see \Drupal\views\Plugin\views\pager\PagerPluginBase::getPagerId()
     */
    public function testGetPagerId() : void {
        // Should return 0 if 'id' is not set.
        $this->assertEquals(0, $this->pager
            ->getPagerId());
        $this->pager->options['id'] = 1;
        $this->assertEquals(1, $this->pager
            ->getPagerId());
    }
    
    /**
     * Tests the usePager() method.
     *
     * @see \Drupal\views\Plugin\views\pager\PagerPluginBase::usePager()
     */
    public function testUsePager() : void {
        $this->assertTrue($this->pager
            ->usePager());
    }
    
    /**
     * Tests the useCountQuery() method.
     *
     * @see \Drupal\views\Plugin\views\pager\PagerPluginBase::useCountQuery()
     */
    public function testUseCountQuery() : void {
        $this->assertTrue($this->pager
            ->useCountQuery());
    }
    
    /**
     * Tests the usesExposed() method.
     *
     * @see \Drupal\views\Plugin\views\pager\PagerPluginBase::usedExposed()
     */
    public function testUsesExposed() : void {
        $this->assertFalse($this->pager
            ->usesExposed());
    }
    
    /**
     * Tests the hasMoreRecords() method.
     *
     * @dataProvider providerTestHasMoreRecords
     *
     * @see \Drupal\views\Plugin\views\pager\PagerPluginBase::hasMoreRecords()
     */
    public function testHasMoreRecords($items_per_page, $total_items, $current_page, $has_more_records) : void {
        $this->pager
            ->setItemsPerPage($items_per_page);
        $this->pager->total_items = $total_items;
        $this->pager
            ->setCurrentPage($current_page);
        $this->assertEquals($has_more_records, $this->pager
            ->hasMoreRecords());
    }
    
    /**
     * Provides test data for the hasMoreRecord method test.
     *
     * @see self::testHasMoreRecords
     */
    public static function providerTestHasMoreRecords() {
        return [
            // No items per page, so there can't be more available records.
[
                0,
                0,
                0,
                FALSE,
            ],
            [
                0,
                10,
                0,
                FALSE,
            ],
            // The amount of total items equals the items per page, so there is no
            // next page available.
[
                5,
                5,
                0,
                FALSE,
            ],
            // There is one more item, and we are at the first page.
[
                5,
                6,
                0,
                TRUE,
            ],
            // Now we are on the second page, which has just a single one left.
[
                5,
                6,
                1,
                FALSE,
            ],
            // Increase the total items, so we have some available on the third page.
[
                5,
                12,
                1,
                TRUE,
            ],
        ];
    }
    
    /**
     * Tests the executeCountQuery method without a set offset.
     *
     * @see \Drupal\views\Plugin\views\pager\PagerPluginBase::executeCountQuery()
     */
    public function testExecuteCountQueryWithoutOffset() : void {
        $statement = $this->createMock('\\Drupal\\Tests\\views\\Unit\\Plugin\\pager\\TestStatementInterface');
        $statement->expects($this->once())
            ->method('fetchField')
            ->willReturn(3);
        $query = $this->getMockBuilder('\\Drupal\\Core\\Database\\Query\\Select')
            ->disableOriginalConstructor()
            ->getMock();
        $query->expects($this->once())
            ->method('execute')
            ->willReturn($statement);
        $this->pager
            ->setOffset(0);
        $this->assertEquals(3, $this->pager
            ->executeCountQuery($query));
    }
    
    /**
     * Tests the executeCountQuery method with a set offset.
     *
     * @see \Drupal\views\Plugin\views\pager\PagerPluginBase::executeCountQuery()
     */
    public function testExecuteCountQueryWithOffset() : void {
        $statement = $this->createMock('\\Drupal\\Tests\\views\\Unit\\Plugin\\pager\\TestStatementInterface');
        $statement->expects($this->once())
            ->method('fetchField')
            ->willReturn(3);
        $query = $this->getMockBuilder('\\Drupal\\Core\\Database\\Query\\Select')
            ->disableOriginalConstructor()
            ->getMock();
        $query->expects($this->once())
            ->method('execute')
            ->willReturn($statement);
        $this->pager
            ->setOffset(2);
        $this->assertEquals(1, $this->pager
            ->executeCountQuery($query));
    }
    
    /**
     * Tests the executeCountQuery method with an offset larger than result count.
     *
     * @see \Drupal\views\Plugin\views\pager\PagerPluginBase::executeCountQuery()
     */
    public function testExecuteCountQueryWithOffsetLargerThanResult() : void {
        $statement = $this->createMock(TestStatementInterface::class);
        $statement->expects($this->once())
            ->method('fetchField')
            ->willReturn(2);
        $query = $this->getMockBuilder(Select::class)
            ->disableOriginalConstructor()
            ->getMock();
        $query->expects($this->once())
            ->method('execute')
            ->willReturn($statement);
        $this->pager
            ->setOffset(3);
        $this->assertEquals(0, $this->pager
            ->executeCountQuery($query));
    }

}

Members

Title Sort descending Modifiers Object type Summary Overriden Title
ExpectDeprecationTrait::expectDeprecation public function Adds an expected deprecation.
ExpectDeprecationTrait::getCallableName private static function Returns a callable as a string suitable for inclusion in a message.
ExpectDeprecationTrait::setUpErrorHandler public function Sets up the test error handler.
ExpectDeprecationTrait::tearDownErrorHandler public function Tears down the test error handler.
PagerPluginBaseTest::$pager protected property The mock pager plugin instance.
PagerPluginBaseTest::providerTestHasMoreRecords public static function Provides test data for the hasMoreRecord method test.
PagerPluginBaseTest::setUp protected function Overrides UnitTestCase::setUp
PagerPluginBaseTest::testExecuteCountQueryWithOffset public function Tests the executeCountQuery method with a set offset.
PagerPluginBaseTest::testExecuteCountQueryWithOffsetLargerThanResult public function Tests the executeCountQuery method with an offset larger than result count.
PagerPluginBaseTest::testExecuteCountQueryWithoutOffset public function Tests the executeCountQuery method without a set offset.
PagerPluginBaseTest::testGetCurrentPage public function Tests the getCurrentPage() method.
PagerPluginBaseTest::testGetItemsPerPage public function Tests the getItemsPerPage() method.
PagerPluginBaseTest::testGetOffset public function Tests the getOffset() method.
PagerPluginBaseTest::testGetPagerId public function Tests the getPagerId() method.
PagerPluginBaseTest::testGetTotalItems public function Tests the getTotalItems() method.
PagerPluginBaseTest::testHasMoreRecords public function Tests the hasMoreRecords() method.
PagerPluginBaseTest::testSetCurrentPage public function Tests the setCurrentPage() method.
PagerPluginBaseTest::testSetItemsPerPage public function Tests the setItemsPerPage() method.
PagerPluginBaseTest::testSetOffset public function Tests the setOffset() method.
PagerPluginBaseTest::testUseCountQuery public function Tests the useCountQuery() method.
PagerPluginBaseTest::testUsePager public function Tests the usePager() method.
PagerPluginBaseTest::testUsesExposed public function Tests the usesExposed() method.
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::getConfigStorageStub public function Returns a stub config storage that returns the supplied configuration.
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::setUpBeforeClass public static function

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.