You are here

Home » API reference » Drupal 8 » ViewsLocalTaskTest.php

class ViewsLocalTaskTest in Drupal 8

Same name and namespace in other branches
  1. 9 core/modules/views/tests/src/Unit/Plugin/Derivative/ViewsLocalTaskTest.php \Drupal\Tests\views\Unit\Plugin\Derivative\ViewsLocalTaskTest
  2. 10 core/modules/views/tests/src/Unit/Plugin/Derivative/ViewsLocalTaskTest.php \Drupal\Tests\views\Unit\Plugin\Derivative\ViewsLocalTaskTest

@coversDefaultClass \Drupal\views\Plugin\Derivative\ViewsLocalTask @group views

Hierarchy

Expanded class hierarchy of ViewsLocalTaskTest

File

core/modules/views/tests/src/Unit/Plugin/Derivative/ViewsLocalTaskTest.php, line 19
Contains \Drupal\Tests\views\Unit\Plugin\Derivative\ViewsLocalTaskTest.

Namespace

Drupal\Tests\views\Unit\Plugin\Derivative
View source 
class ViewsLocalTaskTest extends UnitTestCase {

  /**
   * The mocked route provider.
   *
   * @var \Drupal\Core\Routing\RouteProviderInterface|\PHPUnit\Framework\MockObject\MockObject
   */
  protected $routeProvider;

  /**
   * The mocked key value storage.
   *
   * @var \Drupal\Core\KeyValueStore\KeyValueStoreInterface|\PHPUnit\Framework\MockObject\MockObject
   */
  protected $state;

  /**
   * @var \Drupal\Core\Entity\EntityStorageInterface|\PHPUnit\Framework\MockObject\MockObject
   */
  protected $viewStorage;
  protected $baseDefinition = [
    'class' => '\\Drupal\\views\\Plugin\\Menu\\LocalTask\\ViewsLocalTask',
    'deriver' => '\\Drupal\\views\\Plugin\\Derivative\\ViewsLocalTask',
  ];

  /**
   * The tested local task derivative class.
   *
   * @var \Drupal\views\Plugin\Derivative\ViewsLocalTask
   */
  protected $localTaskDerivative;
  protected function setUp() {
    $this->routeProvider = $this
      ->createMock('Drupal\\Core\\Routing\\RouteProviderInterface');
    $this->state = $this
      ->createMock('Drupal\\Core\\State\\StateInterface');
    $this->viewStorage = $this
      ->createMock('Drupal\\Core\\Entity\\EntityStorageInterface');
    $this->localTaskDerivative = new TestViewsLocalTask($this->routeProvider, $this->state, $this->viewStorage);
  }

  /**
   * Tests fetching the derivatives on no view with hook menu.
   *
   * @see \Drupal\views\Plugin\Derivative\ViewsLocalTask::getDerivativeDefinitions()
   */
  public function testGetDerivativeDefinitionsWithoutHookMenuViews() {
    $result = [];
    $this->localTaskDerivative
      ->setApplicableMenuViews($result);
    $definitions = $this->localTaskDerivative
      ->getDerivativeDefinitions($this->baseDefinition);
    $this
      ->assertEquals([], $definitions);
  }

  /**
   * Tests fetching the derivatives on a view with without a local task.
   */
  public function testGetDerivativeDefinitionsWithoutLocalTask() {
    $executable = $this
      ->getMockBuilder('Drupal\\views\\ViewExecutable')
      ->disableOriginalConstructor()
      ->getMock();
    $display_plugin = $this
      ->getMockBuilder('Drupal\\views\\Plugin\\views\\display\\PathPluginBase')
      ->setMethods([
      'getOption',
    ])
      ->disableOriginalConstructor()
      ->getMockForAbstractClass();
    $display_plugin
      ->expects($this
      ->once())
      ->method('getOption')
      ->with('menu')
      ->will($this
      ->returnValue([
      'type' => 'normal',
    ]));
    $executable->display_handler = $display_plugin;
    $storage = $this
      ->getMockBuilder('Drupal\\views\\Entity\\View')
      ->disableOriginalConstructor()
      ->getMock();
    $storage
      ->expects($this
      ->any())
      ->method('id')
      ->will($this
      ->returnValue('example_view'));
    $storage
      ->expects($this
      ->any())
      ->method('getExecutable')
      ->willReturn($executable);
    $this->viewStorage
      ->expects($this
      ->any())
      ->method('load')
      ->with('example_view')
      ->willReturn($storage);
    $result = [
      [
        'example_view',
        'page_1',
      ],
    ];
    $this->localTaskDerivative
      ->setApplicableMenuViews($result);
    $definitions = $this->localTaskDerivative
      ->getDerivativeDefinitions($this->baseDefinition);
    $this
      ->assertEquals([], $definitions);
  }

  /**
   * Tests fetching the derivatives on a view with a default local task.
   */
  public function testGetDerivativeDefinitionsWithLocalTask() {
    $executable = $this
      ->getMockBuilder('Drupal\\views\\ViewExecutable')
      ->disableOriginalConstructor()
      ->getMock();
    $storage = $this
      ->getMockBuilder('Drupal\\views\\Entity\\View')
      ->disableOriginalConstructor()
      ->getMock();
    $storage
      ->expects($this
      ->any())
      ->method('id')
      ->will($this
      ->returnValue('example_view'));
    $storage
      ->expects($this
      ->any())
      ->method('getExecutable')
      ->willReturn($executable);
    $executable->storage = $storage;
    $this->viewStorage
      ->expects($this
      ->any())
      ->method('load')
      ->with('example_view')
      ->willReturn($storage);
    $display_plugin = $this
      ->getMockBuilder('Drupal\\views\\Plugin\\views\\display\\PathPluginBase')
      ->setMethods([
      'getOption',
    ])
      ->disableOriginalConstructor()
      ->getMockForAbstractClass();
    $display_plugin
      ->expects($this
      ->once())
      ->method('getOption')
      ->with('menu')
      ->will($this
      ->returnValue([
      'type' => 'tab',
      'weight' => 12,
      'title' => 'Example title',
    ]));
    $executable->display_handler = $display_plugin;
    $result = [
      [
        'example_view',
        'page_1',
      ],
    ];
    $this->localTaskDerivative
      ->setApplicableMenuViews($result);

    // Mock the view route names state.
    $view_route_names = [];
    $view_route_names['example_view.page_1'] = 'view.example_view.page_1';
    $this->state
      ->expects($this
      ->once())
      ->method('get')
      ->with('views.view_route_names')
      ->will($this
      ->returnValue($view_route_names));
    $definitions = $this->localTaskDerivative
      ->getDerivativeDefinitions($this->baseDefinition);
    $this
      ->assertCount(1, $definitions);
    $this
      ->assertEquals('view.example_view.page_1', $definitions['view.example_view.page_1']['route_name']);
    $this
      ->assertEquals(12, $definitions['view.example_view.page_1']['weight']);
    $this
      ->assertEquals('Example title', $definitions['view.example_view.page_1']['title']);
    $this
      ->assertEquals($this->baseDefinition['class'], $definitions['view.example_view.page_1']['class']);
    $this
      ->assertTrue(empty($definitions['view.example_view.page_1']['base_route']));
  }

  /**
   * Tests fetching the derivatives on a view which overrides an existing route.
   */
  public function testGetDerivativeDefinitionsWithOverrideRoute() {
    $executable = $this
      ->getMockBuilder('Drupal\\views\\ViewExecutable')
      ->disableOriginalConstructor()
      ->getMock();
    $storage = $this
      ->getMockBuilder('Drupal\\views\\Entity\\View')
      ->disableOriginalConstructor()
      ->getMock();
    $storage
      ->expects($this
      ->any())
      ->method('id')
      ->will($this
      ->returnValue('example_view'));
    $storage
      ->expects($this
      ->any())
      ->method('getExecutable')
      ->willReturn($executable);
    $executable->storage = $storage;
    $this->viewStorage
      ->expects($this
      ->any())
      ->method('load')
      ->with('example_view')
      ->willReturn($storage);
    $display_plugin = $this
      ->getMockBuilder('Drupal\\views\\Plugin\\views\\display\\PathPluginBase')
      ->setMethods([
      'getOption',
    ])
      ->disableOriginalConstructor()
      ->getMockForAbstractClass();
    $display_plugin
      ->expects($this
      ->once())
      ->method('getOption')
      ->with('menu')
      ->will($this
      ->returnValue([
      'type' => 'tab',
      'weight' => 12,
    ]));
    $executable->display_handler = $display_plugin;
    $result = [
      [
        'example_view',
        'page_1',
      ],
    ];
    $this->localTaskDerivative
      ->setApplicableMenuViews($result);

    // Mock the view route names state.
    $view_route_names = [];

    // Setup a view which overrides an existing route.
    $view_route_names['example_view.page_1'] = 'example_overridden_route';
    $this->state
      ->expects($this
      ->once())
      ->method('get')
      ->with('views.view_route_names')
      ->will($this
      ->returnValue($view_route_names));
    $definitions = $this->localTaskDerivative
      ->getDerivativeDefinitions($this->baseDefinition);
    $this
      ->assertCount(0, $definitions);
  }

  /**
   * Tests fetching the derivatives on a view with a default local task.
   */
  public function testGetDerivativeDefinitionsWithDefaultLocalTask() {
    $executable = $this
      ->getMockBuilder('Drupal\\views\\ViewExecutable')
      ->disableOriginalConstructor()
      ->getMock();
    $storage = $this
      ->getMockBuilder('Drupal\\views\\Entity\\View')
      ->disableOriginalConstructor()
      ->getMock();
    $storage
      ->expects($this
      ->any())
      ->method('id')
      ->will($this
      ->returnValue('example_view'));
    $storage
      ->expects($this
      ->any())
      ->method('getExecutable')
      ->willReturn($executable);
    $executable->storage = $storage;
    $this->viewStorage
      ->expects($this
      ->any())
      ->method('load')
      ->with('example_view')
      ->willReturn($storage);
    $display_plugin = $this
      ->getMockBuilder('Drupal\\views\\Plugin\\views\\display\\PathPluginBase')
      ->setMethods([
      'getOption',
    ])
      ->disableOriginalConstructor()
      ->getMockForAbstractClass();
    $display_plugin
      ->expects($this
      ->exactly(2))
      ->method('getOption')
      ->with('menu')
      ->will($this
      ->returnValue([
      'type' => 'default tab',
      'weight' => 12,
      'title' => 'Example title',
    ]));
    $executable->display_handler = $display_plugin;
    $result = [
      [
        'example_view',
        'page_1',
      ],
    ];
    $this->localTaskDerivative
      ->setApplicableMenuViews($result);

    // Mock the view route names state.
    $view_route_names = [];
    $view_route_names['example_view.page_1'] = 'view.example_view.page_1';
    $this->state
      ->expects($this
      ->exactly(2))
      ->method('get')
      ->with('views.view_route_names')
      ->will($this
      ->returnValue($view_route_names));
    $definitions = $this->localTaskDerivative
      ->getDerivativeDefinitions($this->baseDefinition);
    $this
      ->assertCount(1, $definitions);
    $plugin = $definitions['view.example_view.page_1'];
    $this
      ->assertEquals('view.example_view.page_1', $plugin['route_name']);
    $this
      ->assertEquals(12, $plugin['weight']);
    $this
      ->assertEquals('Example title', $plugin['title']);
    $this
      ->assertEquals($this->baseDefinition['class'], $plugin['class']);
    $this
      ->assertEquals('view.example_view.page_1', $plugin['base_route']);

    // Setup the prefix of the derivative.
    $definitions['views_view:view.example_view.page_1'] = $definitions['view.example_view.page_1'];
    unset($definitions['view.example_view.page_1']);
    $this->localTaskDerivative
      ->alterLocalTasks($definitions);
    $plugin = $definitions['views_view:view.example_view.page_1'];
    $this
      ->assertCount(1, $definitions);
    $this
      ->assertEquals('view.example_view.page_1', $plugin['route_name']);
    $this
      ->assertEquals(12, $plugin['weight']);
    $this
      ->assertEquals('Example title', $plugin['title']);
    $this
      ->assertEquals($this->baseDefinition['class'], $plugin['class']);
    $this
      ->assertEquals('view.example_view.page_1', $plugin['base_route']);
  }

  /**
   * Tests fetching the derivatives on a view with a local task and a parent.
   *
   * The parent is defined by another module, not views.
   */
  public function testGetDerivativeDefinitionsWithExistingLocalTask() {
    $executable = $this
      ->getMockBuilder('Drupal\\views\\ViewExecutable')
      ->disableOriginalConstructor()
      ->getMock();
    $storage = $this
      ->getMockBuilder('Drupal\\views\\Entity\\View')
      ->disableOriginalConstructor()
      ->getMock();
    $storage
      ->expects($this
      ->any())
      ->method('id')
      ->will($this
      ->returnValue('example_view'));
    $storage
      ->expects($this
      ->any())
      ->method('getExecutable')
      ->willReturn($executable);
    $executable->storage = $storage;
    $this->viewStorage
      ->expects($this
      ->any())
      ->method('load')
      ->with('example_view')
      ->willReturn($storage);
    $display_plugin = $this
      ->getMockBuilder('Drupal\\views\\Plugin\\views\\display\\PathPluginBase')
      ->setMethods([
      'getOption',
      'getPath',
    ])
      ->disableOriginalConstructor()
      ->getMockForAbstractClass();
    $display_plugin
      ->expects($this
      ->exactly(2))
      ->method('getOption')
      ->with('menu')
      ->will($this
      ->returnValue([
      'type' => 'tab',
      'weight' => 12,
      'title' => 'Example title',
    ]));
    $display_plugin
      ->expects($this
      ->once())
      ->method('getPath')
      ->will($this
      ->returnValue('path/example'));
    $executable->display_handler = $display_plugin;
    $result = [
      [
        'example_view',
        'page_1',
      ],
    ];
    $this->localTaskDerivative
      ->setApplicableMenuViews($result);

    // Mock the view route names state.
    $view_route_names = [];
    $view_route_names['example_view.page_1'] = 'view.example_view.page_1';
    $this->state
      ->expects($this
      ->exactly(2))
      ->method('get')
      ->with('views.view_route_names')
      ->will($this
      ->returnValue($view_route_names));

    // Mock the route provider.
    $route_collection = new RouteCollection();
    $route_collection
      ->add('test_route', new Route('/path'));
    $this->routeProvider
      ->expects($this
      ->any())
      ->method('getRoutesByPattern')
      ->with('/path')
      ->will($this
      ->returnValue($route_collection));

    // Setup the existing local task of the test_route.
    $definitions['test_route_tab'] = $other_tab = [
      'route_name' => 'test_route',
      'title' => 'Test route',
      'base_route' => 'test_route',
    ];
    $definitions += $this->localTaskDerivative
      ->getDerivativeDefinitions($this->baseDefinition);

    // Setup the prefix of the derivative.
    $definitions['views_view:view.example_view.page_1'] = $definitions['view.example_view.page_1'];
    unset($definitions['view.example_view.page_1']);
    $this->localTaskDerivative
      ->alterLocalTasks($definitions);
    $plugin = $definitions['views_view:view.example_view.page_1'];
    $this
      ->assertCount(2, $definitions);

    // Ensure the other local task was not changed.
    $this
      ->assertEquals($other_tab, $definitions['test_route_tab']);
    $this
      ->assertEquals('view.example_view.page_1', $plugin['route_name']);
    $this
      ->assertEquals(12, $plugin['weight']);
    $this
      ->assertEquals('Example title', $plugin['title']);
    $this
      ->assertEquals($this->baseDefinition['class'], $plugin['class']);
    $this
      ->assertEquals('test_route', $plugin['base_route']);
  }

}

Members

Namesort descending Modifiers Type Description Overrides
PhpunitCompatibilityTrait::getMock Deprecated public function Returns a mock object for the specified class using the available method.
PhpunitCompatibilityTrait::setExpectedException Deprecated public function Compatibility layer for PHPUnit 6 to support PHPUnit 4 code.
UnitTestCase::$randomGenerator protected property The random generator.
UnitTestCase::$root protected property The app root. 1
UnitTestCase::assertArrayEquals protected function Asserts if two arrays are equal by sorting them first.
UnitTestCase::getBlockMockWithMachineName Deprecated protected function Mocks a block with a block plugin. 1
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::getRandomGenerator protected function Gets the random generator for the utility methods.
UnitTestCase::getStringTranslationStub public function Returns a stub translation manager that just returns the passed string.
UnitTestCase::randomMachineName public function Generates a unique random string containing letters and numbers.
ViewsLocalTaskTest::$baseDefinition protected property
ViewsLocalTaskTest::$localTaskDerivative protected property The tested local task derivative class.
ViewsLocalTaskTest::$routeProvider protected property The mocked route provider.
ViewsLocalTaskTest::$state protected property The mocked key value storage.
ViewsLocalTaskTest::$viewStorage protected property
ViewsLocalTaskTest::setUp protected function Overrides UnitTestCase::setUp
ViewsLocalTaskTest::testGetDerivativeDefinitionsWithDefaultLocalTask public function Tests fetching the derivatives on a view with a default local task.
ViewsLocalTaskTest::testGetDerivativeDefinitionsWithExistingLocalTask public function Tests fetching the derivatives on a view with a local task and a parent.
ViewsLocalTaskTest::testGetDerivativeDefinitionsWithLocalTask public function Tests fetching the derivatives on a view with a default local task.
ViewsLocalTaskTest::testGetDerivativeDefinitionsWithoutHookMenuViews public function Tests fetching the derivatives on no view with hook menu.
ViewsLocalTaskTest::testGetDerivativeDefinitionsWithoutLocalTask public function Tests fetching the derivatives on a view with without a local task.
ViewsLocalTaskTest::testGetDerivativeDefinitionsWithOverrideRoute public function Tests fetching the derivatives on a view which overrides an existing route.