You are here

Home » API reference » Zircon Profile 8 » EntityTranslationTest.php

class EntityTranslationTest in Zircon Profile 8

Same name and namespace in other branches
  1. 8.0 core/modules/system/src/Tests/Entity/EntityTranslationTest.php \Drupal\system\Tests\Entity\EntityTranslationTest

Tests entity translation functionality.

@group Entity

Hierarchy

Expanded class hierarchy of EntityTranslationTest

File

core/modules/system/src/Tests/Entity/EntityTranslationTest.php, line 20
Contains \Drupal\system\Tests\Entity\EntityTranslationTest.

Namespace

Drupal\system\Tests\Entity
View source 
class EntityTranslationTest extends EntityLanguageTestBase {

  /**
   * Tests language related methods of the Entity class.
   */
  public function testEntityLanguageMethods() {

    // All entity variations have to have the same results.
    foreach (entity_test_entity_types() as $entity_type) {
      $this
        ->doTestEntityLanguageMethods($entity_type);
    }
  }

  /**
   * Executes the entity language method tests for the given entity type.
   *
   * @param string $entity_type
   *   The entity type to run the tests with.
   */
  protected function doTestEntityLanguageMethods($entity_type) {
    $langcode_key = $this->entityManager
      ->getDefinition($entity_type)
      ->getKey('langcode');
    $entity = entity_create($entity_type, array(
      'name' => 'test',
      'user_id' => $this->container
        ->get('current_user')
        ->id(),
    ));
    $this
      ->assertEqual($entity
      ->language()
      ->getId(), $this->languageManager
      ->getDefaultLanguage()
      ->getId(), format_string('%entity_type: Entity created with API has default language.', array(
      '%entity_type' => $entity_type,
    )));
    $entity = entity_create($entity_type, array(
      'name' => 'test',
      'user_id' => \Drupal::currentUser()
        ->id(),
      $langcode_key => LanguageInterface::LANGCODE_NOT_SPECIFIED,
    ));
    $this
      ->assertEqual($entity
      ->language()
      ->getId(), LanguageInterface::LANGCODE_NOT_SPECIFIED, format_string('%entity_type: Entity language not specified.', array(
      '%entity_type' => $entity_type,
    )));
    $this
      ->assertFalse($entity
      ->getTranslationLanguages(FALSE), format_string('%entity_type: No translations are available', array(
      '%entity_type' => $entity_type,
    )));

    // Set the value in default language.
    $entity
      ->set($this->fieldName, array(
      0 => array(
        'value' => 'default value',
      ),
    ));

    // Get the value.
    $field = $entity
      ->getTranslation(LanguageInterface::LANGCODE_DEFAULT)
      ->get($this->fieldName);
    $this
      ->assertEqual($field->value, 'default value', format_string('%entity_type: Untranslated value retrieved.', array(
      '%entity_type' => $entity_type,
    )));
    $this
      ->assertEqual($field
      ->getLangcode(), LanguageInterface::LANGCODE_NOT_SPECIFIED, format_string('%entity_type: Field object has the expected langcode.', array(
      '%entity_type' => $entity_type,
    )));

    // Try to get add a translation to language neutral entity.
    $message = 'Adding a translation to a language-neutral entity results in an error.';
    try {
      $entity
        ->addTranslation($this->langcodes[1]);
      $this
        ->fail($message);
    } catch (\InvalidArgumentException $e) {
      $this
        ->pass($message);
    }

    // Now, make the entity language-specific by assigning a language and test
    // translating it.
    $default_langcode = $this->langcodes[0];
    $entity->{$langcode_key}->value = $default_langcode;
    $entity->{$this->fieldName} = array();
    $this
      ->assertEqual($entity
      ->language(), \Drupal::languageManager()
      ->getLanguage($this->langcodes[0]), format_string('%entity_type: Entity language retrieved.', array(
      '%entity_type' => $entity_type,
    )));
    $this
      ->assertFalse($entity
      ->getTranslationLanguages(FALSE), format_string('%entity_type: No translations are available', array(
      '%entity_type' => $entity_type,
    )));

    // Set the value in default language.
    $entity
      ->set($this->fieldName, array(
      0 => array(
        'value' => 'default value',
      ),
    ));

    // Get the value.
    $field = $entity
      ->get($this->fieldName);
    $this
      ->assertEqual($field->value, 'default value', format_string('%entity_type: Untranslated value retrieved.', array(
      '%entity_type' => $entity_type,
    )));
    $this
      ->assertEqual($field
      ->getLangcode(), $default_langcode, format_string('%entity_type: Field object has the expected langcode.', array(
      '%entity_type' => $entity_type,
    )));

    // Set a translation.
    $entity
      ->addTranslation($this->langcodes[1])
      ->set($this->fieldName, array(
      0 => array(
        'value' => 'translation 1',
      ),
    ));
    $field = $entity
      ->getTranslation($this->langcodes[1])->{$this->fieldName};
    $this
      ->assertEqual($field->value, 'translation 1', format_string('%entity_type: Translated value set.', array(
      '%entity_type' => $entity_type,
    )));
    $this
      ->assertEqual($field
      ->getLangcode(), $this->langcodes[1], format_string('%entity_type: Field object has the expected langcode.', array(
      '%entity_type' => $entity_type,
    )));

    // Make sure the untranslated value stays.
    $field = $entity
      ->get($this->fieldName);
    $this
      ->assertEqual($field->value, 'default value', 'Untranslated value stays.');
    $this
      ->assertEqual($field
      ->getLangcode(), $default_langcode, 'Untranslated value has the expected langcode.');
    $translations[$this->langcodes[1]] = \Drupal::languageManager()
      ->getLanguage($this->langcodes[1]);
    $this
      ->assertEqual($entity
      ->getTranslationLanguages(FALSE), $translations, 'Translations retrieved.');

    // Try to get a value using a language code for a non-existing translation.
    $message = 'Getting a non existing translation results in an error.';
    try {
      $entity
        ->getTranslation($this->langcodes[2])
        ->get($this->fieldName)->value;
      $this
        ->fail($message);
    } catch (\InvalidArgumentException $e) {
      $this
        ->pass($message);
    }

    // Try to get a not available translation.
    $this
      ->assertNull($entity
      ->addTranslation($this->langcodes[2])
      ->get($this->fieldName)->value, format_string('%entity_type: A translation that is not available is NULL.', array(
      '%entity_type' => $entity_type,
    )));

    // Try to get a value using an invalid language code.
    $message = 'Getting an invalid translation results in an error.';
    try {
      $entity
        ->getTranslation('invalid')
        ->get($this->fieldName)->value;
      $this
        ->fail($message);
    } catch (\InvalidArgumentException $e) {
      $this
        ->pass($message);
    }

    // Try to set a value using an invalid language code.
    try {
      $entity
        ->getTranslation('invalid')
        ->set($this->fieldName, NULL);
      $this
        ->fail(format_string('%entity_type: Setting a translation for an invalid language throws an exception.', array(
        '%entity_type' => $entity_type,
      )));
    } catch (\InvalidArgumentException $e) {
      $this
        ->pass(format_string('%entity_type: Setting a translation for an invalid language throws an exception.', array(
        '%entity_type' => $entity_type,
      )));
    }

    // Set the value in default language.
    $field_name = 'field_test_text';
    $entity
      ->getTranslation($this->langcodes[1])
      ->set($field_name, array(
      0 => array(
        'value' => 'default value2',
      ),
    ));

    // Get the value.
    $field = $entity
      ->get($field_name);
    $this
      ->assertEqual($field->value, 'default value2', format_string('%entity_type: Untranslated value set into a translation in non-strict mode.', array(
      '%entity_type' => $entity_type,
    )));
    $this
      ->assertEqual($field
      ->getLangcode(), $default_langcode, format_string('%entity_type: Field object has the expected langcode.', array(
      '%entity_type' => $entity_type,
    )));
  }

  /**
   * Tests multilingual properties.
   */
  public function testMultilingualProperties() {

    // Test all entity variations with data table support.
    foreach (entity_test_entity_types(ENTITY_TEST_TYPES_MULTILINGUAL) as $entity_type) {
      $this
        ->doTestMultilingualProperties($entity_type);
    }
  }

  /**
   * Executes the multilingual property tests for the given entity type.
   *
   * @param string $entity_type
   *   The entity type to run the tests with.
   */
  protected function doTestMultilingualProperties($entity_type) {
    $langcode_key = $this->entityManager
      ->getDefinition($entity_type)
      ->getKey('langcode');
    $default_langcode_key = $this->entityManager
      ->getDefinition($entity_type)
      ->getKey('default_langcode');
    $name = $this
      ->randomMachineName();
    $uid = mt_rand(0, 127);
    $langcode = $this->langcodes[0];

    // Create a language neutral entity and check that properties are stored
    // as language neutral.
    $entity = entity_create($entity_type, array(
      'name' => $name,
      'user_id' => $uid,
      $langcode_key => LanguageInterface::LANGCODE_NOT_SPECIFIED,
    ));
    $entity
      ->save();
    $entity = entity_load($entity_type, $entity
      ->id());
    $default_langcode = $entity
      ->language()
      ->getId();
    $this
      ->assertEqual($default_langcode, LanguageInterface::LANGCODE_NOT_SPECIFIED, format_string('%entity_type: Entity created as language neutral.', array(
      '%entity_type' => $entity_type,
    )));
    $field = $entity
      ->getTranslation(LanguageInterface::LANGCODE_DEFAULT)
      ->get('name');
    $this
      ->assertEqual($name, $field->value, format_string('%entity_type: The entity name has been correctly stored as language neutral.', array(
      '%entity_type' => $entity_type,
    )));
    $this
      ->assertEqual($default_langcode, $field
      ->getLangcode(), format_string('%entity_type: The field object has the expect langcode.', array(
      '%entity_type' => $entity_type,
    )));
    $this
      ->assertEqual($uid, $entity
      ->getTranslation(LanguageInterface::LANGCODE_DEFAULT)
      ->get('user_id')->target_id, format_string('%entity_type: The entity author has been correctly stored as language neutral.', array(
      '%entity_type' => $entity_type,
    )));
    $translation = $entity
      ->getTranslation(LanguageInterface::LANGCODE_DEFAULT);
    $field = $translation
      ->get('name');
    $this
      ->assertEqual($name, $field->value, format_string('%entity_type: The entity name defaults to neutral language.', array(
      '%entity_type' => $entity_type,
    )));
    $this
      ->assertEqual($default_langcode, $field
      ->getLangcode(), format_string('%entity_type: The field object has the expect langcode.', array(
      '%entity_type' => $entity_type,
    )));
    $this
      ->assertEqual($uid, $translation
      ->get('user_id')->target_id, format_string('%entity_type: The entity author defaults to neutral language.', array(
      '%entity_type' => $entity_type,
    )));
    $field = $entity
      ->get('name');
    $this
      ->assertEqual($name, $field->value, format_string('%entity_type: The entity name can be retrieved without specifying a language.', array(
      '%entity_type' => $entity_type,
    )));
    $this
      ->assertEqual($default_langcode, $field
      ->getLangcode(), format_string('%entity_type: The field object has the expect langcode.', array(
      '%entity_type' => $entity_type,
    )));
    $this
      ->assertEqual($uid, $entity
      ->get('user_id')->target_id, format_string('%entity_type: The entity author can be retrieved without specifying a language.', array(
      '%entity_type' => $entity_type,
    )));

    // Create a language-aware entity and check that properties are stored
    // as language-aware.
    $entity = entity_create($entity_type, array(
      'name' => $name,
      'user_id' => $uid,
      $langcode_key => $langcode,
    ));
    $entity
      ->save();
    $entity = entity_load($entity_type, $entity
      ->id());
    $default_langcode = $entity
      ->language()
      ->getId();
    $this
      ->assertEqual($default_langcode, $langcode, format_string('%entity_type: Entity created as language specific.', array(
      '%entity_type' => $entity_type,
    )));
    $field = $entity
      ->getTranslation($langcode)
      ->get('name');
    $this
      ->assertEqual($name, $field->value, format_string('%entity_type: The entity name has been correctly stored as a language-aware property.', array(
      '%entity_type' => $entity_type,
    )));
    $this
      ->assertEqual($default_langcode, $field
      ->getLangcode(), format_string('%entity_type: The field object has the expect langcode.', array(
      '%entity_type' => $entity_type,
    )));
    $this
      ->assertEqual($uid, $entity
      ->getTranslation($langcode)
      ->get('user_id')->target_id, format_string('%entity_type: The entity author has been correctly stored as a language-aware property.', array(
      '%entity_type' => $entity_type,
    )));

    // Create property translations.
    $properties = array();
    $default_langcode = $langcode;
    foreach ($this->langcodes as $langcode) {
      if ($langcode != $default_langcode) {
        $properties[$langcode] = array(
          'name' => array(
            0 => $this
              ->randomMachineName(),
          ),
          'user_id' => array(
            0 => mt_rand(128, 256),
          ),
        );
      }
      else {
        $properties[$langcode] = array(
          'name' => array(
            0 => $name,
          ),
          'user_id' => array(
            0 => $uid,
          ),
        );
      }
      $translation = $entity
        ->hasTranslation($langcode) ? $entity
        ->getTranslation($langcode) : $entity
        ->addTranslation($langcode);
      foreach ($properties[$langcode] as $field_name => $values) {
        $translation
          ->set($field_name, $values);
      }
    }
    $entity
      ->save();

    // Check that property translation were correctly stored.
    $entity = entity_load($entity_type, $entity
      ->id());
    foreach ($this->langcodes as $langcode) {
      $args = array(
        '%entity_type' => $entity_type,
        '%langcode' => $langcode,
      );
      $field = $entity
        ->getTranslation($langcode)
        ->get('name');
      $this
        ->assertEqual($properties[$langcode]['name'][0], $field->value, format_string('%entity_type: The entity name has been correctly stored for language %langcode.', $args));
      $field_langcode = $langcode == $entity
        ->language()
        ->getId() ? $default_langcode : $langcode;
      $this
        ->assertEqual($field_langcode, $field
        ->getLangcode(), format_string('%entity_type: The field object has the expected langcode  %langcode.', $args));
      $this
        ->assertEqual($properties[$langcode]['user_id'][0], $entity
        ->getTranslation($langcode)
        ->get('user_id')->target_id, format_string('%entity_type: The entity author has been correctly stored for language %langcode.', $args));
    }

    // Test query conditions (cache is reset at each call).
    $translated_id = $entity
      ->id();

    // Create an additional entity with only the uid set. The uid for the
    // original language is the same of one used for a translation.
    $langcode = $this->langcodes[1];
    entity_create($entity_type, array(
      'user_id' => $properties[$langcode]['user_id'],
      'name' => 'some name',
      $langcode_key => LanguageInterface::LANGCODE_NOT_SPECIFIED,
    ))
      ->save();
    $entities = entity_load_multiple($entity_type);
    $this
      ->assertEqual(count($entities), 3, format_string('%entity_type: Three entities were created.', array(
      '%entity_type' => $entity_type,
    )));
    $entities = entity_load_multiple($entity_type, array(
      $translated_id,
    ));
    $this
      ->assertEqual(count($entities), 1, format_string('%entity_type: One entity correctly loaded by id.', array(
      '%entity_type' => $entity_type,
    )));
    $entities = entity_load_multiple_by_properties($entity_type, array(
      'name' => $name,
    ));
    $this
      ->assertEqual(count($entities), 2, format_string('%entity_type: Two entities correctly loaded by name.', array(
      '%entity_type' => $entity_type,
    )));

    // @todo The default language condition should go away in favor of an
    // explicit parameter.
    $entities = entity_load_multiple_by_properties($entity_type, array(
      'name' => $properties[$langcode]['name'][0],
      $default_langcode_key => 0,
    ));
    $this
      ->assertEqual(count($entities), 1, format_string('%entity_type: One entity correctly loaded by name translation.', array(
      '%entity_type' => $entity_type,
    )));
    $entities = entity_load_multiple_by_properties($entity_type, array(
      $langcode_key => $default_langcode,
      'name' => $name,
    ));
    $this
      ->assertEqual(count($entities), 1, format_string('%entity_type: One entity correctly loaded by name and language.', array(
      '%entity_type' => $entity_type,
    )));
    $entities = entity_load_multiple_by_properties($entity_type, array(
      $langcode_key => $langcode,
      'name' => $properties[$langcode]['name'][0],
    ));
    $this
      ->assertEqual(count($entities), 0, format_string('%entity_type: No entity loaded by name translation specifying the translation language.', array(
      '%entity_type' => $entity_type,
    )));
    $entities = entity_load_multiple_by_properties($entity_type, array(
      $langcode_key => $langcode,
      'name' => $properties[$langcode]['name'][0],
      $default_langcode_key => 0,
    ));
    $this
      ->assertEqual(count($entities), 1, format_string('%entity_type: One entity loaded by name translation and language specifying to look for translations.', array(
      '%entity_type' => $entity_type,
    )));
    $entities = entity_load_multiple_by_properties($entity_type, array(
      'user_id' => $properties[$langcode]['user_id'][0],
      $default_langcode_key => NULL,
    ));
    $this
      ->assertEqual(count($entities), 2, format_string('%entity_type: Two entities loaded by uid without caring about property translatability.', array(
      '%entity_type' => $entity_type,
    )));

    // Test property conditions and orders with multiple languages in the same
    // query.
    $query = \Drupal::entityQuery($entity_type);
    $group = $query
      ->andConditionGroup()
      ->condition('user_id', $properties[$default_langcode]['user_id'][0], '=', $default_langcode)
      ->condition('name', $properties[$default_langcode]['name'][0], '=', $default_langcode);
    $result = $query
      ->condition($group)
      ->condition('name', $properties[$langcode]['name'][0], '=', $langcode)
      ->execute();
    $this
      ->assertEqual(count($result), 1, format_string('%entity_type: One entity loaded by name and uid using different language meta conditions.', array(
      '%entity_type' => $entity_type,
    )));

    // Test mixed property and field conditions.
    $entity = entity_load($entity_type, reset($result), TRUE);
    $field_value = $this
      ->randomString();
    $entity
      ->getTranslation($langcode)
      ->set($this->fieldName, array(
      array(
        'value' => $field_value,
      ),
    ));
    $entity
      ->save();
    $query = \Drupal::entityQuery($entity_type);
    $default_langcode_group = $query
      ->andConditionGroup()
      ->condition('user_id', $properties[$default_langcode]['user_id'][0], '=', $default_langcode)
      ->condition('name', $properties[$default_langcode]['name'][0], '=', $default_langcode);
    $langcode_group = $query
      ->andConditionGroup()
      ->condition('name', $properties[$langcode]['name'][0], '=', $langcode)
      ->condition("{$this->fieldName}.value", $field_value, '=', $langcode);
    $result = $query
      ->condition($langcode_key, $default_langcode)
      ->condition($default_langcode_group)
      ->condition($langcode_group)
      ->execute();
    $this
      ->assertEqual(count($result), 1, format_string('%entity_type: One entity loaded by name, uid and field value using different language meta conditions.', array(
      '%entity_type' => $entity_type,
    )));
  }

  /**
   * Tests the Entity Translation API behavior.
   */
  function testEntityTranslationAPI() {

    // Test all entity variations with data table support.
    foreach (entity_test_entity_types(ENTITY_TEST_TYPES_MULTILINGUAL) as $entity_type) {
      $this
        ->doTestEntityTranslationAPI($entity_type);
    }
  }

  /**
   * Executes the Entity Translation API tests for the given entity type.
   *
   * @param string $entity_type
   *   The entity type to run the tests with.
   */
  protected function doTestEntityTranslationAPI($entity_type) {
    $default_langcode = $this->langcodes[0];
    $langcode = $this->langcodes[1];
    $langcode_key = $this->entityManager
      ->getDefinition($entity_type)
      ->getKey('langcode');
    $default_langcode_key = $this->entityManager
      ->getDefinition($entity_type)
      ->getKey('default_langcode');

    /** @var \Drupal\Core\Entity\ContentEntityInterface $entity */
    $entity = $this->entityManager
      ->getStorage($entity_type)
      ->create(array(
      'name' => $this
        ->randomMachineName(),
      $langcode_key => LanguageInterface::LANGCODE_NOT_SPECIFIED,
    ));
    $entity
      ->save();
    $hooks = $this
      ->getHooksInfo();
    $this
      ->assertFalse($hooks, 'No entity translation hooks are fired when creating an entity.');

    // Verify that we obtain the entity object itself when we attempt to
    // retrieve a translation referring to it.
    $translation = $entity
      ->getTranslation(LanguageInterface::LANGCODE_NOT_SPECIFIED);
    $this
      ->assertFalse($translation
      ->isNewTranslation(), 'Existing translations are not marked as new.');
    $this
      ->assertIdentical($entity, $translation, 'The translation object corresponding to a non-default language is the entity object itself when the entity is language-neutral.');
    $entity->{$langcode_key}->value = $default_langcode;
    $translation = $entity
      ->getTranslation($default_langcode);
    $this
      ->assertIdentical($entity, $translation, 'The translation object corresponding to the default language (explicit) is the entity object itself.');
    $translation = $entity
      ->getTranslation(LanguageInterface::LANGCODE_DEFAULT);
    $this
      ->assertIdentical($entity, $translation, 'The translation object corresponding to the default language (implicit) is the entity object itself.');
    $this
      ->assertTrue($entity->{$default_langcode_key}->value, 'The translation object is the default one.');

    // Verify that trying to retrieve a translation for a locked language when
    // the entity is language-aware causes an exception to be thrown.
    $message = 'A language-neutral translation cannot be retrieved.';
    try {
      $entity
        ->getTranslation(LanguageInterface::LANGCODE_NOT_SPECIFIED);
      $this
        ->fail($message);
    } catch (\LogicException $e) {
      $this
        ->pass($message);
    }

    // Create a translation and verify that the translation object and the
    // original object behave independently.
    $name = $default_langcode . '_' . $this
      ->randomMachineName();
    $entity->name->value = $name;
    $name_translated = $langcode . '_' . $this
      ->randomMachineName();
    $translation = $entity
      ->addTranslation($langcode);
    $this
      ->assertTrue($translation
      ->isNewTranslation(), 'Newly added translations are marked as new.');
    $this
      ->assertNotIdentical($entity, $translation, 'The entity and the translation object differ from one another.');
    $this
      ->assertTrue($entity
      ->hasTranslation($langcode), 'The new translation exists.');
    $this
      ->assertEqual($translation
      ->language()
      ->getId(), $langcode, 'The translation language matches the specified one.');
    $this
      ->assertEqual($translation->{$langcode_key}->value, $langcode, 'The translation field language value matches the specified one.');
    $this
      ->assertFalse($translation->{$default_langcode_key}->value, 'The translation object is not the default one.');
    $this
      ->assertEqual($translation
      ->getUntranslated()
      ->language()
      ->getId(), $default_langcode, 'The original language can still be retrieved.');
    $translation->name->value = $name_translated;
    $this
      ->assertEqual($entity->name->value, $name, 'The original name is retained after setting a translated value.');
    $entity->name->value = $name;
    $this
      ->assertEqual($translation->name->value, $name_translated, 'The translated name is retained after setting the original value.');

    // Save the translation and check that the expected hooks are fired.
    $translation
      ->save();
    $hooks = $this
      ->getHooksInfo();
    $this
      ->assertEqual($hooks['entity_translation_insert'], $langcode, 'The generic entity translation insertion hook has fired.');
    $this
      ->assertEqual($hooks[$entity_type . '_translation_insert'], $langcode, 'The entity-type-specific entity translation insertion hook has fired.');

    // Verify that changing translation language causes an exception to be
    // thrown.
    $message = 'The translation language cannot be changed.';
    try {
      $translation->{$langcode_key}->value = $this->langcodes[2];
      $this
        ->fail($message);
    } catch (\LogicException $e) {
      $this
        ->pass($message);
    }

    // Verify that reassigning the same translation language is allowed.
    $message = 'The translation language can be reassigned the same value.';
    try {
      $translation->{$langcode_key}->value = $langcode;
      $this
        ->pass($message);
    } catch (\LogicException $e) {
      $this
        ->fail($message);
    }

    // Verify that changing the default translation flag causes an exception to
    // be thrown.
    foreach ($entity
      ->getTranslationLanguages() as $t_langcode => $language) {
      $translation = $entity
        ->getTranslation($t_langcode);
      $default = $translation
        ->isDefaultTranslation();
      $message = 'The default translation flag can be reassigned the same value.';
      try {
        $translation->{$default_langcode_key}->value = $default;
        $this
          ->pass($message);
      } catch (\LogicException $e) {
        $this
          ->fail($message);
      }
      $message = 'The default translation flag cannot be changed.';
      try {
        $translation->{$default_langcode_key}->value = !$default;
        $this
          ->fail($message);
      } catch (\LogicException $e) {
        $this
          ->pass($message);
      }
      $this
        ->assertEqual($translation->{$default_langcode_key}->value, $default);
    }

    // Check that after loading an entity the language is the default one.
    $entity = $this
      ->reloadEntity($entity);
    $this
      ->assertEqual($entity
      ->language()
      ->getId(), $default_langcode, 'The loaded entity is the original one.');

    // Add another translation and check that everything works as expected. A
    // new translation object can be obtained also by just specifying a valid
    // language.
    $langcode2 = $this->langcodes[2];
    $translation = $entity
      ->addTranslation($langcode2);
    $value = $entity !== $translation && $translation
      ->language()
      ->getId() == $langcode2 && $entity
      ->hasTranslation($langcode2);
    $this
      ->assertTrue($value, 'A new translation object can be obtained also by specifying a valid language.');
    $this
      ->assertEqual($entity
      ->language()
      ->getId(), $default_langcode, 'The original language has been preserved.');
    $translation
      ->save();
    $hooks = $this
      ->getHooksInfo();
    $this
      ->assertEqual($hooks['entity_translation_insert'], $langcode2, 'The generic entity translation insertion hook has fired.');
    $this
      ->assertEqual($hooks[$entity_type . '_translation_insert'], $langcode2, 'The entity-type-specific entity translation insertion hook has fired.');

    // Verify that trying to manipulate a translation object referring to a
    // removed translation results in exceptions being thrown.
    $entity = $this
      ->reloadEntity($entity);
    $translation = $entity
      ->getTranslation($langcode2);
    $entity
      ->removeTranslation($langcode2);
    foreach (array(
      'get',
      'set',
      '__get',
      '__set',
      'createDuplicate',
    ) as $method) {
      $message = format_string('The @method method raises an exception when trying to manipulate a removed translation.', array(
        '@method' => $method,
      ));
      try {
        $translation
          ->{$method}('name', $this
          ->randomMachineName());
        $this
          ->fail($message);
      } catch (\Exception $e) {
        $this
          ->pass($message);
      }
    }

    // Verify that deletion hooks are fired when saving an entity with a removed
    // translation.
    $entity
      ->save();
    $hooks = $this
      ->getHooksInfo();
    $this
      ->assertEqual($hooks['entity_translation_delete'], $langcode2, 'The generic entity translation deletion hook has fired.');
    $this
      ->assertEqual($hooks[$entity_type . '_translation_delete'], $langcode2, 'The entity-type-specific entity translation deletion hook has fired.');
    $entity = $this
      ->reloadEntity($entity);
    $this
      ->assertFalse($entity
      ->hasTranslation($langcode2), 'The translation does not appear among available translations after saving the entity.');

    // Check that removing an invalid translation causes an exception to be
    // thrown.
    foreach (array(
      $default_langcode,
      LanguageInterface::LANGCODE_DEFAULT,
      $this
        ->randomMachineName(),
    ) as $invalid_langcode) {
      $message = format_string('Removing an invalid translation (@langcode) causes an exception to be thrown.', array(
        '@langcode' => $invalid_langcode,
      ));
      try {
        $entity
          ->removeTranslation($invalid_langcode);
        $this
          ->fail($message);
      } catch (\Exception $e) {
        $this
          ->pass($message);
      }
    }

    // Check that hooks are fired only when actually storing data.
    $entity = $this
      ->reloadEntity($entity);
    $entity
      ->addTranslation($langcode2);
    $entity
      ->removeTranslation($langcode2);
    $entity
      ->save();
    $hooks = $this
      ->getHooksInfo();
    $this
      ->assertFalse($hooks, 'No hooks are run when adding and removing a translation without storing it.');

    // Check that hooks are fired only when actually storing data.
    $entity = $this
      ->reloadEntity($entity);
    $entity
      ->addTranslation($langcode2);
    $entity
      ->save();
    $entity = $this
      ->reloadEntity($entity);
    $this
      ->assertTrue($entity
      ->hasTranslation($langcode2), 'Entity has translation after adding one and saving.');
    $entity
      ->removeTranslation($langcode2);
    $entity
      ->save();
    $entity = $this
      ->reloadEntity($entity);
    $this
      ->assertFalse($entity
      ->hasTranslation($langcode2), 'Entity does not have translation after removing it and saving.');

    // Reset hook firing information.
    $this
      ->getHooksInfo();

    // Verify that entity serialization does not cause stale references to be
    // left around.
    $entity = $this
      ->reloadEntity($entity);
    $translation = $entity
      ->getTranslation($langcode);
    $entity = unserialize(serialize($entity));
    $entity->name->value = $this
      ->randomMachineName();
    $name = $default_langcode . '_' . $this
      ->randomMachineName();
    $entity
      ->getTranslation($default_langcode)->name->value = $name;
    $this
      ->assertEqual($entity->name->value, $name, 'No stale reference for the translation object corresponding to the original language.');
    $translation2 = $entity
      ->getTranslation($langcode);
    $translation2->name->value .= $this
      ->randomMachineName();
    $this
      ->assertNotEqual($translation->name->value, $translation2->name->value, 'No stale reference for the actual translation object.');
    $this
      ->assertEqual($entity, $translation2
      ->getUntranslated(), 'No stale reference in the actual translation object.');

    // Verify that deep-cloning is still available when we are not instantiating
    // a translation object, which instead relies on shallow cloning.
    $entity = $this
      ->reloadEntity($entity);
    $entity
      ->getTranslation($langcode);
    $cloned = clone $entity;
    $translation = $cloned
      ->getTranslation($langcode);
    $this
      ->assertNotIdentical($entity, $translation
      ->getUntranslated(), 'A cloned entity object has no reference to the original one.');
    $entity
      ->removeTranslation($langcode);
    $this
      ->assertFalse($entity
      ->hasTranslation($langcode));
    $this
      ->assertTrue($cloned
      ->hasTranslation($langcode));

    // Check that untranslatable field references keep working after serializing
    // and cloning the entity.
    $entity = $this
      ->reloadEntity($entity);
    $type = $this
      ->randomMachineName();
    $entity
      ->getTranslation($langcode)->type->value = $type;
    $entity = unserialize(serialize($entity));
    $cloned = clone $entity;
    $translation = $cloned
      ->getTranslation($langcode);
    $translation->type->value = strrev($type);
    $this
      ->assertEqual($cloned->type->value, $translation->type->value, 'Untranslatable field references keep working after serializing and cloning the entity.');

    // Check that per-language defaults are properly populated. The
    // 'entity_test_mul_default_value' entity type is translatable and uses
    // entity_test_field_default_value() as a "default value callback" for its
    // 'description' field.
    $entity = $this->entityManager
      ->getStorage('entity_test_mul_default_value')
      ->create([
      'name' => $this
        ->randomMachineName(),
      'langcode' => $langcode,
    ]);
    $translation = $entity
      ->addTranslation($langcode2);
    $expected = array(
      array(
        'shape' => "shape:0:description_{$langcode2}",
        'color' => "color:0:description_{$langcode2}",
      ),
      array(
        'shape' => "shape:1:description_{$langcode2}",
        'color' => "color:1:description_{$langcode2}",
      ),
    );
    $this
      ->assertEqual($translation->description
      ->getValue(), $expected, 'Language-aware default values correctly populated.');
    $this
      ->assertEqual($translation->description
      ->getLangcode(), $langcode2, 'Field object has the expected langcode.');
  }

  /**
   * Tests language fallback applied to field and entity translations.
   */
  function testLanguageFallback() {

    // Test all entity variations with data table support.
    foreach (entity_test_entity_types(ENTITY_TEST_TYPES_MULTILINGUAL) as $entity_type) {
      $this
        ->doTestLanguageFallback($entity_type);
    }
  }

  /**
   * Executes the language fallback test for the given entity type.
   *
   * @param string $entity_type
   *   The entity type to run the tests with.
   */
  protected function doTestLanguageFallback($entity_type) {

    /** @var \Drupal\Core\Render\RendererInterface $renderer */
    $renderer = $this->container
      ->get('renderer');
    $current_langcode = $this->languageManager
      ->getCurrentLanguage(LanguageInterface::TYPE_CONTENT)
      ->getId();
    $this->langcodes[] = $current_langcode;
    $values = array();
    foreach ($this->langcodes as $langcode) {
      $values[$langcode]['name'] = $this
        ->randomMachineName();
      $values[$langcode]['user_id'] = mt_rand(0, 127);
    }
    $default_langcode = $this->langcodes[0];
    $langcode = $this->langcodes[1];
    $langcode2 = $this->langcodes[2];
    $langcode_key = $this->entityManager
      ->getDefinition($entity_type)
      ->getKey('langcode');
    $languages = $this->languageManager
      ->getLanguages();
    $language = ConfigurableLanguage::load($languages[$langcode]
      ->getId());
    $language
      ->set('weight', 1);
    $language
      ->save();
    $this->languageManager
      ->reset();
    $controller = $this->entityManager
      ->getStorage($entity_type);
    $entity = $controller
      ->create(array(
      $langcode_key => $default_langcode,
    ) + $values[$default_langcode]);
    $entity
      ->save();
    $entity
      ->addTranslation($langcode, $values[$langcode]);
    $entity
      ->save();

    // Check that retrieving the current translation works as expected.
    $entity = $this
      ->reloadEntity($entity);
    $translation = $this->entityManager
      ->getTranslationFromContext($entity, $langcode2);
    $this
      ->assertEqual($translation
      ->language()
      ->getId(), $default_langcode, 'The current translation language matches the expected one.');

    // Check that language fallback respects language weight by default.
    $language = ConfigurableLanguage::load($languages[$langcode]
      ->getId());
    $language
      ->set('weight', -1);
    $language
      ->save();
    $translation = $this->entityManager
      ->getTranslationFromContext($entity, $langcode2);
    $this
      ->assertEqual($translation
      ->language()
      ->getId(), $langcode, 'The current translation language matches the expected one.');

    // Check that the current translation is properly returned.
    $translation = $this->entityManager
      ->getTranslationFromContext($entity);
    $this
      ->assertEqual($langcode, $translation
      ->language()
      ->getId(), 'The current translation language matches the topmost language fallback candidate.');
    $entity
      ->addTranslation($current_langcode, $values[$current_langcode]);
    $translation = $this->entityManager
      ->getTranslationFromContext($entity);
    $this
      ->assertEqual($current_langcode, $translation
      ->language()
      ->getId(), 'The current translation language matches the current language.');

    // Check that if the entity has no translation no fallback is applied.
    $entity2 = $controller
      ->create(array(
      $langcode_key => $default_langcode,
    ));

    // Get an view builder.
    $controller = $this->entityManager
      ->getViewBuilder($entity_type);
    $entity2_build = $controller
      ->view($entity2);
    $entity2_output = (string) $renderer
      ->renderRoot($entity2_build);
    $translation = $this->entityManager
      ->getTranslationFromContext($entity2, $default_langcode);
    $translation_build = $controller
      ->view($translation);
    $translation_output = (string) $renderer
      ->renderRoot($translation_build);
    $this
      ->assertIdentical($entity2_output, $translation_output, 'When the entity has no translation no fallback is applied.');

    // Checks that entity translations are rendered properly.
    $controller = $this->entityManager
      ->getViewBuilder($entity_type);
    $build = $controller
      ->view($entity);
    $renderer
      ->renderRoot($build);
    $this
      ->assertEqual($build['label']['#markup'], $values[$current_langcode]['name'], 'By default the entity is rendered in the current language.');
    $langcodes = array_combine($this->langcodes, $this->langcodes);

    // We have no translation for the $langcode2 language, hence the expected
    // result is the topmost existing translation, that is $langcode.
    $langcodes[$langcode2] = $langcode;
    foreach ($langcodes as $desired => $expected) {
      $build = $controller
        ->view($entity, 'full', $desired);

      // Unset the #cache key so that a fresh render is produced with each pass,
      // making the renderable array keys available to compare.
      unset($build['#cache']);
      $renderer
        ->renderRoot($build);
      $this
        ->assertEqual($build['label']['#markup'], $values[$expected]['name'], 'The entity is rendered in the expected language.');
    }
  }

  /**
   * Check that field translatability is handled properly.
   */
  function testFieldDefinitions() {

    // Check that field translatability can be altered to be enabled or disabled
    // in field definitions.
    $entity_type = 'entity_test_mulrev';
    $this->state
      ->set('entity_test.field_definitions.translatable', array(
      'name' => FALSE,
    ));
    $this->entityManager
      ->clearCachedFieldDefinitions();
    $definitions = $this->entityManager
      ->getBaseFieldDefinitions($entity_type);
    $this
      ->assertFalse($definitions['name']
      ->isTranslatable(), 'Field translatability can be disabled programmatically.');
    $this->state
      ->set('entity_test.field_definitions.translatable', array(
      'name' => TRUE,
    ));
    $this->entityManager
      ->clearCachedFieldDefinitions();
    $definitions = $this->entityManager
      ->getBaseFieldDefinitions($entity_type);
    $this
      ->assertTrue($definitions['name']
      ->isTranslatable(), 'Field translatability can be enabled programmatically.');

    // Check that field translatability is disabled by default.
    $base_field_definitions = EntityTestMulRev::baseFieldDefinitions($this->entityManager
      ->getDefinition($entity_type));
    $this
      ->assertTrue(!isset($base_field_definitions['id']->translatable), 'Translatability for the <em>id</em> field is not defined.');
    $this
      ->assertFalse($definitions['id']
      ->isTranslatable(), 'Field translatability is disabled by default.');

    // Check that entity id keys have the expect translatability.
    $translatable_fields = array(
      'id' => TRUE,
      'uuid' => TRUE,
      'revision_id' => TRUE,
      'type' => TRUE,
      'langcode' => FALSE,
    );
    foreach ($translatable_fields as $name => $translatable) {
      $this->state
        ->set('entity_test.field_definitions.translatable', array(
        $name => $translatable,
      ));
      $this->entityManager
        ->clearCachedFieldDefinitions();
      $message = format_string('Field %field cannot be translatable.', array(
        '%field' => $name,
      ));
      try {
        $this->entityManager
          ->getBaseFieldDefinitions($entity_type);
        $this
          ->fail($message);
      } catch (\LogicException $e) {
        $this
          ->pass($message);
      }
    }
  }

  /**
   * Tests that changing entity language does not break field language.
   */
  public function testLanguageChange() {

    // Test all entity variations with data table support.
    foreach (entity_test_entity_types(ENTITY_TEST_TYPES_MULTILINGUAL) as $entity_type) {
      $this
        ->doTestLanguageChange($entity_type);
    }
  }

  /**
   * Executes the entity language change test for the given entity type.
   *
   * @param string $entity_type
   *   The entity type to run the tests with.
   */
  protected function doTestLanguageChange($entity_type) {
    $langcode_key = $this->entityManager
      ->getDefinition($entity_type)
      ->getKey('langcode');
    $controller = $this->entityManager
      ->getStorage($entity_type);
    $langcode = $this->langcodes[0];

    // check that field languages match entity language regardless of field
    // translatability.
    $values = array(
      $langcode_key => $langcode,
      $this->fieldName => $this
        ->randomMachineName(),
      $this->untranslatableFieldName => $this
        ->randomMachineName(),
    );
    $entity = $controller
      ->create($values);
    foreach (array(
      $this->fieldName,
      $this->untranslatableFieldName,
    ) as $field_name) {
      $this
        ->assertEqual($entity
        ->get($field_name)
        ->getLangcode(), $langcode, 'Field language works as expected.');
    }

    // Check that field languages keep matching entity language even after
    // changing it.
    $langcode = $this->langcodes[1];
    $entity->{$langcode_key}->value = $langcode;
    foreach (array(
      $this->fieldName,
      $this->untranslatableFieldName,
    ) as $field_name) {
      $this
        ->assertEqual($entity
        ->get($field_name)
        ->getLangcode(), $langcode, 'Field language works as expected after changing entity language.');
    }

    // Check that entity translation does not affect the language of original
    // field values and untranslatable ones.
    $langcode = $this->langcodes[0];
    $entity
      ->addTranslation($this->langcodes[2], array(
      $this->fieldName => $this
        ->randomMachineName(),
    ));
    $entity->{$langcode_key}->value = $langcode;
    foreach (array(
      $this->fieldName,
      $this->untranslatableFieldName,
    ) as $field_name) {
      $this
        ->assertEqual($entity
        ->get($field_name)
        ->getLangcode(), $langcode, 'Field language works as expected after translating the entity and changing language.');
    }

    // Check that setting the default language to an existing translation
    // language causes an exception to be thrown.
    $message = 'An exception is thrown when setting the default language to an existing translation language';
    try {
      $entity->{$langcode_key}->value = $this->langcodes[2];
      $this
        ->fail($message);
    } catch (\InvalidArgumentException $e) {
      $this
        ->pass($message);
    }
  }

  /**
   * Tests how entity adapters work with translations.
   */
  function testEntityAdapter() {
    $entity_type = 'entity_test';
    $default_langcode = 'en';
    $values[$default_langcode] = array(
      'name' => $this
        ->randomString(),
    );
    $controller = $this->entityManager
      ->getStorage($entity_type);

    /** @var \Drupal\Core\Entity\ContentEntityInterface $entity */
    $entity = $controller
      ->create($values[$default_langcode]);
    foreach ($this->langcodes as $langcode) {
      $values[$langcode] = array(
        'name' => $this
          ->randomString(),
      );
      $entity
        ->addTranslation($langcode, $values[$langcode]);
    }
    $langcodes = array_merge(array(
      $default_langcode,
    ), $this->langcodes);
    foreach ($langcodes as $langcode) {
      $adapter = $entity
        ->getTranslation($langcode)
        ->getTypedData();
      $name = $adapter
        ->get('name')->value;
      $this
        ->assertEqual($name, $values[$langcode]['name'], SafeMarkup::format('Name correctly retrieved from "@langcode" adapter', array(
        '@langcode' => $langcode,
      )));
    }
  }

  /**
   * Tests if entity references are correct after adding a new translation.
   */
  public function testFieldEntityReference() {
    $entity_type = 'entity_test_mul';
    $controller = $this->entityManager
      ->getStorage($entity_type);

    /** @var \Drupal\Core\Entity\ContentEntityInterface $entity */
    $entity = $controller
      ->create();
    foreach ($this->langcodes as $langcode) {
      $entity
        ->addTranslation($langcode);
    }
    $default_langcode = $entity
      ->getUntranslated()
      ->language()
      ->getId();
    foreach (array_keys($entity
      ->getTranslationLanguages()) as $langcode) {
      $translation = $entity
        ->getTranslation($langcode);
      foreach ($translation
        ->getFields() as $field_name => $field) {
        if ($field
          ->getFieldDefinition()
          ->isTranslatable()) {
          $args = [
            '%field_name' => $field_name,
            '%langcode' => $langcode,
          ];
          $this
            ->assertEqual($langcode, $field
            ->getEntity()
            ->language()
            ->getId(), format_string('Translatable field %field_name on translation %langcode has correct entity reference in translation %langcode.', $args));
        }
        else {
          $args = [
            '%field_name' => $field_name,
            '%langcode' => $langcode,
            '%default_langcode' => $default_langcode,
          ];
          $this
            ->assertEqual($default_langcode, $field
            ->getEntity()
            ->language()
            ->getId(), format_string('Non translatable field %field_name on translation %langcode has correct entity reference in the default translation %default_langcode.', $args));
        }
      }
    }
  }

}

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. 2
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::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 function Casts MarkupInterface objects into strings.
EntityLanguageTestBase::$fieldName protected property The test field name.
EntityLanguageTestBase::$langcodes protected property The available language codes.
EntityLanguageTestBase::$languageManager protected property The language manager service.
EntityLanguageTestBase::$modules public static property Modules to enable. Overrides EntityUnitTestBase::$modules
EntityLanguageTestBase::$untranslatableFieldName protected property The untranslatable test field name.
EntityLanguageTestBase::setUp protected function Performs setup tasks before each individual test method is run. Overrides EntityUnitTestBase::setUp 1
EntityLanguageTestBase::toggleFieldTranslatability protected function Toggles field storage translatability.
EntityTranslationTest::doTestEntityLanguageMethods protected function Executes the entity language method tests for the given entity type.
EntityTranslationTest::doTestEntityTranslationAPI protected function Executes the Entity Translation API tests for the given entity type.
EntityTranslationTest::doTestLanguageChange protected function Executes the entity language change test for the given entity type.
EntityTranslationTest::doTestLanguageFallback protected function Executes the language fallback test for the given entity type.
EntityTranslationTest::doTestMultilingualProperties protected function Executes the multilingual property tests for the given entity type.
EntityTranslationTest::testEntityAdapter function Tests how entity adapters work with translations.
EntityTranslationTest::testEntityLanguageMethods public function Tests language related methods of the Entity class.
EntityTranslationTest::testEntityTranslationAPI function Tests the Entity Translation API behavior.
EntityTranslationTest::testFieldDefinitions function Check that field translatability is handled properly.
EntityTranslationTest::testFieldEntityReference public function Tests if entity references are correct after adding a new translation.
EntityTranslationTest::testLanguageChange public function Tests that changing entity language does not break field language.
EntityTranslationTest::testLanguageFallback function Tests language fallback applied to field and entity translations.
EntityTranslationTest::testMultilingualProperties public function Tests multilingual properties.
EntityUnitTestBase::$entityManager protected property The entity manager service.
EntityUnitTestBase::$generatedIds protected property A list of generated identifiers.
EntityUnitTestBase::$state protected property The state service.
EntityUnitTestBase::createUser protected function Creates a user.
EntityUnitTestBase::generateRandomEntityId protected function Generates a random ID avoiding collisions.
EntityUnitTestBase::getHooksInfo protected function Returns the entity_test hook invocation info.
EntityUnitTestBase::installModule protected function Installs a module and refreshes services.
EntityUnitTestBase::refreshServices protected function Refresh services. 1
EntityUnitTestBase::reloadEntity protected function Reloads the given entity from the storage and returns it.
EntityUnitTestBase::uninstallModule protected function Uninstalls a module and refreshes services.
KernelTestBase::$configDirectories protected property The configuration directories for this test run.
KernelTestBase::$keyValueFactory protected property A KeyValueMemoryFactory instance to use when building the container.
KernelTestBase::$moduleFiles private property
KernelTestBase::$streamWrappers protected property Array of registered stream wrappers.
KernelTestBase::$themeFiles private property
KernelTestBase::beforePrepareEnvironment protected function Act on global state information before the environment is altered for a test. Overrides TestBase::beforePrepareEnvironment
KernelTestBase::containerBuild public function Sets up the base service container for this test. 12
KernelTestBase::defaultLanguageData protected function Provides the data for setting the default language on the container. 1
KernelTestBase::disableModules protected function Disables modules for this test.
KernelTestBase::enableModules protected function Enables modules for this test.
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 a specific table from a module schema definition.
KernelTestBase::prepareConfigDirectories protected function Create and set new configuration directories. 1
KernelTestBase::registerStreamWrapper protected function Registers a stream wrapper for this test.
KernelTestBase::render protected function Renders a render array.
KernelTestBase::tearDown protected function Performs cleanup tasks after each individual test method has been run. Overrides TestBase::tearDown
KernelTestBase::__construct function Constructor for Test. Overrides TestBase::__construct
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.
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.
SessionTestTrait::$sessionName protected property The name of the session cookie.
SessionTestTrait::generateSessionName protected function Generates a session cookie name.
SessionTestTrait::getSessionName protected function Returns the session name in use on the child site.
TestBase::$assertions protected property Assertions thrown in that test case.
TestBase::$configImporter protected property The config importer that can used in a test. 5
TestBase::$configSchemaCheckerExclusions protected static property An array of config object names that are excluded from schema checking.
TestBase::$container protected property The dependency injection container used in the test.
TestBase::$databasePrefix protected property The database prefix of this test run.
TestBase::$dieOnFail public property Whether to die in case any test assertion fails.
TestBase::$httpAuthCredentials protected property HTTP authentication credentials (<username>:<password>).
TestBase::$httpAuthMethod protected property HTTP authentication method (specified as a CURLAUTH_* constant).
TestBase::$kernel protected property The DrupalKernel instance used in the test. 1
TestBase::$originalConf protected property The original configuration (variables), if available.
TestBase::$originalConfig protected property The original configuration (variables).
TestBase::$originalConfigDirectories protected property The original configuration directories.
TestBase::$originalContainer protected property The original container.
TestBase::$originalFileDirectory protected property The original file directory, before it was changed for testing purposes.
TestBase::$originalLanguage protected property The original language.
TestBase::$originalPrefix protected property The original database prefix when running inside Simpletest.
TestBase::$originalProfile protected property The original installation profile.
TestBase::$originalSessionName protected property The name of the session cookie of the test-runner.
TestBase::$originalSettings protected property The settings array.
TestBase::$originalShutdownCallbacks protected property The original array of shutdown function callbacks. 1
TestBase::$originalSite protected property The site directory of the original parent site.
TestBase::$originalUser protected property The original user, before testing began. 1
TestBase::$privateFilesDirectory protected property The private file directory for the test environment.
TestBase::$publicFilesDirectory protected property The public file directory for the test environment.
TestBase::$results public property Current results of this test case.
TestBase::$siteDirectory protected property The site directory of this test run.
TestBase::$skipClasses protected property This class is skipped when looking for the source of an assertion.
TestBase::$strictConfigSchema protected property Set to TRUE to strict check all configuration saved. 4
TestBase::$tempFilesDirectory protected property The temporary file directory for the test environment.
TestBase::$testId protected property The test run ID.
TestBase::$timeLimit protected property Time limit for the test.
TestBase::$translationFilesDirectory protected property The translation file directory for the test environment.
TestBase::$verbose public property TRUE if verbose debugging is enabled.
TestBase::$verboseClassName protected property Safe class name for use in verbose output filenames.
TestBase::$verboseDirectory protected property Directory where verbose output files are put.
TestBase::$verboseDirectoryUrl protected property URL to the verbose output file directory.
TestBase::$verboseId protected property Incrementing identifier for verbose output filenames.
TestBase::assert protected function Internal helper: stores the assert.
TestBase::assertEqual protected function Check to see if two values are equal.
TestBase::assertErrorLogged protected function Asserts that a specific error has been logged to the PHP error log.
TestBase::assertFalse protected function Check to see if a value is false.
TestBase::assertIdentical protected function Check to see if two values are identical.
TestBase::assertIdenticalObject protected function Checks to see if two objects are identical.
TestBase::assertNoErrorsLogged protected function Asserts that no errors have been logged to the PHP error.log thus far.
TestBase::assertNotEqual protected function Check to see if two values are not equal.
TestBase::assertNotIdentical protected function Check to see if two values are not identical.
TestBase::assertNotNull protected function Check to see if a value is not NULL.
TestBase::assertNull protected function Check to see if a value is NULL.
TestBase::assertTrue protected function Check to see if a value is not false.
TestBase::changeDatabasePrefix private function Changes the database connection to the prefixed one.
TestBase::checkRequirements protected function Checks the matching requirements for Test. 2
TestBase::config protected function Configuration accessor for tests. Returns non-overridden configuration.
TestBase::configImporter public function Returns a ConfigImporter object to import test importing of configuration. 5
TestBase::copyConfig public function Copies configuration objects from source storage to target storage.
TestBase::deleteAssert public static function Delete an assertion record by message ID.
TestBase::error protected function Fire an error assertion. 3
TestBase::errorHandler public function Handle errors during test runs.
TestBase::exceptionHandler protected function Handle exceptions.
TestBase::fail protected function Fire an assertion that is always negative.
TestBase::filePreDeleteCallback public static function Ensures test files are deletable within file_unmanaged_delete_recursive().
TestBase::generatePermutations public static function Converts a list of possible parameters into a stack of permutations.
TestBase::getAssertionCall protected function Cycles through backtrace until the first non-assertion method is found.
TestBase::getConfigSchemaExclusions protected function Gets the config schema exclusions for this test.
TestBase::getDatabaseConnection public static function Returns the database connection to the site running Simpletest.
TestBase::getDatabasePrefix public function Gets the database prefix.
TestBase::getTempFilesDirectory public function Gets the temporary files directory.
TestBase::insertAssert public static function Store an assertion from outside the testing context.
TestBase::pass protected function Fire an assertion that is always positive.
TestBase::prepareDatabasePrefix private function Generates a database prefix for running tests.
TestBase::prepareEnvironment private function Prepares the current environment for running the test.
TestBase::restoreEnvironment private function Cleans up the test environment and restores the original environment.
TestBase::run public function Run all tests in this class. 1
TestBase::settingsSet protected function Changes in memory settings.
TestBase::storeAssertion protected function Helper method to store an assertion record in the configured database.
TestBase::verbose protected function Logs a verbose message in a text file.