class LocalTaskDefaultTest

Same name and namespace in other branches
  1. 9 core/tests/Drupal/Tests/Core/Menu/LocalTaskDefaultTest.php \Drupal\Tests\Core\Menu\LocalTaskDefaultTest
  2. 8.9.x core/tests/Drupal/Tests/Core/Menu/LocalTaskDefaultTest.php \Drupal\Tests\Core\Menu\LocalTaskDefaultTest
  3. 10 core/tests/Drupal/Tests/Core/Menu/LocalTaskDefaultTest.php \Drupal\Tests\Core\Menu\LocalTaskDefaultTest

@coversDefaultClass \Drupal\Core\Menu\LocalTaskDefault
@group Menu

Hierarchy

Expanded class hierarchy of LocalTaskDefaultTest

File

core/tests/Drupal/Tests/Core/Menu/LocalTaskDefaultTest.php, line 18

Namespace

Drupal\Tests\Core\Menu
View source
class LocalTaskDefaultTest extends UnitTestCase {
  
  /**
   * The tested local task default plugin.
   *
   * @var \Drupal\Core\Menu\LocalTaskDefault
   */
  protected $localTaskBase;
  
  /**
   * The used plugin configuration.
   *
   * @var array
   */
  protected $config = [];
  
  /**
   * The used plugin ID.
   *
   * @var string
   */
  protected $pluginId = 'local_task_default';
  
  /**
   * The used plugin definition.
   *
   * @var array
   */
  protected $pluginDefinition = [
    'id' => 'local_task_default',
  ];
  
  /**
   * The mocked translator.
   *
   * @var \Drupal\Core\StringTranslation\TranslationInterface|\PHPUnit\Framework\MockObject\MockObject
   */
  protected $stringTranslation;
  
  /**
   * The mocked route provider.
   *
   * @var \Drupal\Core\Routing\RouteProviderInterface|\PHPUnit\Framework\MockObject\MockObject
   */
  protected $routeProvider;
  
  /**
   * {@inheritdoc}
   */
  protected function setUp() : void {
    parent::setUp();
    $this->stringTranslation = $this->createMock('Drupal\\Core\\StringTranslation\\TranslationInterface');
    $this->routeProvider = $this->createMock('Drupal\\Core\\Routing\\RouteProviderInterface');
  }
  
  /**
   * Setups the local task default.
   */
  protected function setupLocalTaskDefault() : void {
    $this->localTaskBase = new TestLocalTaskDefault($this->config, $this->pluginId, $this->pluginDefinition);
    $this->localTaskBase
      ->setRouteProvider($this->routeProvider);
  }
  
  /**
   * @covers ::getRouteParameters
   */
  public function testGetRouteParametersForStaticRoute() : void {
    $this->pluginDefinition = [
      'route_name' => 'test_route',
    ];
    $this->routeProvider
      ->expects($this->once())
      ->method('getRouteByName')
      ->with('test_route')
      ->willReturn(new Route('/test-route'));
    $this->setupLocalTaskDefault();
    $route_match = new RouteMatch('', new Route('/'));
    $this->assertEquals([], $this->localTaskBase
      ->getRouteParameters($route_match));
  }
  
  /**
   * @covers ::getRouteParameters
   */
  public function testGetRouteParametersInPluginDefinitions() : void {
    $this->pluginDefinition = [
      'route_name' => 'test_route',
      'route_parameters' => [
        'parameter' => 'example',
      ],
    ];
    $this->routeProvider
      ->expects($this->once())
      ->method('getRouteByName')
      ->with('test_route')
      ->willReturn(new Route('/test-route/{parameter}'));
    $this->setupLocalTaskDefault();
    $route_match = new RouteMatch('', new Route('/'));
    $this->assertEquals([
      'parameter' => 'example',
    ], $this->localTaskBase
      ->getRouteParameters($route_match));
  }
  
  /**
   * @covers ::getRouteParameters
   */
  public function testGetRouteParametersForDynamicRouteWithNonUpcastedParameters() : void {
    $this->pluginDefinition = [
      'route_name' => 'test_route',
    ];
    $route = new Route('/test-route/{parameter}');
    $this->routeProvider
      ->expects($this->once())
      ->method('getRouteByName')
      ->with('test_route')
      ->willReturn($route);
    $this->setupLocalTaskDefault();
    $route_match = new RouteMatch('', $route, [], [
      'parameter' => 'example',
    ]);
    $this->assertEquals([
      'parameter' => 'example',
    ], $this->localTaskBase
      ->getRouteParameters($route_match));
  }
  
  /**
   * Tests the getRouteParameters method for a route with upcasted parameters.
   *
   * @covers ::getRouteParameters
   */
  public function testGetRouteParametersForDynamicRouteWithUpcastedParameters() : void {
    $this->pluginDefinition = [
      'route_name' => 'test_route',
    ];
    $route = new Route('/test-route/{parameter}');
    $this->routeProvider
      ->expects($this->once())
      ->method('getRouteByName')
      ->with('test_route')
      ->willReturn($route);
    $this->setupLocalTaskDefault();
    $route_match = new RouteMatch('', $route, [
      'parameter' => (object) 'example2',
    ], [
      'parameter' => 'example',
    ]);
    $this->assertEquals([
      'parameter' => 'example',
    ], $this->localTaskBase
      ->getRouteParameters($route_match));
  }
  
  /**
   * Tests the getRouteParameters method for a route with upcasted parameters.
   *
   * @covers ::getRouteParameters
   */
  public function testGetRouteParametersForDynamicRouteWithUpcastedParametersEmptyRawParameters() : void {
    $this->pluginDefinition = [
      'route_name' => 'test_route',
    ];
    $route = new Route('/test-route/{parameter}');
    $this->routeProvider
      ->expects($this->once())
      ->method('getRouteByName')
      ->with('test_route')
      ->willReturn($route);
    $this->setupLocalTaskDefault();
    $route_match = new RouteMatch('', $route, [
      'parameter' => (object) 'example2',
    ]);
    $this->assertEquals([
      'parameter' => (object) 'example2',
    ], $this->localTaskBase
      ->getRouteParameters($route_match));
  }
  
  /**
   * Defines a data provider for testGetWeight().
   *
   * @return array
   *   A list or test plugin definition and expected weight.
   */
  public static function providerTestGetWeight() {
    return [
      // Manually specify a weight, so this is used.
[
        [
          'weight' => 314,
        ],
        'test_id',
        314,
      ],
      // Ensure that a default tab gets a lower weight.
[
        [
          'base_route' => 'local_task_default',
          'route_name' => 'local_task_default',
          'id' => 'local_task_default',
        ],
        'local_task_default',
        -10,
      ],
      // If the base route is different from the route of the tab, ignore it.
[
        [
          'base_route' => 'local_task_example',
          'route_name' => 'local_task_other',
          'id' => 'local_task_default',
        ],
        'local_task_default',
        0,
      ],
      // Ensure that a default tab of a derivative gets the default value.
[
        [
          'base_route' => 'local_task_example',
          'id' => 'local_task_derivative_default:example_id',
          'route_name' => 'local_task_example',
        ],
        'local_task_derivative_default:example_id',
        -10,
      ],
    ];
  }
  
  /**
   * @dataProvider providerTestGetWeight
   * @covers ::getWeight
   */
  public function testGetWeight($plugin_definition, $plugin_id, $expected_weight) : void {
    $this->pluginDefinition = $plugin_definition;
    $this->pluginId = $plugin_id;
    $this->setupLocalTaskDefault();
    $this->assertEquals($expected_weight, $this->localTaskBase
      ->getWeight());
  }
  
  /**
   * @covers ::getActive
   * @covers ::setActive
   */
  public function testActive() : void {
    $this->setupLocalTaskDefault();
    $this->assertFalse($this->localTaskBase
      ->getActive());
    $this->localTaskBase
      ->setActive();
    $this->assertTrue($this->localTaskBase
      ->getActive());
  }
  
  /**
   * @covers ::getTitle
   */
  public function testGetTitle() : void {
    $this->pluginDefinition['title'] = new TranslatableMarkup('Example', [], [], $this->stringTranslation);
    $this->stringTranslation
      ->expects($this->once())
      ->method('translateString')
      ->with($this->pluginDefinition['title'])
      ->willReturn('Example translated');
    $this->setupLocalTaskDefault();
    $this->assertEquals('Example translated', $this->localTaskBase
      ->getTitle());
  }
  
  /**
   * @covers ::getTitle
   */
  public function testGetTitleWithContext() : void {
    $title = 'Example';
    // phpcs:ignore Drupal.Semantics.FunctionT.NotLiteralString
    $this->pluginDefinition['title'] = new TranslatableMarkup($title, [], [
      'context' => 'context',
    ], $this->stringTranslation);
    $this->stringTranslation
      ->expects($this->once())
      ->method('translateString')
      ->with($this->pluginDefinition['title'])
      ->willReturn('Example translated with context');
    $this->setupLocalTaskDefault();
    $this->assertEquals('Example translated with context', $this->localTaskBase
      ->getTitle());
  }
  
  /**
   * @covers ::getTitle
   */
  public function testGetTitleWithTitleArguments() : void {
    $this->pluginDefinition['title'] = new TranslatableMarkup('Example @test', [
      '@test' => 'value',
    ], [], $this->stringTranslation);
    $this->stringTranslation
      ->expects($this->once())
      ->method('translateString')
      ->with($this->pluginDefinition['title'])
      ->willReturn('Example value');
    $this->setupLocalTaskDefault();
    $this->assertEquals('Example value', $this->localTaskBase
      ->getTitle());
  }
  
  /**
   * @covers ::getOptions
   */
  public function testGetOptions() : void {
    $this->pluginDefinition['options'] = [
      'attributes' => [
        'class' => [
          'example',
        ],
      ],
    ];
    $this->setupLocalTaskDefault();
    $route_match = new RouteMatch('', new Route('/'));
    $this->assertEquals($this->pluginDefinition['options'], $this->localTaskBase
      ->getOptions($route_match));
    $this->localTaskBase
      ->setActive(TRUE);
    $this->assertEquals([
      'attributes' => [
        'class' => [
          'example',
          'is-active',
        ],
      ],
    ], $this->localTaskBase
      ->getOptions($route_match));
  }
  
  /**
   * @covers ::getCacheContexts
   * @covers ::getCacheTags
   * @covers ::getCacheMaxAge
   */
  public function testCacheabilityMetadata() : void {
    $this->pluginDefinition['cache_contexts'] = [
      'route',
    ];
    $this->pluginDefinition['cache_tags'] = [
      'kitten',
    ];
    $this->pluginDefinition['cache_max_age'] = 3600;
    $this->setupLocalTaskDefault();
    $this->assertEquals([
      'route',
    ], $this->localTaskBase
      ->getCacheContexts());
    $this->assertEquals([
      'kitten',
    ], $this->localTaskBase
      ->getCacheTags());
    $this->assertEquals(3600, $this->localTaskBase
      ->getCacheMaxAge());
  }

}

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.
LocalTaskDefaultTest::$config protected property The used plugin configuration.
LocalTaskDefaultTest::$localTaskBase protected property The tested local task default plugin.
LocalTaskDefaultTest::$pluginDefinition protected property The used plugin definition.
LocalTaskDefaultTest::$pluginId protected property The used plugin ID.
LocalTaskDefaultTest::$routeProvider protected property The mocked route provider.
LocalTaskDefaultTest::$stringTranslation protected property The mocked translator.
LocalTaskDefaultTest::providerTestGetWeight public static function Defines a data provider for testGetWeight().
LocalTaskDefaultTest::setUp protected function Overrides UnitTestCase::setUp
LocalTaskDefaultTest::setupLocalTaskDefault protected function Setups the local task default.
LocalTaskDefaultTest::testActive public function @covers ::getActive[[api-linebreak]]
@covers ::setActive[[api-linebreak]]
LocalTaskDefaultTest::testCacheabilityMetadata public function @covers ::getCacheContexts[[api-linebreak]]
@covers ::getCacheTags[[api-linebreak]]
@covers ::getCacheMaxAge[[api-linebreak]]
LocalTaskDefaultTest::testGetOptions public function @covers ::getOptions[[api-linebreak]]
LocalTaskDefaultTest::testGetRouteParametersForDynamicRouteWithNonUpcastedParameters public function @covers ::getRouteParameters[[api-linebreak]]
LocalTaskDefaultTest::testGetRouteParametersForDynamicRouteWithUpcastedParameters public function Tests the getRouteParameters method for a route with upcasted parameters.
LocalTaskDefaultTest::testGetRouteParametersForDynamicRouteWithUpcastedParametersEmptyRawParameters public function Tests the getRouteParameters method for a route with upcasted parameters.
LocalTaskDefaultTest::testGetRouteParametersForStaticRoute public function @covers ::getRouteParameters[[api-linebreak]]
LocalTaskDefaultTest::testGetRouteParametersInPluginDefinitions public function @covers ::getRouteParameters[[api-linebreak]]
LocalTaskDefaultTest::testGetTitle public function @covers ::getTitle[[api-linebreak]]
LocalTaskDefaultTest::testGetTitleWithContext public function @covers ::getTitle[[api-linebreak]]
LocalTaskDefaultTest::testGetTitleWithTitleArguments public function @covers ::getTitle[[api-linebreak]]
LocalTaskDefaultTest::testGetWeight public function @dataProvider providerTestGetWeight
@covers ::getWeight[[api-linebreak]]
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.

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