class LocalTaskDefaultTest

Same name 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. 11.x 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() {
        $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';
        $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 Deprecated Modifiers Object type Summary Overriden Title Overrides
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
@covers ::setActive
LocalTaskDefaultTest::testCacheabilityMetadata public function @covers ::getCacheContexts
@covers ::getCacheTags
@covers ::getCacheMaxAge
LocalTaskDefaultTest::testGetOptions public function @covers ::getOptions
LocalTaskDefaultTest::testGetRouteParametersForDynamicRouteWithNonUpcastedParameters public function @covers ::getRouteParameters
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
LocalTaskDefaultTest::testGetRouteParametersInPluginDefinitions public function @covers ::getRouteParameters
LocalTaskDefaultTest::testGetTitle public function @covers ::getTitle
LocalTaskDefaultTest::testGetTitleWithContext public function @covers ::getTitle
LocalTaskDefaultTest::testGetTitleWithTitleArguments public function @covers ::getTitle
LocalTaskDefaultTest::testGetWeight public function @dataProvider providerTestGetWeight
@covers ::getWeight
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.
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.
RandomGeneratorTrait::randomStringValidate Deprecated public function Callback for random string validation.
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::getStringTranslationStub public function Returns a stub translation manager that just returns the passed string.
UnitTestCase::setUpBeforeClass public static function
UnitTestCase::__get public function

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