class MenuActiveTrailTest

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

Tests the active menu trail service.

@group Menu

@coversDefaultClass \Drupal\Core\Menu\MenuActiveTrail

Hierarchy

Expanded class hierarchy of MenuActiveTrailTest

File

core/tests/Drupal/Tests/Core/Menu/MenuActiveTrailTest.php, line 25

Namespace

Drupal\Tests\Core\Menu
View source
class MenuActiveTrailTest extends UnitTestCase {
  
  /**
   * The tested active menu trail service.
   *
   * @var \Drupal\Core\Menu\MenuActiveTrail
   */
  protected $menuActiveTrail;
  
  /**
   * The test request stack.
   *
   * @var \Symfony\Component\HttpFoundation\RequestStack
   */
  protected $requestStack;
  
  /**
   * The current route match service.
   *
   * @var \Drupal\Core\Routing\CurrentRouteMatch
   */
  protected $currentRouteMatch;
  
  /**
   * The mocked menu link manager.
   *
   * @var \Drupal\Core\Menu\MenuLinkManagerInterface|\PHPUnit\Framework\MockObject\MockObject
   */
  protected $menuLinkManager;
  
  /**
   * The mocked cache backend.
   *
   * @var \Drupal\Core\Cache\CacheBackendInterface|\PHPUnit\Framework\MockObject\MockObject
   */
  protected $cache;
  
  /**
   * The mocked lock.
   *
   * @var \Drupal\Core\Lock\LockBackendInterface|\PHPUnit\Framework\MockObject\MockObject
   */
  protected $lock;
  
  /**
   * {@inheritdoc}
   */
  protected function setUp() : void {
    parent::setUp();
    $this->requestStack = new RequestStack();
    $this->currentRouteMatch = new CurrentRouteMatch($this->requestStack);
    $this->menuLinkManager = $this->createMock('Drupal\\Core\\Menu\\MenuLinkManagerInterface');
    $this->cache = $this->createMock('\\Drupal\\Core\\Cache\\CacheBackendInterface');
    $this->lock = $this->createMock('\\Drupal\\Core\\Lock\\LockBackendInterface');
    $this->menuActiveTrail = new MenuActiveTrail($this->menuLinkManager, $this->currentRouteMatch, $this->cache, $this->lock);
    $container = new Container();
    $container->set('cache_tags.invalidator', $this->createMock('\\Drupal\\Core\\Cache\\CacheTagsInvalidatorInterface'));
    \Drupal::setContainer($container);
  }
  
  /**
   * Provides test data for all test methods.
   *
   * @return array
   *   Returns a list of test data of which each is an array containing the
   *   following elements:
   *     - request: A request object.
   *     - links: An array of menu links keyed by ID.
   *     - menu_name: The active menu name.
   *     - expected_link: The expected active link for the given menu.
   */
  public static function provider() {
    $data = [];
    $mock_route = new Route('');
    $request = new Request();
    $request->attributes
      ->set(RouteObjectInterface::ROUTE_NAME, 'baby_llama');
    $request->attributes
      ->set(RouteObjectInterface::ROUTE_OBJECT, $mock_route);
    $request->attributes
      ->set('_raw_variables', new InputBag([]));
    $link_1 = MenuLinkMock::create([
      'id' => 'baby_llama_link_1',
      'route_name' => 'baby_llama',
      'title' => 'Baby llama',
      'parent' => 'mama_llama_link',
    ]);
    $link_2 = MenuLinkMock::create([
      'id' => 'baby_llama_link_2',
      'route_name' => 'baby_llama',
      'title' => 'Baby llama',
      'parent' => 'papa_llama_link',
    ]);
    // @see \Drupal\Core\Menu\MenuLinkManagerInterface::getParentIds()
    $link_1_parent_ids = [
      'baby_llama_link_1',
      'mama_llama_link',
      '',
    ];
    $empty_active_trail = [
      '',
    ];
    // No active link is returned when zero links match the current route.
    $data[] = [
      $request,
      [],
      Random::machineName(),
      NULL,
      $empty_active_trail,
    ];
    // The first (and only) matching link is returned when one link matches the
    // current route.
    $data[] = [
      $request,
      [
        'baby_llama_link_1' => $link_1,
      ],
      Random::machineName(),
      $link_1,
      $link_1_parent_ids,
    ];
    // The first of multiple matching links is returned when multiple links
    // match the current route, where "first" is determined by sorting by key.
    $data[] = [
      $request,
      [
        'baby_llama_link_1' => $link_1,
        'baby_llama_link_2' => $link_2,
      ],
      Random::machineName(),
      $link_1,
      $link_1_parent_ids,
    ];
    // No active link is returned in case of a 403.
    $request = new Request();
    $request->attributes
      ->set('_exception_statuscode', 403);
    $data[] = [
      $request,
      FALSE,
      Random::machineName(),
      NULL,
      $empty_active_trail,
    ];
    // No active link is returned when the route name is missing.
    $request = new Request();
    $data[] = [
      $request,
      FALSE,
      Random::machineName(),
      NULL,
      $empty_active_trail,
    ];
    return $data;
  }
  
  /**
   * Tests getActiveLink().
   *
   * @covers ::getActiveLink
   * @dataProvider provider
   */
  public function testGetActiveLink(Request $request, $links, $menu_name, $expected_link) : void {
    $this->requestStack
      ->push($request);
    if ($links !== FALSE) {
      $this->menuLinkManager
        ->expects($this->exactly(2))
        ->method('loadLinksByRoute')
        ->with('baby_llama')
        ->willReturn($links);
    }
    // Test with menu name.
    $this->assertSame($expected_link, $this->menuActiveTrail
      ->getActiveLink($menu_name));
    // Test without menu name.
    $this->assertSame($expected_link, $this->menuActiveTrail
      ->getActiveLink());
  }
  
  /**
   * Tests getActiveTrailIds().
   *
   * @covers ::getActiveTrailIds
   * @dataProvider provider
   */
  public function testGetActiveTrailIds(Request $request, $links, $menu_name, $expected_link, $expected_trail) : void {
    $expected_trail_ids = array_combine($expected_trail, $expected_trail);
    $this->requestStack
      ->push($request);
    if ($links !== FALSE) {
      // We expect exactly two calls, one for the first call, and one after the
      // cache clearing below.
      $this->menuLinkManager
        ->expects($this->exactly(2))
        ->method('loadLinksByRoute')
        ->with('baby_llama')
        ->willReturn($links);
      if ($expected_link !== NULL) {
        $this->menuLinkManager
          ->expects($this->exactly(2))
          ->method('getParentIds')
          ->willReturnMap([
          [
            $expected_link->getPluginId(),
            $expected_trail_ids,
          ],
        ]);
      }
    }
    // Call out the same twice in order to ensure that static caching works.
    $this->assertSame($expected_trail_ids, $this->menuActiveTrail
      ->getActiveTrailIds($menu_name));
    $this->assertSame($expected_trail_ids, $this->menuActiveTrail
      ->getActiveTrailIds($menu_name));
    $this->menuActiveTrail
      ->clear();
    $this->assertSame($expected_trail_ids, $this->menuActiveTrail
      ->getActiveTrailIds($menu_name));
  }
  
  /**
   * Tests getCid()
   *
   * @covers ::getCid
   */
  public function testGetCid() : void {
    $data = $this->provider()[1];
    /** @var \Symfony\Component\HttpFoundation\Request $request */
    $request = $data[0];
    /** @var \Symfony\Component\Routing\Route $route */
    $route = $request->attributes
      ->get(RouteObjectInterface::ROUTE_OBJECT);
    $route->setPath('/test/{b}/{a}');
    $request->attributes
      ->get('_raw_variables')
      ->add([
      'b' => 1,
      'a' => 0,
    ]);
    $this->requestStack
      ->push($request);
    $this->menuLinkManager
      ->expects($this->any())
      ->method('loadLinksByRoute')
      ->with('baby_llama')
      ->willReturn($data[1]);
    $expected_link = $data[3];
    $expected_trail = $data[4];
    $expected_trail_ids = array_combine($expected_trail, $expected_trail);
    $this->menuLinkManager
      ->expects($this->any())
      ->method('getParentIds')
      ->willReturnMap([
      [
        $expected_link->getPluginId(),
        $expected_trail_ids,
      ],
    ]);
    $this->assertSame($expected_trail_ids, $this->menuActiveTrail
      ->getActiveTrailIds($data[2]));
    $this->cache
      ->expects($this->once())
      ->method('set')
      ->with('active-trail:route:baby_llama:route_parameters:' . serialize([
      'a' => 0,
      'b' => 1,
    ]));
    $this->lock
      ->expects($this->any())
      ->method('acquire')
      ->willReturn(TRUE);
    $this->menuActiveTrail
      ->destruct();
  }

}

Members

Title Sort descending Deprecated Modifiers Object type Summary Overriden Title Overrides
MenuActiveTrailTest::$cache protected property The mocked cache backend.
MenuActiveTrailTest::$currentRouteMatch protected property The current route match service.
MenuActiveTrailTest::$lock protected property The mocked lock.
MenuActiveTrailTest::$menuActiveTrail protected property The tested active menu trail service.
MenuActiveTrailTest::$menuLinkManager protected property The mocked menu link manager.
MenuActiveTrailTest::$requestStack protected property The test request stack.
MenuActiveTrailTest::provider public static function Provides test data for all test methods.
MenuActiveTrailTest::setUp protected function Overrides UnitTestCase::setUp
MenuActiveTrailTest::testGetActiveLink public function Tests getActiveLink().
MenuActiveTrailTest::testGetActiveTrailIds public function Tests getActiveTrailIds().
MenuActiveTrailTest::testGetCid public function Tests getCid()
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.