class ViewsLocalTaskTest in Drupal 10

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

Hierarchy

• class \Drupal\Tests\UnitTestCase extends \PHPUnit\Framework\TestCase uses \Drupal\Tests\PhpUnitCompatibilityTrait, \Symfony\Bridge\PhpUnit\ExpectDeprecationTrait, PhpUnitWarnings
  • class \Drupal\Tests\views\Unit\Plugin\Derivative\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

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() : void {
    $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')
      ->onlyMethods([
      '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')
      ->onlyMethods([
      '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
      ->assertArrayNotHasKey('base_route', $definitions['view.example_view.page_1']);
  }

  /**
   * 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')
      ->onlyMethods([
      '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')
      ->onlyMethods([
      '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')
      ->onlyMethods([
      '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

Name	Modifiers	Type	Description	Overrides
PhpUnitWarnings::$deprecationWarnings	private static	property	Deprecation warnings from PHPUnit to raise with @trigger_error().
PhpUnitWarnings::addWarning	public	function	Converts PHPUnit deprecation warnings to E_USER_DEPRECATED.
UnitTestCase::$randomGenerator	protected	property	The random generator.
UnitTestCase::$root	protected	property	The app root.	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.
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.