abstract class TourTestBase in Drupal 10

Base class for testing Tour functionality.

Hierarchy

• class \Drupal\Tests\BrowserTestBase extends \PHPUnit\Framework\TestCase uses \Drupal\Tests\PhpUnitCompatibilityTrait, \Symfony\Bridge\PhpUnit\ExpectDeprecationTrait, FunctionalTestSetupTrait, TestSetupTrait, BlockCreationTrait, ConfigTestTrait, ExtensionListTestTrait, ContentTypeCreationTrait, NodeCreationTrait, RandomGeneratorTrait, TestRequirementsTrait, PhpUnitWarnings, UiHelperTrait, UserCreationTrait, XdebugRequestTrait
  • class \Drupal\Tests\tour\Functional\TourTestBase

4 files declare their use of TourTestBase

BlockLayoutTourTest.php in core/modules/block/tests/src/Functional/BlockLayoutTourTest.php

LanguageTourTest.php in core/modules/language/tests/src/Functional/LanguageTourTest.php

LocaleTranslateStringTourTest.php in core/modules/locale/tests/src/Functional/LocaleTranslateStringTourTest.php

ViewsUITourTest.php in core/modules/views_ui/tests/src/Functional/ViewsUITourTest.php

File

core/modules/tour/tests/src/Functional/TourTestBase.php, line 11

Namespace

Drupal\Tests\tour\Functional

abstract class TourTestBase extends BrowserTestBase {

  /**
   * Assert function to determine if tips rendered to the page
   * have a corresponding page element.
   *
   * @code
   * // Basic example.
   * $this->assertTourTips();
   *
   * // Advanced example. The following would be used for multipage or
   * // targeting a specific subset of tips.
   * $tips = array();
   * $tips[] = array('data-id' => 'foo');
   * $tips[] = array('data-id' => 'bar');
   * $tips[] = array('data-class' => 'baz');
   * $this->assertTourTips($tips);
   * @endcode
   *
   * @param array $tips
   *   A list of tips which provide either a "data-id" or "data-class".
   */
  public function assertTourTips($tips = []) {

    // Get the rendered tips and their data-id and data-class attributes.
    if (empty($tips)) {

      // Tips are rendered as drupalSettings values.
      $drupalSettings = $this
        ->getDrupalSettings();
      if (isset($drupalSettings['_tour_internal'])) {
        foreach ($drupalSettings['_tour_internal'] as $tip) {
          $tips[] = [
            'selector' => $tip['selector'] ?? NULL,
          ];
        }
      }
    }

    // If the tips are still empty we need to fail.
    if (empty($tips)) {
      $this
        ->fail('Could not find tour tips on the current page.');
    }
    else {

      // Check for corresponding page elements.
      $total = 0;
      $modals = 0;
      foreach ($tips as $tip) {
        if (!empty($tip['data-id'])) {
          $elements = $this
            ->getSession()
            ->getPage()
            ->findAll('css', '#' . $tip['data-id']);
          $this
            ->assertCount(1, $elements, new FormattableMarkup('Found corresponding page element for tour tip with id #%data-id', [
            '%data-id' => $tip['data-id'],
          ]));
        }
        elseif (!empty($tip['data-class'])) {
          $elements = $this
            ->getSession()
            ->getPage()
            ->findAll('css', '.' . $tip['data-class']);
          $this
            ->assertNotEmpty($elements, sprintf("Page element for tour tip with class .%s should be present", $tip['data-class']));
        }
        else {

          // It's a modal.
          $modals++;
        }
        $total++;
      }
    }
  }

}