class ViewsBlockTest

Same name in this branch
  1. 11.x core/modules/views/tests/src/Kernel/Plugin/ViewsBlockTest.php \Drupal\Tests\views\Kernel\Plugin\ViewsBlockTest
  2. 11.x core/modules/views_ui/tests/src/Kernel/ViewsBlockTest.php \Drupal\Tests\views_ui\Kernel\ViewsBlockTest
Same name and namespace in other branches
  1. 9 core/modules/views/tests/src/Unit/Plugin/Block/ViewsBlockTest.php \Drupal\Tests\views\Unit\Plugin\Block\ViewsBlockTest
  2. 9 core/modules/views/tests/src/Kernel/Plugin/ViewsBlockTest.php \Drupal\Tests\views\Kernel\Plugin\ViewsBlockTest
  3. 8.9.x core/modules/views/tests/src/Unit/Plugin/Block/ViewsBlockTest.php \Drupal\Tests\views\Unit\Plugin\Block\ViewsBlockTest
  4. 8.9.x core/modules/views/tests/src/Kernel/Plugin/ViewsBlockTest.php \Drupal\Tests\views\Kernel\Plugin\ViewsBlockTest
  5. 10 core/modules/views/tests/src/Unit/Plugin/Block/ViewsBlockTest.php \Drupal\Tests\views\Unit\Plugin\Block\ViewsBlockTest
  6. 10 core/modules/views/tests/src/Kernel/Plugin/ViewsBlockTest.php \Drupal\Tests\views\Kernel\Plugin\ViewsBlockTest
  7. 10 core/modules/views_ui/tests/src/Kernel/ViewsBlockTest.php \Drupal\Tests\views_ui\Kernel\ViewsBlockTest

@coversDefaultClass \Drupal\views\Plugin\block\ViewsBlock
@group views

Hierarchy

Expanded class hierarchy of ViewsBlockTest

File

core/modules/views/tests/src/Unit/Plugin/Block/ViewsBlockTest.php, line 19

Namespace

Drupal\Tests\views\Unit\Plugin\Block
View source
class ViewsBlockTest extends UnitTestCase {
  
  /**
   * The view executable.
   *
   * @var \Drupal\views\ViewExecutable|\PHPUnit\Framework\MockObject\MockObject
   */
  protected $executable;
  
  /**
   * The view executable factory.
   *
   * @var \Drupal\views\ViewExecutableFactory|\PHPUnit\Framework\MockObject\MockObject
   */
  protected $executableFactory;
  
  /**
   * The view entity.
   *
   * @var \Drupal\views\ViewEntityInterface|\PHPUnit\Framework\MockObject\MockObject
   */
  protected $view;
  
  /**
   * The view storage.
   *
   * @var \Drupal\Core\Entity\EntityStorageInterface|\PHPUnit\Framework\MockObject\MockObject
   */
  protected $storage;
  
  /**
   * The mocked user account.
   *
   * @var \Drupal\Core\Session\AccountInterface|\PHPUnit\Framework\MockObject\MockObject
   */
  protected $account;
  
  /**
   * The mocked display handler.
   *
   * @var \Drupal\views\Plugin\views\display\Block|\PHPUnit\Framework\MockObject\MockObject
   */
  protected $displayHandler;
  
  /**
   * {@inheritdoc}
   */
  protected function setUp() : void {
    parent::setUp();
    $container = new ContainerBuilder();
    $cache_context_manager = $this->createMock(CacheContextsManager::class);
    $cache_context_manager->expects($this->any())
      ->method('getAll')
      ->willReturn([]);
    $cache_context_manager->expects($this->any())
      ->method('assertValidTokens')
      ->willReturn(TRUE);
    $container->set('cache_contexts_manager', $cache_context_manager);
    $condition_plugin_manager = $this->createMock('Drupal\\Core\\Executable\\ExecutableManagerInterface');
    $condition_plugin_manager->expects($this->any())
      ->method('getDefinitions')
      ->willReturn([]);
    $container->set('plugin.manager.condition', $condition_plugin_manager);
    \Drupal::setContainer($container);
    $this->executable = $this->getMockBuilder('Drupal\\views\\ViewExecutable')
      ->disableOriginalConstructor()
      ->onlyMethods([
      'buildRenderable',
      'setDisplay',
      'setItemsPerPage',
      'getShowAdminLinks',
    ])
      ->getMock();
    $this->executable
      ->expects($this->any())
      ->method('setDisplay')
      ->with('block_1')
      ->willReturn(TRUE);
    $this->executable
      ->expects($this->any())
      ->method('getShowAdminLinks')
      ->willReturn(FALSE);
    $this->executable->display_handler = $this->getMockBuilder('Drupal\\views\\Plugin\\views\\display\\Block')
      ->disableOriginalConstructor()
      ->onlyMethods([
      'getCacheMetadata',
    ])
      ->getMock();
    $this->view = $this->getMockBuilder('Drupal\\views\\Entity\\View')
      ->disableOriginalConstructor()
      ->getMock();
    $this->view
      ->expects($this->any())
      ->method('id')
      ->willReturn('test_view');
    $this->executable->storage = $this->view;
    $this->executableFactory = $this->getMockBuilder('Drupal\\views\\ViewExecutableFactory')
      ->disableOriginalConstructor()
      ->getMock();
    $this->executableFactory
      ->expects($this->any())
      ->method('get')
      ->with($this->view)
      ->willReturn($this->executable);
    $this->displayHandler = $this->getMockBuilder('Drupal\\views\\Plugin\\views\\display\\Block')
      ->disableOriginalConstructor()
      ->getMock();
    $this->displayHandler
      ->expects($this->any())
      ->method('blockSettings')
      ->willReturn([]);
    $this->displayHandler
      ->expects($this->any())
      ->method('getPluginId')
      ->willReturn('block');
    $this->displayHandler
      ->expects($this->any())
      ->method('getHandlers')
      ->willReturn([]);
    $this->executable->display_handler = $this->displayHandler;
    $this->storage = $this->getMockBuilder('Drupal\\Core\\Config\\Entity\\ConfigEntityStorage')
      ->disableOriginalConstructor()
      ->getMock();
    $this->storage
      ->expects($this->any())
      ->method('load')
      ->with('test_view')
      ->willReturn($this->view);
    $this->account = $this->createMock('Drupal\\Core\\Session\\AccountInterface');
  }
  
  /**
   * Tests the build method.
   *
   * @see \Drupal\views\Plugin\block\ViewsBlock::build()
   */
  public function testBuild() : void {
    $output = $this->randomMachineName(100);
    $build = [
      'view_build' => $output,
      '#view_id' => 'test_view',
      '#view_display_plugin_class' => '\\Drupal\\views\\Plugin\\views\\display\\Block',
      '#view_display_show_admin_links' => FALSE,
      '#view_display_plugin_id' => 'block',
      '#pre_rendered' => TRUE,
    ];
    $this->executable
      ->expects($this->once())
      ->method('buildRenderable')
      ->with('block_1', [])
      ->willReturn($build);
    $block_id = 'views_block:test_view-block_1';
    $config = [];
    $definition = [];
    $definition['provider'] = 'views';
    $plugin = new ViewsBlock($config, $block_id, $definition, $this->executableFactory, $this->storage, $this->account);
    $this->assertEquals($build, $plugin->build());
  }
  
  /**
   * Tests that cacheable metadata is retrieved from the view and merged with block cacheable metadata.
   *
   * @dataProvider providerTestCacheableMetadata
   *
   * @see \Drupal\views\Plugin\block\ViewsBlock::build()
   */
  public function testCacheableMetadata(int $blockCacheMaxAge, int $viewCacheMaxAge, int $expectedCacheMaxAge) : void {
    $blockCacheTags = [
      'block-cachetag-1',
      'block-cachetag-2',
    ];
    $blockCacheContexts = [
      'block-cache-context-1',
      'block-cache-context-2',
    ];
    $viewCacheTags = [
      'view-cachetag-1',
      'view-cachetag-2',
    ];
    $viewCacheContexts = [
      'view-cache-context-1',
      'view-cache-context-2',
    ];
    // Mock view cache metadata.
    $viewCacheMetadata = $this->createMock(CacheableMetadata::class);
    $viewCacheMetadata->method('getCacheTags')
      ->willReturn($viewCacheTags);
    $viewCacheMetadata->method('getCacheContexts')
      ->willReturn($viewCacheContexts);
    $viewCacheMetadata->method('getCacheMaxAge')
      ->willReturn($viewCacheMaxAge);
    $this->executable->display_handler
      ->method('getCacheMetadata')
      ->willReturn($viewCacheMetadata);
    // Mock block context.
    $blockContext = $this->createMock(ContextInterface::class);
    $blockContext->method('getCacheTags')
      ->willReturn($blockCacheTags);
    $blockContext->method('getCacheContexts')
      ->willReturn($blockCacheContexts);
    $blockContext->method('getCacheMaxAge')
      ->willReturn($blockCacheMaxAge);
    // Create the views block.
    $block_id = 'views_block:test_view-block_1';
    $config = [];
    $definition = [
      'provider' => 'views',
    ];
    $plugin = new ViewsBlock($config, $block_id, $definition, $this->executableFactory, $this->storage, $this->account);
    $plugin->setContext('context_name', $blockContext);
    // Assertions.
    $this->assertEmpty(array_diff(Cache::mergeTags($viewCacheTags, $blockCacheTags), $plugin->getCacheTags()));
    $this->assertEmpty(array_diff(Cache::mergeContexts($viewCacheContexts, $blockCacheContexts), $plugin->getCacheContexts()));
    $this->assertEquals($expectedCacheMaxAge, $plugin->getCacheMaxAge());
  }
  
  /**
   * Data provider for ::testCacheableMetadata()
   */
  public static function providerTestCacheableMetadata() : array {
    return [
      'View expires before' => [
        500,
        1000,
        500,
      ],
      'Block expires before' => [
        1000,
        500,
        500,
      ],
      'Only block is permanent' => [
        Cache::PERMANENT,
        500,
        500,
      ],
      'Only view is permanent' => [
        500,
        Cache::PERMANENT,
        500,
      ],
      'Both view and block are permanent' => [
        Cache::PERMANENT,
        Cache::PERMANENT,
        Cache::PERMANENT,
      ],
    ];
  }
  
  /**
   * Tests the build method.
   *
   * @covers ::build
   */
  public function testBuildEmpty() : void {
    $build = [
      'view_build' => [],
      '#view_id' => 'test_view',
      '#view_display_plugin_class' => '\\Drupal\\views\\Plugin\\views\\display\\Block',
      '#view_display_show_admin_links' => FALSE,
      '#view_display_plugin_id' => 'block',
      '#pre_rendered' => TRUE,
      '#cache' => [
        'contexts' => [
          'user',
        ],
      ],
    ];
    $this->executable
      ->expects($this->once())
      ->method('buildRenderable')
      ->with('block_1', [])
      ->willReturn($build);
    $block_id = 'views_block:test_view-block_1';
    $config = [];
    $definition = [];
    $definition['provider'] = 'views';
    $plugin = new ViewsBlock($config, $block_id, $definition, $this->executableFactory, $this->storage, $this->account);
    $this->assertEquals(array_intersect_key($build, [
      '#cache' => TRUE,
    ]), $plugin->build());
  }
  
  /**
   * Tests the build method with a failed execution.
   *
   * @see \Drupal\views\Plugin\block\ViewsBlock::build()
   */
  public function testBuildFailed() : void {
    $output = FALSE;
    $this->executable
      ->expects($this->once())
      ->method('buildRenderable')
      ->with('block_1', [])
      ->willReturn($output);
    $block_id = 'views_block:test_view-block_1';
    $config = [];
    $definition = [];
    $definition['provider'] = 'views';
    $plugin = new ViewsBlock($config, $block_id, $definition, $this->executableFactory, $this->storage, $this->account);
    $this->assertEquals([], $plugin->build());
  }

}

Members

Title Sort descending Modifiers Object type Summary Overriden Title
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::setupMockIterator protected function Set up a traversable class mock to return specific items when iterated.
ViewsBlockTest::$account protected property The mocked user account.
ViewsBlockTest::$displayHandler protected property The mocked display handler.
ViewsBlockTest::$executable protected property The view executable.
ViewsBlockTest::$executableFactory protected property The view executable factory.
ViewsBlockTest::$storage protected property The view storage.
ViewsBlockTest::$view protected property The view entity.
ViewsBlockTest::providerTestCacheableMetadata public static function Data provider for ::testCacheableMetadata()
ViewsBlockTest::setUp protected function Overrides UnitTestCase::setUp
ViewsBlockTest::testBuild public function Tests the build method.
ViewsBlockTest::testBuildEmpty public function Tests the build method.
ViewsBlockTest::testBuildFailed public function Tests the build method with a failed execution.
ViewsBlockTest::testCacheableMetadata public function Tests that cacheable metadata is retrieved from the view and merged with block cacheable metadata.

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