You are here

Home » API reference » Acquia Content Hub 8.2 » ImportExportTestBase.php

abstract class ImportExportTestBase in Acquia Content Hub 8.2

Base for testing exports and imports.

@package Drupal\Tests\acquia_contenthub\Kernel

Hierarchy

Expanded class hierarchy of ImportExportTestBase

File

tests/src/Kernel/ImportExportTestBase.php, line 24

Namespace

Drupal\Tests\acquia_contenthub\Kernel
View source 
abstract class ImportExportTestBase extends EntityKernelTestBase {
  use DrupalVersion;
  const ENTITY_REFERENCE_TYPES = [
    'file',
    'entity_reference',
    'entity_reference_revisions',
  ];
  const ENTITY_REFERENCE_IMAGE_TYPE = 'image';

  /**
   * Fixtures for the test.
   *
   * @var array
   */
  protected $fixtures = [];

  /**
   * {@inheritdoc}
   */
  public static $modules = [
    'system',
    'depcalc',
    'acquia_contenthub',
  ];

  /**
   * List of properties to be ignored on export tests.
   *
   * @var array
   */
  public static $normalizeList = [
    'content_translation_created',
    'content_translation_changed',
    'content_translation_outdated',
    'content_translation_source',
    'menu_link',
    'revision_created',
    'revision_translation_affected',
    'revision_log',
    'comment',
  ];

  /**
   * {@inheritdoc}
   */
  protected function setUp() {
    if (version_compare(\Drupal::VERSION, '9.0', '>=')) {
      static::$modules[] = 'path_alias';
    }
    parent::setUp();
    if (version_compare(\Drupal::VERSION, '8.8.0', '>=')) {
      $this
        ->installEntitySchema('path_alias');
    }
  }

  /**
   * Returns fixture content.
   *
   * @param int $delta
   *   Fixture delta.
   *
   * @return false|string
   *   Fixture string if file exists.
   *
   * @throws \Exception
   */
  protected function getFixtureString(int $delta) {
    if (!empty($this->fixtures[$delta])) {
      $version_directory = $this
        ->getDrupalVersion();
      $path_to_fixture = sprintf("%s/tests/fixtures/import/{$version_directory}/%s", drupal_get_path('module', 'acquia_contenthub'), $this->fixtures[$delta]['cdf']);
      return file_get_contents($path_to_fixture);
    }
    throw new \Exception(sprintf("Missing fixture for delta %d in class %s", $delta, __CLASS__));
  }

  /**
   * Returns fixture expectations.
   *
   * @param int $delta
   *   Delta.
   *
   * @return mixed
   *   Expectations array.
   *
   * @throws \Exception
   */
  protected function getFixtureExpectations(int $delta) {
    if (!empty($this->fixtures[$delta])) {
      $version_directory = $this
        ->getDrupalVersion();
      $path_to_fixture = sprintf("%s/tests/fixtures/import/{$version_directory}/%s", drupal_get_path('module', 'acquia_contenthub'), $this->fixtures[$delta]['expectations']);
      return include $path_to_fixture;

      //@codingStandardsIgnoreLine
    }
    throw new \Exception(sprintf("Missing expectations for delta %d in class %s", $delta, __CLASS__));
  }

  /**
   * Creates CDF document from fixture.
   *
   * @param int $delta
   *   The delta of the filename to retrieve from the local fixtures property.
   *
   * @return \Acquia\ContentHubClient\CDFDocument
   *   CDF document.
   *
   * @throws \Exception
   */
  protected function createCdfDocumentFromFixture(int $delta) : CDFDocument {
    $json = $this
      ->getFixtureString($delta);
    $data = Json::decode($json);
    $document_parts = [];
    foreach ($data['entities'] as $entity) {
      $document_parts[] = $this
        ->populateCdfObject($entity);
    }
    $cdf_document = new CDFDocument(...$document_parts);
    return $cdf_document;
  }

  /**
   * Populates CDF object from array.
   *
   * @param array $data
   *   CDFObject data.
   *
   * @return \Acquia\ContentHubClient\CDF\CDFObject
   *   Populated CDF object.
   *
   * @throws \Exception
   *
   * @see \Acquia\ContentHubClient\ContentHubClient::getEntities()
   */
  protected function populateCdfObject(array $data) {
    $event = new GetCDFTypeEvent($data);
    $subscriber = new DefaultCDF();
    $subscriber
      ->onGetCDFType($event);
    return $event
      ->getObject();
  }

  /**
   * Import fixture.
   *
   * @param int $delta
   *   Delta.
   *
   * @return mixed
   *   Expectations.
   *
   * @throws \Drupal\Core\Entity\EntityStorageException
   * @throws \Exception
   */
  protected function importFixture(int $delta) {
    $expectations = $this
      ->getFixtureExpectations($delta);
    $document = $this
      ->createCdfDocumentFromFixture($delta);
    $stack = new DependencyStack();
    $this
      ->getSerializer()
      ->unserializeEntities($document, $stack);
    return $expectations;
  }

  /**
   * Executes the set of import/export tests on a configuration entity.
   *
   * @param int $delta
   *   Fixture delta.
   * @param array $validate_data
   *   Data.
   * @param string $export_type
   *   Exported entity type.
   * @param string $export_uuid
   *   Entity UUID.
   *
   * @throws \Drupal\Core\Entity\EntityStorageException
   * @throws \Exception
   */
  public function configEntityImportExport(int $delta, array $validate_data, $export_type, $export_uuid) {
    $expectations = $this
      ->importFixture($delta);
    foreach ($validate_data as $item) {
      [
        'type' => $type,
        'uuid' => $uuid,
      ] = $item;
      if (!isset($expectations[$uuid])) {
        throw new \Exception(sprintf('You are missing validation for the entity of type %s of uuid %s.', $type, $uuid));
      }

      /** @var \Drupal\Tests\acquia_contenthub\Kernel\Stubs\CdfExpectations $expectation */
      $expectation = $expectations[$uuid];

      /** @var \Drupal\Core\Entity\EntityInterface|\Drupal\Core\Config\Entity\ConfigEntityType $entity */
      $entity = $this
        ->getEntity($type, $uuid, $expectation);

      /** @var \Drupal\Core\Config\Entity\ConfigEntityType $entity_type */
      $entity_type = $entity
        ->getEntityType();
      $config_name = $entity_type
        ->getConfigPrefix() . '.' . $entity
        ->get($entity_type
        ->getKey('id'));

      // Perform assertions against imported configuration entity.
      $this
        ->assertImportedConfigEntity($expectation, $config_name);
    }

    // Perform assertions against exported configuration entities.
    $expectation = $expectations[$export_uuid] ?? NULL;
    $this
      ->assertExportedConfigEntities($delta, $export_type, $export_uuid, $expectation);
  }

  /**
   * Returns Entity object.
   *
   * @param string $type
   *   Entity type.
   * @param string $uuid
   *   Entity UUID.
   * @param \Drupal\Tests\acquia_contenthub\Kernel\Stubs\CdfExpectations $expectation
   *   The Expectation object.
   *
   * @return \Drupal\Core\Entity\EntityInterface
   *   Entity.
   *
   * @throws \Drupal\Core\Entity\EntityStorageException
   * @throws \Exception
   *
   * @see CdfExpectations::setEntityLoader()
   */
  protected function getEntity($type, $uuid, CdfExpectations $expectation = NULL) : EntityInterface {

    /** @var \Drupal\Core\Entity\EntityRepositoryInterface $repository */
    $repository = $this->container
      ->get('entity.repository');
    $entity = $repository
      ->loadEntityByUuid($type, $uuid);
    if ($entity) {
      return $entity;
    }

    // Some configuration entities may change UUID value on import, such as
    // "view" configuration entity. So give them a chance to be loaded via
    // a custom entity loader (fallback) provided in the expectation definition.
    if ($expectation && ($entity_loader = $expectation
      ->getEntityLoader())) {
      $entity = call_user_func($entity_loader);
      if ($entity) {
        return $entity;
      }
    }
    throw new \Exception(sprintf('Failed to load entity of %s type by uuid=%s.', $type, $uuid));
  }

  /**
   * Executes assertions on an imported configuration entity.
   *
   * @param \Drupal\Tests\acquia_contenthub\Kernel\Stubs\CdfExpectations $expectation
   *   Expectation object.
   * @param string $config_name
   *   Unique entity configuration name.
   *
   * @throws \Exception
   */
  protected function assertImportedConfigEntity(CdfExpectations $expectation, string $config_name) : void {
    if (!$expectation
      ->getLangcodes()) {

      // Perform language-agnostic assertions.
      foreach ($expectation
        ->getFieldNames() as $field_name) {
        $actual_value = \Drupal::config($config_name)
          ->get($field_name);
        $expected_value = $expectation
          ->getFieldValue($field_name);
        $this
          ->assertEquals($expected_value, $actual_value);
      }
      return;
    }

    /** @var \Drupal\Core\Language\LanguageManagerInterface $language_manager */
    $language_manager = $this->container
      ->get('language_manager');

    // Get the default language.
    $default_language = $language_manager
      ->getCurrentLanguage();
    foreach ($expectation
      ->getLangcodes() as $langcode) {
      $language = $language_manager
        ->getLanguage($langcode);
      $language_manager
        ->setConfigOverrideLanguage($language);
      foreach ($expectation
        ->getFieldNames() as $field_name) {
        if (FALSE !== strpos($field_name, ':')) {

          // Retrieve a second-level configuration value.
          [
            $field_name_level1,
            $field_name_level2,
          ] = explode(':', $field_name);
          $actual_value = \Drupal::config($config_name)
            ->get($field_name_level1);
          if (!isset($actual_value[$field_name_level2])) {
            throw new \Exception(sprintf("Failed to get actual value for '%s' field defined in the expectation file ('%s' configuration).", $field_name, $config_name));
          }
          $actual_value = $actual_value[$field_name_level2];
        }
        else {
          $actual_value = \Drupal::config($config_name)
            ->get($field_name);
        }
        $expected_value = $expectation
          ->getFieldValue($field_name, $langcode);
        $this
          ->assertEquals($expected_value, $actual_value);
      }
    }

    // Restore the default language.
    $language_manager
      ->setConfigOverrideLanguage($default_language);
  }

  /**
   * Executes assertions on a set of exported configuration entities.
   *
   * @param int $delta
   *   Delta.
   * @param string $type
   *   Exported entity type.
   * @param string $uuid
   *   Exported entity UUID.
   * @param \Drupal\Tests\acquia_contenthub\Kernel\Stubs\CdfExpectations $expectation
   *   The Expectation object.
   *
   * @throws \Exception
   */
  protected function assertExportedConfigEntities(int $delta, string $type, string $uuid, CdfExpectations $expectation = NULL) : void {
    $entity = $this
      ->getEntity($type, $uuid, $expectation);
    $wrapper = new DependentEntityWrapper($entity);
    $stack = new DependencyStack();
    $this
      ->getCalculator()
      ->calculateDependencies($wrapper, $stack);
    $entities = NestedArray::mergeDeep([
      $wrapper
        ->getUuid() => $wrapper,
    ], $stack
      ->getDependenciesByUuid(array_keys($wrapper
      ->getDependencies())));
    $data = $this
      ->getSerializer()
      ->serializeEntities(...array_values($entities));
    $document = new CDFDocument(...$data);

    /** @var \Acquia\ContentHubClient\CDF\CDFObject[] $cdf_objects */
    $cdf_objects = [];

    // Reindex objects for easier assertions.
    foreach ($document
      ->getEntities() as $cdf_object) {
      $cdf_objects[$cdf_object
        ->getUuid()] = $cdf_object;
    }
    $count = 0;
    $fixtures = json_decode($this
      ->getFixtureString($delta), TRUE);
    foreach ($fixtures['entities'] as $fixture) {
      $cdf_object = $cdf_objects[$fixture['uuid']] ?? $cdf_objects[$entity
        ->uuid()];
      $object = $this
        ->decodeDataByObjectType($cdf_object
        ->getMetadata()['data'], $cdf_object
        ->getType());
      $fixture = $this
        ->decodeDataByObjectType($fixture['metadata']['data'], $fixture['type']);

      // Exclude UUID keys.
      $langcode = $this->container
        ->get('language_manager')
        ->getDefaultLanguage()
        ->getId();
      unset($object[$langcode]['uuid']);
      unset($fixture[$langcode]['uuid']);
      $this
        ->assertEquals($fixture, $object);
      $count++;
    }
    $this
      ->assertEquals($count, count($cdf_objects));
  }

  /**
   * Import and export content.
   *
   * @param int $delta
   *   Fixture delta.
   * @param array $validate_data
   *   Data.
   * @param string $export_type
   *   Exported entity type.
   * @param string $export_uuid
   *   Entity UUID.
   * @param bool $compare_exports
   *   Runs extended fixture/export comparison. FALSE for mismatched uuids.
   *
   * @throws \Drupal\Component\Plugin\Exception\InvalidPluginDefinitionException
   * @throws \Drupal\Component\Plugin\Exception\PluginNotFoundException
   * @throws \Drupal\Core\Entity\EntityStorageException
   */
  public function contentEntityImportExport(int $delta, array $validate_data, $export_type, $export_uuid, $compare_exports = TRUE) {
    $expectations = $this
      ->importFixture($delta);

    /** @var \Drupal\Core\Entity\EntityRepositoryInterface $repository */
    $repository = $this->container
      ->get('entity.repository');
    foreach ($validate_data as $datum) {
      $entity_type = $datum['type'];
      $validate_uuid = $datum['uuid'];

      /** @var \Drupal\Core\Entity\ContentEntityInterface $entity */
      $entity = $repository
        ->loadEntityByUuid($entity_type, $validate_uuid);
      if (!isset($expectations[$validate_uuid])) {
        throw new \Exception(sprintf("You are missing validation for the entity of type %s of uuid %s.", $entity_type, $validate_uuid));
      }

      /** @var \Drupal\Tests\acquia_contenthub\Kernel\Stubs\CdfExpectations $expectation */
      $expectation = $expectations[$validate_uuid];
      foreach ($entity
        ->getTranslationLanguages() as $language) {
        $trans = $entity
          ->getTranslation($language
          ->getId());

        /** @var \Drupal\Core\Field\FieldItemListInterface $field */
        foreach ($trans as $field_name => $field) {
          if ($expectation
            ->isExcludedField($field_name)) {
            continue;
          }
          $actual_value = $this
            ->handleFieldValues($field);
          $expected_value = $expectation
            ->getFieldValue($field_name, $language
            ->getId());
          $message = 'File: ' . $this->fixtures[$delta]['expectations'];
          $message .= "\nEntity: " . $trans
            ->uuid();
          $message .= "\nField name: " . $field_name;
          $message .= "\nExpected:\n" . print_r($expected_value, TRUE) . "\nActual:\n" . print_r($actual_value, TRUE);
          $expected_value = $this
            ->cleanLineEndings($expected_value);
          $actual_value = $this
            ->cleanLineEndings($actual_value);
          $this
            ->assertEquals($expected_value, $actual_value, $message);
        }
      }
    }
    $export_entity = $repository
      ->loadEntityByUuid($export_type, $export_uuid);
    $wrapper = new DependentEntityWrapper($export_entity);
    $stack = new DependencyStack();
    $this
      ->getCalculator()
      ->calculateDependencies($wrapper, $stack);
    $entities = NestedArray::mergeDeep([
      $wrapper
        ->getUuid() => $wrapper,
    ], $stack
      ->getDependenciesByUuid(array_keys($wrapper
      ->getDependencies())));
    $data = $this
      ->getSerializer()
      ->serializeEntities(...array_values($entities));
    $document = new CDFDocument(...$data);
    $fixtures = json_decode($this
      ->getFixtureString($delta), TRUE);

    /** @var \Acquia\ContentHubClient\CDF\CDFObject[] $objects */
    $objects = [];

    // Reindex objects for easier assertions.
    foreach ($document
      ->getEntities() as $object) {
      if ($object
        ->getType() !== 'drupal8_content_entity') {
        continue;
      }
      $objects[$object
        ->getUuid()] = $object;
    }
    if (!$compare_exports) {
      return;
    }

    // Exclusively check content entities because configuration will need
    // separate test coverage.
    $count = 0;
    foreach ($fixtures['entities'] as $fixture) {
      if ($fixture['type'] !== 'drupal8_content_entity') {
        continue;
      }
      $count++;
      $uuid = $fixture['uuid'];
      $object = $this
        ->decodeDataByObjectType($objects[$fixture['uuid']]
        ->getMetadata()['data'], 'drupal8_content_entity');
      $fixture = $this
        ->decodeDataByObjectType($fixture['metadata']['data'], 'drupal8_content_entity');
      [
        $fixture,
        $object,
      ] = $this
        ->normalizeFixtureAndObject($fixture, $object);
      $this
        ->assertEquals($fixture, $object, "Testing object {$uuid}.");
    }
    $this
      ->assertEquals($count, count($objects));
  }

  /**
   * Get the CDF serializer.
   *
   * @return \Drupal\acquia_contenthub\EntityCdfSerializer
   *   CDF serializer.
   *
   * @throws \Exception
   */
  protected function getSerializer() {
    return \Drupal::service('entity.cdf.serializer');
  }

  /**
   * Get the dependency calculator.
   *
   * @return \Drupal\depcalc\DependencyCalculator
   *   Dependency calculator.
   *
   * @throws \Exception
   */
  protected function getCalculator() {
    return \Drupal::service('entity.dependency.calculator');
  }

  /**
   * Handle custom field types to more accurately match expectations.
   *
   * @param \Drupal\Core\Field\FieldItemListInterface $field
   *   The field being handled.
   *
   * @return array|mixed
   *   Field value.
   *
   * @throws \Drupal\Component\Plugin\Exception\InvalidPluginDefinitionException
   * @throws \Drupal\Component\Plugin\Exception\PluginNotFoundException
   */
  protected function handleFieldValues(FieldItemListInterface $field) {
    $values = $field
      ->getValue();
    if (in_array($field
      ->getFieldDefinition()
      ->getType(), self::ENTITY_REFERENCE_TYPES) && $values) {
      $values = [];
      foreach ($field as $item_delta => $item) {
        if ($item
          ->getValue()['target_id']) {
          $values[$item_delta]['target_id'] = $item->entity
            ->uuid();
        }
      }
    }
    if ($field
      ->getFieldDefinition()
      ->getType() === self::ENTITY_REFERENCE_IMAGE_TYPE && $values) {
      $values = [];
      foreach ($field as $item_delta => $item) {
        if ($item
          ->getValue()['target_id']) {
          $values[$item_delta] = $item
            ->getValue();
          $values[$item_delta]['target_id'] = $item->entity
            ->uuid();
        }
      }
    }
    if ($field
      ->getFieldDefinition()
      ->getType() === 'link') {
      foreach ($field as $item_delta => $item) {
        [
          $uri_type,
          $uri,
        ] = explode(':', $item
          ->getValue()['uri']);
        if ($uri_type === 'entity') {
          [
            $item_entity_type,
            $item_entity_id,
          ] = explode('/', $uri);
          $uri_entity = $this->entityTypeManager
            ->getStorage($item_entity_type)
            ->load($item_entity_id);
          $values[$item_delta]['uri'] = $uri_entity
            ->uuid();
        }
        elseif ($uri_type === 'internal') {
          $uri = ltrim($uri, '/');
          if (substr_count($uri, '/') > 0) {
            [
              $item_entity_type,
              $item_entity_id,
            ] = explode('/', $uri, 2);
            try {
              $uri_storage = $this->entityTypeManager
                ->getStorage($item_entity_type);
              $uri_entity = !is_null($uri_storage) ? $uri_storage
                ->load($item_entity_id) : NULL;
              if ($uri_entity) {
                $values[$item_delta]['uri'] = $uri_entity
                  ->uuid();
              }
              else {
                $values[$item_delta]['uri'] = $item
                  ->getValue()['uri'];
              }
            } catch (\Exception $e) {
              $values[$item_delta]['uri'] = $item
                ->getValue()['uri'];
            }
          }
          else {
            $values[$item_delta]['uri'] = $item
              ->getValue()['uri'];
          }
        }
        else {
          $values[$item_delta]['uri'] = $item
            ->getValue()['uri'];
        }
      }
    }
    return $values;
  }

  /**
   * Normalize fixture and expected object.
   *
   * @param array $fixture
   *   Fixture.
   * @param array $object
   *   Object.
   *
   * @return array
   *   Normalized data.
   */
  protected function normalizeFixtureAndObject(array $fixture, array $object) : array {
    $list = self::$normalizeList;

    // If the fixture had no value, we should not evaluate the object.
    foreach ($fixture as $key => $value) {
      if (!$value) {
        $list[] = $key;
      }
    }
    foreach ($list as $item) {
      if (isset($fixture[$item])) {
        unset($fixture[$item]);
      }
      if (isset($object[$item])) {
        unset($object[$item]);
      }
    }
    return [
      $fixture,
      $object,
    ];
  }

  /**
   * Standardize OS line endings for the sake of comparison.
   *
   * @param array|string $value
   *   The value to process.
   *
   * @return array|string|string[]|null
   *   Returns the submitted value with standardized line endings.
   */
  protected function cleanLineEndings($value) {
    if (is_string($value)) {
      $value = preg_replace('/(\\r\\n|\\n\\r|\\r)/', "\n", $value);
    }
    if (is_array($value)) {
      array_walk_recursive($value, function (&$item) {
        $item = $this
          ->cleanLineEndings($item);
      });
    }
    return $value;
  }

  /**
   * Decodes a data depending on object type.
   *
   * @param string $data
   *   The data to be decoded.
   * @param string $object_type
   *   The object type.
   *
   * @return mixed
   *   The decoded object.
   */
  protected function decodeDataByObjectType(string $data, string $object_type) {
    switch ($object_type) {
      case 'drupal8_config_entity':
        return Yaml::decode(base64_decode($data));
      case 'drupal8_content_entity':
      default:
        return json_decode(base64_decode($data), TRUE);
    }
  }

  /**
   * Loads an entity of a given type by UUID.
   *
   * @param string $entity_type
   *   The entity type.
   * @param string $uuid
   *   The UUID.
   *
   * @return \Drupal\Core\Entity\EntityInterface|bool
   *   The entity (if any).
   *
   * @throws \Drupal\Component\Plugin\Exception\InvalidPluginDefinitionException
   * @throws \Drupal\Component\Plugin\Exception\PluginNotFoundException
   */
  protected function loadByUuid(string $entity_type, string $uuid) {
    return current($this->entityTypeManager
      ->getStorage($entity_type)
      ->loadByProperties([
      'uuid' => $uuid,
    ]));
  }

}

Members

Namesort descending Modifiers Type Description Overrides
AssertContentTrait::$content protected property The current raw content.
AssertContentTrait::$drupalSettings protected property The drupalSettings value from the current raw $content.
AssertContentTrait::$elements protected property The XML structure parsed from the current raw $content. 1
AssertContentTrait::$plainTextContent protected property The plain-text content of raw $content (text nodes).
AssertContentTrait::assertEscaped protected function Passes if the raw text IS found escaped on the loaded page, fail otherwise.
AssertContentTrait::assertField protected function Asserts that a field exists with the given name or ID.
AssertContentTrait::assertFieldById protected function Asserts that a field exists with the given ID and value.
AssertContentTrait::assertFieldByName protected function Asserts that a field exists with the given name and value.
AssertContentTrait::assertFieldByXPath protected function Asserts that a field exists in the current page by the given XPath.
AssertContentTrait::assertFieldChecked protected function Asserts that a checkbox field in the current page is checked.
AssertContentTrait::assertFieldsByValue protected function Asserts that a field exists in the current page with a given Xpath result.
AssertContentTrait::assertLink protected function Passes if a link with the specified label is found.
AssertContentTrait::assertLinkByHref protected function Passes if a link containing a given href (part) is found.
AssertContentTrait::assertNoDuplicateIds protected function Asserts that each HTML ID is used for just a single element.
AssertContentTrait::assertNoEscaped protected function Passes if the raw text IS NOT found escaped on the loaded page, fail otherwise.
AssertContentTrait::assertNoField protected function Asserts that a field does not exist with the given name or ID.
AssertContentTrait::assertNoFieldById protected function Asserts that a field does not exist with the given ID and value.
AssertContentTrait::assertNoFieldByName protected function Asserts that a field does not exist with the given name and value.
AssertContentTrait::assertNoFieldByXPath protected function Asserts that a field does not exist or its value does not match, by XPath.
AssertContentTrait::assertNoFieldChecked protected function Asserts that a checkbox field in the current page is not checked.
AssertContentTrait::assertNoLink protected function Passes if a link with the specified label is not found.
AssertContentTrait::assertNoLinkByHref protected function Passes if a link containing a given href (part) is not found.
AssertContentTrait::assertNoLinkByHrefInMainRegion protected function Passes if a link containing a given href is not found in the main region.
AssertContentTrait::assertNoOption protected function Asserts that a select option in the current page does not exist.
AssertContentTrait::assertNoOptionSelected protected function Asserts that a select option in the current page is not checked.
AssertContentTrait::assertNoPattern protected function Triggers a pass if the perl regex pattern is not found in raw content.
AssertContentTrait::assertNoRaw protected function Passes if the raw text is NOT found on the loaded page, fail otherwise.
AssertContentTrait::assertNoText protected function Passes if the page (with HTML stripped) does not contains the text.
AssertContentTrait::assertNoTitle protected function Pass if the page title is not the given string.
AssertContentTrait::assertNoUniqueText protected function Passes if the text is found MORE THAN ONCE on the text version of the page.
AssertContentTrait::assertOption protected function Asserts that a select option in the current page exists.
AssertContentTrait::assertOptionByText protected function Asserts that a select option with the visible text exists.
AssertContentTrait::assertOptionSelected protected function Asserts that a select option in the current page is checked.
AssertContentTrait::assertOptionSelectedWithDrupalSelector protected function Asserts that a select option in the current page is checked.
AssertContentTrait::assertOptionWithDrupalSelector protected function Asserts that a select option in the current page exists.
AssertContentTrait::assertPattern protected function Triggers a pass if the Perl regex pattern is found in the raw content.
AssertContentTrait::assertRaw protected function Passes if the raw text IS found on the loaded page, fail otherwise.
AssertContentTrait::assertText protected function Passes if the page (with HTML stripped) contains the text.
AssertContentTrait::assertTextHelper protected function Helper for assertText and assertNoText.
AssertContentTrait::assertTextPattern protected function Asserts that a Perl regex pattern is found in the plain-text content.
AssertContentTrait::assertThemeOutput protected function Asserts themed output.
AssertContentTrait::assertTitle protected function Pass if the page title is the given string.
AssertContentTrait::assertUniqueText protected function Passes if the text is found ONLY ONCE on the text version of the page.
AssertContentTrait::assertUniqueTextHelper protected function Helper for assertUniqueText and assertNoUniqueText.
AssertContentTrait::buildXPathQuery protected function Builds an XPath query.
AssertContentTrait::constructFieldXpath protected function Helper: Constructs an XPath for the given set of attributes and value.
AssertContentTrait::cssSelect protected function Searches elements using a CSS selector in the raw content.
AssertContentTrait::getAllOptions protected function Get all option elements, including nested options, in a select.
AssertContentTrait::getDrupalSettings protected function Gets the value of drupalSettings for the currently-loaded page.
AssertContentTrait::getRawContent protected function Gets the current raw content.
AssertContentTrait::getSelectedItem protected function Get the selected value from a select field.
AssertContentTrait::getTextContent protected function Retrieves the plain-text content from the current raw content.
AssertContentTrait::getUrl protected function Get the current URL from the cURL handler. 1
AssertContentTrait::parse protected function Parse content returned from curlExec using DOM and SimpleXML.
AssertContentTrait::removeWhiteSpace protected function Removes all white-space between HTML tags from the raw content.
AssertContentTrait::setDrupalSettings protected function Sets the value of drupalSettings for the currently-loaded page.
AssertContentTrait::setRawContent protected function Sets the raw content (e.g. HTML).
AssertContentTrait::xpath protected function Performs an xpath search on the contents of the internal browser.
AssertHelperTrait::castSafeStrings protected static function Casts MarkupInterface objects into strings.
AssertLegacyTrait::assert protected function Deprecated Scheduled for removal in Drupal 10.0.0. Use self::assertTrue() instead.
AssertLegacyTrait::assertEqual protected function Deprecated Scheduled for removal in Drupal 10.0.0. Use self::assertEquals() instead.
AssertLegacyTrait::assertIdentical protected function Deprecated Scheduled for removal in Drupal 10.0.0. Use self::assertSame() instead.
AssertLegacyTrait::assertIdenticalObject protected function Deprecated Scheduled for removal in Drupal 10.0.0. Use self::assertEquals() instead.
AssertLegacyTrait::assertNotEqual protected function Deprecated Scheduled for removal in Drupal 10.0.0. Use self::assertNotEquals() instead.
AssertLegacyTrait::assertNotIdentical protected function Deprecated Scheduled for removal in Drupal 10.0.0. Use self::assertNotSame() instead.
AssertLegacyTrait::pass protected function Deprecated Scheduled for removal in Drupal 10.0.0. Use self::assertTrue() instead.
AssertLegacyTrait::verbose protected function
ConfigTestTrait::configImporter protected function Returns a ConfigImporter object to import test configuration.
ConfigTestTrait::copyConfig protected function Copies configuration objects from source storage to target storage.
DeprecatedServicePropertyTrait::__get public function Allows to access deprecated/removed properties.
DrupalVersion::getDrupalVersion protected function Get the current version of Drupal to identify fixtures for tests.
EntityKernelTestBase::$deprecatedProperties protected property The list of deprecated services.
EntityKernelTestBase::$entityTypeManager protected property The entity type manager service. 1
EntityKernelTestBase::$generatedIds protected property A list of generated identifiers.
EntityKernelTestBase::$state protected property The state service.
EntityKernelTestBase::createUser protected function Creates a user.
EntityKernelTestBase::generateRandomEntityId protected function Generates a random ID avoiding collisions.
EntityKernelTestBase::getHooksInfo protected function Returns the entity_test hook invocation info.
EntityKernelTestBase::installModule protected function Installs a module and refreshes services.
EntityKernelTestBase::refreshServices protected function Refresh services. 1
EntityKernelTestBase::reloadEntity protected function Reloads the given entity from the storage and returns it.
EntityKernelTestBase::uninstallModule protected function Uninstalls a module and refreshes services.
ImportExportTestBase::$fixtures protected property Fixtures for the test. 18
ImportExportTestBase::$modules public static property Modules to enable. Overrides EntityKernelTestBase::$modules 18
ImportExportTestBase::$normalizeList public static property List of properties to be ignored on export tests.
ImportExportTestBase::assertExportedConfigEntities protected function Executes assertions on a set of exported configuration entities.
ImportExportTestBase::assertImportedConfigEntity protected function Executes assertions on an imported configuration entity.
ImportExportTestBase::cleanLineEndings protected function Standardize OS line endings for the sake of comparison.
ImportExportTestBase::configEntityImportExport public function Executes the set of import/export tests on a configuration entity.
ImportExportTestBase::contentEntityImportExport public function Import and export content.
ImportExportTestBase::createCdfDocumentFromFixture protected function Creates CDF document from fixture.
ImportExportTestBase::decodeDataByObjectType protected function Decodes a data depending on object type.
ImportExportTestBase::ENTITY_REFERENCE_IMAGE_TYPE constant
ImportExportTestBase::ENTITY_REFERENCE_TYPES constant
ImportExportTestBase::getCalculator protected function Get the dependency calculator.
ImportExportTestBase::getEntity protected function Returns Entity object.
ImportExportTestBase::getFixtureExpectations protected function Returns fixture expectations.
ImportExportTestBase::getFixtureString protected function Returns fixture content.
ImportExportTestBase::getSerializer protected function Get the CDF serializer.
ImportExportTestBase::handleFieldValues protected function Handle custom field types to more accurately match expectations.
ImportExportTestBase::importFixture protected function Import fixture.
ImportExportTestBase::loadByUuid protected function Loads an entity of a given type by UUID.
ImportExportTestBase::normalizeFixtureAndObject protected function Normalize fixture and expected object.
ImportExportTestBase::populateCdfObject protected function Populates CDF object from array.
ImportExportTestBase::setUp protected function Overrides EntityKernelTestBase::setUp 18
KernelTestBase::$backupGlobals protected property Back up and restore any global variables that may be changed by tests.
KernelTestBase::$backupStaticAttributes protected property Back up and restore static class properties that may be changed by tests.
KernelTestBase::$backupStaticAttributesBlacklist protected property Contains a few static class properties for performance.
KernelTestBase::$classLoader protected property
KernelTestBase::$configImporter protected property @todo Move into Config test base class. 7
KernelTestBase::$configSchemaCheckerExclusions protected static property An array of config object names that are excluded from schema checking.
KernelTestBase::$container protected property
KernelTestBase::$databasePrefix protected property
KernelTestBase::$preserveGlobalState protected property Do not forward any global state from the parent process to the processes that run the actual tests.
KernelTestBase::$root protected property The app root.
KernelTestBase::$runTestInSeparateProcess protected property Kernel tests are run in separate processes because they allow autoloading of code from extensions. Running the test in a separate process isolates this behavior from other tests. Subclasses should not override this property.
KernelTestBase::$siteDirectory protected property
KernelTestBase::$strictConfigSchema protected property Set to TRUE to strict check all configuration saved. 6
KernelTestBase::$vfsRoot protected property The virtual filesystem root directory.
KernelTestBase::assertPostConditions protected function 1
KernelTestBase::bootEnvironment protected function Bootstraps a basic test environment.
KernelTestBase::bootKernel private function Bootstraps a kernel for a test.
KernelTestBase::config protected function Configuration accessor for tests. Returns non-overridden configuration.
KernelTestBase::disableModules protected function Disables modules for this test.
KernelTestBase::enableModules protected function Enables modules for this test.
KernelTestBase::getConfigSchemaExclusions protected function Gets the config schema exclusions for this test.
KernelTestBase::getDatabaseConnectionInfo protected function Returns the Database connection info to be used for this test. 1
KernelTestBase::getDatabasePrefix public function
KernelTestBase::getExtensionsForModules private function Returns Extension objects for $modules to enable.
KernelTestBase::getModulesToEnable private static function Returns the modules to enable for this test.
KernelTestBase::initFileCache protected function Initializes the FileCache component.
KernelTestBase::installConfig protected function Installs default configuration for a given list of modules.
KernelTestBase::installEntitySchema protected function Installs the storage schema for a specific entity type.
KernelTestBase::installSchema protected function Installs database tables from a module schema definition.
KernelTestBase::isTestInIsolation Deprecated protected function Returns whether the current test method is running in a separate process.
KernelTestBase::prepareTemplate protected function
KernelTestBase::register public function Registers test-specific services. Overrides ServiceProviderInterface::register 26
KernelTestBase::render protected function Renders a render array. 1
KernelTestBase::setInstallProfile protected function Sets the install profile and rebuilds the container to update it.
KernelTestBase::setSetting protected function Sets an in-memory Settings variable.
KernelTestBase::setUpBeforeClass public static function 1
KernelTestBase::setUpFilesystem protected function Sets up the filesystem, so things like the file directory. 2
KernelTestBase::stop protected function Stops test execution.
KernelTestBase::tearDown protected function 6
KernelTestBase::tearDownCloseDatabaseConnection public function @after
KernelTestBase::vfsDump protected function Dumps the current state of the virtual filesystem to STDOUT.
KernelTestBase::__sleep public function Prevents serializing any properties.
PhpunitCompatibilityTrait::getMock Deprecated public function Returns a mock object for the specified class using the available method.
PhpunitCompatibilityTrait::setExpectedException Deprecated public function Compatibility layer for PHPUnit 6 to support PHPUnit 4 code.
RandomGeneratorTrait::$randomGenerator protected property The random generator.
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. 1
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 public function Callback for random string validation.
StorageCopyTrait::replaceStorageContents protected static function Copy the configuration from one storage to another and remove stale items.
TestRequirementsTrait::checkModuleRequirements private function Checks missing module requirements.
TestRequirementsTrait::checkRequirements protected function Check module requirements for the Drupal use case. 1
TestRequirementsTrait::getDrupalRoot protected static function Returns the Drupal root directory.
UserCreationTrait::checkPermissions protected function Checks whether a given list of permission names is valid. Aliased as: drupalCheckPermissions
UserCreationTrait::createAdminRole protected function Creates an administrative role. Aliased as: drupalCreateAdminRole
UserCreationTrait::createRole protected function Creates a role with specified permissions. Aliased as: drupalCreateRole
UserCreationTrait::createUser protected function Create a user with a given set of permissions. Aliased as: drupalCreateUser
UserCreationTrait::grantPermissions protected function Grant permissions to a user role. Aliased as: drupalGrantPermissions
UserCreationTrait::setCurrentUser protected function Switch the current logged in user. Aliased as: drupalSetCurrentUser
UserCreationTrait::setUpCurrentUser protected function Creates a random user account and sets it as current user. Aliased as: drupalSetUpCurrentUser