class ViewsLocalTaskTest

Same name in other branches
  1. 9 core/modules/views/tests/src/Unit/Plugin/Derivative/ViewsLocalTaskTest.php \Drupal\Tests\views\Unit\Plugin\Derivative\ViewsLocalTaskTest
  2. 8.9.x core/modules/views/tests/src/Unit/Plugin/Derivative/ViewsLocalTaskTest.php \Drupal\Tests\views\Unit\Plugin\Derivative\ViewsLocalTaskTest
  3. 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 16

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;
    
    /**
     * {@inheritdoc}
     */
    protected function setUp() : void {
        parent::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() : void {
        $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() : void {
        $executable = $this->getMockBuilder('Drupal\\views\\ViewExecutable')
            ->disableOriginalConstructor()
            ->getMock();
        $display_plugin = $this->getMockBuilder('Drupal\\views\\Plugin\\views\\display\\PathPluginBase')
            ->onlyMethods([
            'getOption',
        ])
            ->disableOriginalConstructor()
            ->getMock();
        $display_plugin->expects($this->once())
            ->method('getOption')
            ->with('menu')
            ->willReturn([
            'type' => 'normal',
        ]);
        $executable->display_handler = $display_plugin;
        $storage = $this->getMockBuilder('Drupal\\views\\Entity\\View')
            ->disableOriginalConstructor()
            ->getMock();
        $storage->expects($this->any())
            ->method('id')
            ->willReturn('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() : void {
        $executable = $this->getMockBuilder('Drupal\\views\\ViewExecutable')
            ->disableOriginalConstructor()
            ->getMock();
        $storage = $this->getMockBuilder('Drupal\\views\\Entity\\View')
            ->disableOriginalConstructor()
            ->getMock();
        $storage->expects($this->any())
            ->method('id')
            ->willReturn('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')
            ->onlyMethods([
            'getOption',
        ])
            ->disableOriginalConstructor()
            ->getMock();
        $display_plugin->expects($this->once())
            ->method('getOption')
            ->with('menu')
            ->willReturn([
            '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')
            ->willReturn($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->assertArrayNotHasKey('base_route', $definitions['view.example_view.page_1']);
    }
    
    /**
     * Tests fetching the derivatives on a view which overrides an existing route.
     */
    public function testGetDerivativeDefinitionsWithOverrideRoute() : void {
        $executable = $this->getMockBuilder('Drupal\\views\\ViewExecutable')
            ->disableOriginalConstructor()
            ->getMock();
        $storage = $this->getMockBuilder('Drupal\\views\\Entity\\View')
            ->disableOriginalConstructor()
            ->getMock();
        $storage->expects($this->any())
            ->method('id')
            ->willReturn('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')
            ->onlyMethods([
            'getOption',
        ])
            ->disableOriginalConstructor()
            ->getMock();
        $display_plugin->expects($this->once())
            ->method('getOption')
            ->with('menu')
            ->willReturn([
            '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')
            ->willReturn($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() : void {
        $executable = $this->getMockBuilder('Drupal\\views\\ViewExecutable')
            ->disableOriginalConstructor()
            ->getMock();
        $storage = $this->getMockBuilder('Drupal\\views\\Entity\\View')
            ->disableOriginalConstructor()
            ->getMock();
        $storage->expects($this->any())
            ->method('id')
            ->willReturn('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')
            ->onlyMethods([
            'getOption',
        ])
            ->disableOriginalConstructor()
            ->getMock();
        $display_plugin->expects($this->exactly(2))
            ->method('getOption')
            ->with('menu')
            ->willReturn([
            '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')
            ->willReturn($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() : void {
        $executable = $this->getMockBuilder('Drupal\\views\\ViewExecutable')
            ->disableOriginalConstructor()
            ->getMock();
        $storage = $this->getMockBuilder('Drupal\\views\\Entity\\View')
            ->disableOriginalConstructor()
            ->getMock();
        $storage->expects($this->any())
            ->method('id')
            ->willReturn('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')
            ->onlyMethods([
            'getOption',
            'getPath',
        ])
            ->disableOriginalConstructor()
            ->getMock();
        $display_plugin->expects($this->exactly(2))
            ->method('getOption')
            ->with('menu')
            ->willReturn([
            'type' => 'tab',
            'weight' => 12,
            'title' => 'Example title',
        ]);
        $display_plugin->expects($this->once())
            ->method('getPath')
            ->willReturn('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')
            ->willReturn($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')
            ->willReturn($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

Title 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.
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
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.

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