function AssertBreadcrumbTrait::assertBreadcrumbParts

Assert that a trail exists in the internal browser.

Parameters

array $trail: An associative array whose keys are expected breadcrumb link paths and whose values are expected breadcrumb link texts (not sanitized).

File

core/modules/system/tests/src/Functional/Menu/AssertBreadcrumbTrait.php, line 65

Class

AssertBreadcrumbTrait

Provides test assertions for verifying breadcrumbs.

Namespace

Code

protected function assertBreadcrumbParts($trail) {
  // Compare paths with actual breadcrumb.
  $parts = $this->getBreadcrumbParts();
  $pass = TRUE;
  // Fail if there is no breadcrumb and we have a trail.
  if (!empty($trail) && empty($parts)) {
    $pass = FALSE;
  }
  // There may be more than one breadcrumb on the page. If $trail is empty
  // this test would go into an infinite loop, so we need to check that too.
  while ($trail && !empty($parts)) {
    foreach ($trail as $path => $title) {
      // If the path is empty, generate the path from the <front> route.  If
      // the path does not start with a leading slash, then run it through
      // Url::fromUri('base:')->toString() to get the correct base
      // prepended.
      if ($path == '') {
        $url = Url::fromRoute('<front>')->toString();
      }
      elseif ($path[0] != '/') {
        $url = Url::fromUri('base:' . $path)->toString();
      }
      else {
        $url = $path;
      }
      $part = array_shift($parts);
      $pass = $pass && $part['href'] === $url && $part['text'] === Html::escape($title);
    }
  }
  // No parts must be left, or an expected "Home" will always pass.
  $pass = $pass && empty($parts);
  $this->assertTrue($pass, new FormattableMarkup('Breadcrumb %parts found on @path.', [
    '%parts' => implode(' » ', $trail),
    '@path' => $this->getUrl(),
  ]));
}