class ContentTranslationUITestBase
Same name in this branch
- 8.9.x core/modules/content_translation/tests/src/Functional/ContentTranslationUITestBase.php \Drupal\Tests\content_translation\Functional\ContentTranslationUITestBase
Same name in other branches
- 9 core/modules/content_translation/tests/src/Functional/ContentTranslationUITestBase.php \Drupal\Tests\content_translation\Functional\ContentTranslationUITestBase
- 10 core/modules/content_translation/tests/src/Functional/ContentTranslationUITestBase.php \Drupal\Tests\content_translation\Functional\ContentTranslationUITestBase
- 11.x core/modules/content_translation/tests/src/Functional/ContentTranslationUITestBase.php \Drupal\Tests\content_translation\Functional\ContentTranslationUITestBase
Tests the Content Translation UI.
Hierarchy
- class \Drupal\simpletest\TestBase uses \Drupal\Tests\AssertHelperTrait, \Drupal\Core\Test\TestSetupTrait, \Drupal\Tests\RandomGeneratorTrait, \Drupal\Tests\Traits\Core\GeneratePermutationsTrait, \Drupal\Tests\ConfigTestTrait
- class \Drupal\simpletest\WebTestBase extends \Drupal\simpletest\TestBase uses \Drupal\Core\Test\FunctionalTestSetupTrait, \Drupal\KernelTests\AssertContentTrait, \Drupal\Tests\TestFileCreationTrait, \Drupal\system\Tests\Cache\AssertPageCacheContextsAndTagsTrait, \Drupal\Tests\block\Traits\BlockCreationTrait, \Drupal\Tests\node\Traits\ContentTypeCreationTrait, \Drupal\Tests\Traits\Core\CronRunTrait, \Drupal\Core\Test\AssertMailTrait, \Drupal\Tests\node\Traits\NodeCreationTrait, \Drupal\Tests\user\Traits\UserCreationTrait, \Drupal\Tests\XdebugRequestTrait, \Drupal\Tests\EntityViewTrait
- class \Drupal\content_translation\Tests\ContentTranslationTestBase extends \Drupal\simpletest\WebTestBase
- class \Drupal\content_translation\Tests\ContentTranslationUITestBase extends \Drupal\content_translation\Tests\ContentTranslationTestBase uses \Drupal\system\Tests\Cache\AssertPageCacheContextsAndTagsTrait
- class \Drupal\content_translation\Tests\ContentTranslationTestBase extends \Drupal\simpletest\WebTestBase
- class \Drupal\simpletest\WebTestBase extends \Drupal\simpletest\TestBase uses \Drupal\Core\Test\FunctionalTestSetupTrait, \Drupal\KernelTests\AssertContentTrait, \Drupal\Tests\TestFileCreationTrait, \Drupal\system\Tests\Cache\AssertPageCacheContextsAndTagsTrait, \Drupal\Tests\block\Traits\BlockCreationTrait, \Drupal\Tests\node\Traits\ContentTypeCreationTrait, \Drupal\Tests\Traits\Core\CronRunTrait, \Drupal\Core\Test\AssertMailTrait, \Drupal\Tests\node\Traits\NodeCreationTrait, \Drupal\Tests\user\Traits\UserCreationTrait, \Drupal\Tests\XdebugRequestTrait, \Drupal\Tests\EntityViewTrait
Expanded class hierarchy of ContentTranslationUITestBase
Deprecated
in drupal:8.?.? and is removed from drupal:9.0.0. Use \Drupal\Tests\content_translation\Functional\ContentTranslationUITestBase instead.
See also
https://www.drupal.org/node/2999939
File
-
core/
modules/ content_translation/ src/ Tests/ ContentTranslationUITestBase.php, line 25
Namespace
Drupal\content_translation\TestsView source
abstract class ContentTranslationUITestBase extends ContentTranslationTestBase {
use AssertPageCacheContextsAndTagsTrait;
/**
* The id of the entity being translated.
*
* @var mixed
*/
protected $entityId;
/**
* Whether the behavior of the language selector should be tested.
*
* @var bool
*/
protected $testLanguageSelector = TRUE;
/**
* Flag to determine if "all languages" rendering is tested.
*
* @var bool
*/
protected $testHTMLEscapeForAllLanguages = FALSE;
/**
* Default cache contexts expected on a non-translated entity.
*
* Cache contexts will not be checked if this list is empty.
*
* @var string[]
*/
protected $defaultCacheContexts = [
'languages:language_interface',
'theme',
'url.query_args:_wrapper_format',
'user.permissions',
];
/**
* Tests the basic translation UI.
*/
public function testTranslationUI() {
$this->doTestBasicTranslation();
$this->doTestTranslationOverview();
$this->doTestOutdatedStatus();
$this->doTestPublishedStatus();
$this->doTestAuthoringInfo();
$this->doTestTranslationEdit();
$this->doTestTranslationChanged();
$this->doTestChangedTimeAfterSaveWithoutChanges();
$this->doTestTranslationDeletion();
}
/**
* Tests the basic translation workflow.
*/
protected function doTestBasicTranslation() {
// Create a new test entity with original values in the default language.
$default_langcode = $this->langcodes[0];
$values[$default_langcode] = $this->getNewEntityValues($default_langcode);
// Create the entity with the editor as owner, so that afterwards a new
// translation is created by the translator and the translation author is
// tested.
$this->drupalLogin($this->editor);
$this->entityId = $this->createEntity($values[$default_langcode], $default_langcode);
$this->drupalLogin($this->translator);
$storage = $this->container
->get('entity_type.manager')
->getStorage($this->entityTypeId);
$storage->resetCache([
$this->entityId,
]);
$entity = $storage->load($this->entityId);
$this->assertTrue($entity, 'Entity found in the database.');
$this->drupalGet($entity->toUrl());
$this->assertResponse(200, 'Entity URL is valid.');
// Ensure that the content language cache context is not yet added to the
// page.
$this->assertCacheContexts($this->defaultCacheContexts);
$this->drupalGet($entity->toUrl('drupal:content-translation-overview'));
$this->assertNoText('Source language', 'Source language column correctly hidden.');
$translation = $this->getTranslation($entity, $default_langcode);
foreach ($values[$default_langcode] as $property => $value) {
$stored_value = $this->getValue($translation, $property, $default_langcode);
$value = is_array($value) ? $value[0]['value'] : $value;
$message = new FormattableMarkup('@property correctly stored in the default language.', [
'@property' => $property,
]);
$this->assertEqual($stored_value, $value, $message);
}
// Add a content translation.
$langcode = 'it';
$language = ConfigurableLanguage::load($langcode);
$values[$langcode] = $this->getNewEntityValues($langcode);
$entity_type_id = $entity->getEntityTypeId();
$add_url = Url::fromRoute("entity.{$entity_type_id}.content_translation_add", [
$entity->getEntityTypeId() => $entity->id(),
'source' => $default_langcode,
'target' => $langcode,
], [
'language' => $language,
]);
$this->drupalPostForm($add_url, $this->getEditValues($values, $langcode), $this->getFormSubmitActionForNewTranslation($entity, $langcode));
// Assert that HTML is not escaped unexpectedly.
if ($this->testHTMLEscapeForAllLanguages) {
$this->assertNoRaw('<span class="translation-entity-all-languages">(all languages)</span>');
$this->assertRaw('<span class="translation-entity-all-languages">(all languages)</span>');
}
// Ensure that the content language cache context is not yet added to the
// page.
$storage = $this->container
->get('entity_type.manager')
->getStorage($this->entityTypeId);
$storage->resetCache([
$this->entityId,
]);
$entity = $storage->load($this->entityId);
$this->drupalGet($entity->toUrl());
$this->assertCacheContexts(Cache::mergeContexts([
'languages:language_content',
], $this->defaultCacheContexts));
// Reset the cache of the entity, so that the new translation gets the
// updated values.
$metadata_source_translation = $this->manager
->getTranslationMetadata($entity->getTranslation($default_langcode));
$metadata_target_translation = $this->manager
->getTranslationMetadata($entity->getTranslation($langcode));
$author_field_name = $entity->hasField('content_translation_uid') ? 'content_translation_uid' : 'uid';
if ($entity->getFieldDefinition($author_field_name)
->isTranslatable()) {
$this->assertEqual($metadata_target_translation->getAuthor()
->id(), $this->translator
->id(), new FormattableMarkup('Author of the target translation @langcode correctly stored for translatable owner field.', [
'@langcode' => $langcode,
]));
$this->assertNotEqual($metadata_target_translation->getAuthor()
->id(), $metadata_source_translation->getAuthor()
->id(), new FormattableMarkup('Author of the target translation @target different from the author of the source translation @source for translatable owner field.', [
'@target' => $langcode,
'@source' => $default_langcode,
]));
}
else {
$this->assertEqual($metadata_target_translation->getAuthor()
->id(), $this->editor
->id(), 'Author of the entity remained untouched after translation for non translatable owner field.');
}
$created_field_name = $entity->hasField('content_translation_created') ? 'content_translation_created' : 'created';
if ($entity->getFieldDefinition($created_field_name)
->isTranslatable()) {
$this->assertTrue($metadata_target_translation->getCreatedTime() > $metadata_source_translation->getCreatedTime(), new FormattableMarkup('Translation creation timestamp of the target translation @target is newer than the creation timestamp of the source translation @source for translatable created field.', [
'@target' => $langcode,
'@source' => $default_langcode,
]));
}
else {
$this->assertEqual($metadata_target_translation->getCreatedTime(), $metadata_source_translation->getCreatedTime(), 'Creation timestamp of the entity remained untouched after translation for non translatable created field.');
}
if ($this->testLanguageSelector) {
$this->assertNoFieldByXPath('//select[@id="edit-langcode-0-value"]', NULL, 'Language selector correctly disabled on translations.');
}
$storage->resetCache([
$this->entityId,
]);
$entity = $storage->load($this->entityId);
$this->drupalGet($entity->toUrl('drupal:content-translation-overview'));
$this->assertNoText('Source language', 'Source language column correctly hidden.');
// Switch the source language.
$langcode = 'fr';
$language = ConfigurableLanguage::load($langcode);
$source_langcode = 'it';
$edit = [
'source_langcode[source]' => $source_langcode,
];
$entity_type_id = $entity->getEntityTypeId();
$add_url = Url::fromRoute("entity.{$entity_type_id}.content_translation_add", [
$entity->getEntityTypeId() => $entity->id(),
'source' => $default_langcode,
'target' => $langcode,
], [
'language' => $language,
]);
// This does not save anything, it merely reloads the form and fills in the
// fields with the values from the different source language.
$this->drupalPostForm($add_url, $edit, t('Change'));
$this->assertFieldByXPath("//input[@name=\"{$this->fieldName}[0][value]\"]", $values[$source_langcode][$this->fieldName][0]['value'], 'Source language correctly switched.');
// Add another translation and mark the other ones as outdated.
$values[$langcode] = $this->getNewEntityValues($langcode);
$edit = $this->getEditValues($values, $langcode) + [
'content_translation[retranslate]' => TRUE,
];
$entity_type_id = $entity->getEntityTypeId();
$add_url = Url::fromRoute("entity.{$entity_type_id}.content_translation_add", [
$entity->getEntityTypeId() => $entity->id(),
'source' => $source_langcode,
'target' => $langcode,
], [
'language' => $language,
]);
$this->drupalPostForm($add_url, $edit, $this->getFormSubmitActionForNewTranslation($entity, $langcode));
$storage->resetCache([
$this->entityId,
]);
$entity = $storage->load($this->entityId);
$this->drupalGet($entity->toUrl('drupal:content-translation-overview'));
$this->assertText('Source language', 'Source language column correctly shown.');
// Check that the entered values have been correctly stored.
foreach ($values as $langcode => $property_values) {
$translation = $this->getTranslation($entity, $langcode);
foreach ($property_values as $property => $value) {
$stored_value = $this->getValue($translation, $property, $langcode);
$value = is_array($value) ? $value[0]['value'] : $value;
$message = new FormattableMarkup('%property correctly stored with language %language.', [
'%property' => $property,
'%language' => $langcode,
]);
$this->assertEqual($stored_value, $value, $message);
}
}
}
/**
* Tests that the translation overview shows the correct values.
*/
protected function doTestTranslationOverview() {
$storage = $this->container
->get('entity_type.manager')
->getStorage($this->entityTypeId);
$storage->resetCache([
$this->entityId,
]);
$entity = $storage->load($this->entityId);
$translate_url = $entity->toUrl('drupal:content-translation-overview');
$this->drupalGet($translate_url);
$translate_url->setAbsolute(FALSE);
foreach ($this->langcodes as $langcode) {
if ($entity->hasTranslation($langcode)) {
$language = new Language([
'id' => $langcode,
]);
$view_url = $entity->toUrl('canonical', [
'language' => $language,
])
->toString();
$elements = $this->xpath('//table//a[@href=:href]', [
':href' => $view_url,
]);
$this->assertEqual((string) $elements[0], $entity->getTranslation($langcode)
->label(), new FormattableMarkup('Label correctly shown for %language translation.', [
'%language' => $langcode,
]));
$edit_path = $entity->toUrl('edit-form', [
'language' => $language,
])
->toString();
$elements = $this->xpath('//table//ul[@class="dropbutton"]/li/a[@href=:href]', [
':href' => $edit_path,
]);
$this->assertEqual((string) $elements[0], t('Edit'), new FormattableMarkup('Edit link correct for %language translation.', [
'%language' => $langcode,
]));
}
}
}
/**
* Tests up-to-date status tracking.
*/
protected function doTestOutdatedStatus() {
$storage = $this->container
->get('entity_type.manager')
->getStorage($this->entityTypeId);
$storage->resetCache([
$this->entityId,
]);
$entity = $storage->load($this->entityId);
$langcode = 'fr';
$languages = \Drupal::languageManager()->getLanguages();
// Mark translations as outdated.
$edit = [
'content_translation[retranslate]' => TRUE,
];
$edit_path = $entity->toUrl('edit-form', [
'language' => $languages[$langcode],
]);
$this->drupalPostForm($edit_path, $edit, $this->getFormSubmitAction($entity, $langcode));
$storage->resetCache([
$this->entityId,
]);
$entity = $storage->load($this->entityId);
// Check that every translation has the correct "outdated" status, and that
// the Translation fieldset is open if the translation is "outdated".
foreach ($this->langcodes as $added_langcode) {
$url = $entity->toUrl('edit-form', [
'language' => ConfigurableLanguage::load($added_langcode),
]);
$this->drupalGet($url);
if ($added_langcode == $langcode) {
$this->assertFieldByXPath('//input[@name="content_translation[retranslate]"]', FALSE, 'The retranslate flag is not checked by default.');
$this->assertFalse($this->xpath('//details[@id="edit-content-translation" and @open="open"]'), 'The translation tab should be collapsed by default.');
}
else {
$this->assertFieldByXPath('//input[@name="content_translation[outdated]"]', TRUE, 'The translate flag is checked by default.');
$this->assertTrue($this->xpath('//details[@id="edit-content-translation" and @open="open"]'), 'The translation tab is correctly expanded when the translation is outdated.');
$edit = [
'content_translation[outdated]' => FALSE,
];
$this->drupalPostForm($url, $edit, $this->getFormSubmitAction($entity, $added_langcode));
$this->drupalGet($url);
$this->assertFieldByXPath('//input[@name="content_translation[retranslate]"]', FALSE, 'The retranslate flag is now shown.');
$storage = $this->container
->get('entity_type.manager')
->getStorage($this->entityTypeId);
$storage->resetCache([
$this->entityId,
]);
$entity = $storage->load($this->entityId);
$this->assertFalse($this->manager
->getTranslationMetadata($entity->getTranslation($added_langcode))
->isOutdated(), 'The "outdated" status has been correctly stored.');
}
}
}
/**
* Tests the translation publishing status.
*/
protected function doTestPublishedStatus() {
$storage = $this->container
->get('entity_type.manager')
->getStorage($this->entityTypeId);
$storage->resetCache([
$this->entityId,
]);
$entity = $storage->load($this->entityId);
// Unpublish translations.
foreach ($this->langcodes as $index => $langcode) {
if ($index > 0) {
$url = $entity->toUrl('edit-form', [
'language' => ConfigurableLanguage::load($langcode),
]);
$edit = [
'content_translation[status]' => FALSE,
];
$this->drupalPostForm($url, $edit, $this->getFormSubmitAction($entity, $langcode));
$storage = $this->container
->get('entity_type.manager')
->getStorage($this->entityTypeId);
$storage->resetCache([
$this->entityId,
]);
$entity = $storage->load($this->entityId);
$this->assertFalse($this->manager
->getTranslationMetadata($entity->getTranslation($langcode))
->isPublished(), 'The translation has been correctly unpublished.');
}
}
// Check that the last published translation cannot be unpublished.
$this->drupalGet($entity->toUrl('edit-form'));
$this->assertFieldByXPath('//input[@name="content_translation[status]" and @disabled="disabled"]', TRUE, 'The last translation is published and cannot be unpublished.');
}
/**
* Tests the translation authoring information.
*/
protected function doTestAuthoringInfo() {
$storage = $this->container
->get('entity_type.manager')
->getStorage($this->entityTypeId);
$storage->resetCache([
$this->entityId,
]);
$entity = $storage->load($this->entityId);
$values = [];
// Post different authoring information for each translation.
foreach ($this->langcodes as $index => $langcode) {
$user = $this->drupalCreateUser();
$values[$langcode] = [
'uid' => $user->id(),
'created' => REQUEST_TIME - mt_rand(0, 1000),
];
$edit = [
'content_translation[uid]' => $user->getAccountName(),
'content_translation[created]' => $this->container
->get('date.formatter')
->format($values[$langcode]['created'], 'custom', 'Y-m-d H:i:s O'),
];
$url = $entity->toUrl('edit-form', [
'language' => ConfigurableLanguage::load($langcode),
]);
$this->drupalPostForm($url, $edit, $this->getFormSubmitAction($entity, $langcode));
}
$storage = $this->container
->get('entity_type.manager')
->getStorage($this->entityTypeId);
$storage->resetCache([
$this->entityId,
]);
$entity = $storage->load($this->entityId);
foreach ($this->langcodes as $langcode) {
$metadata = $this->manager
->getTranslationMetadata($entity->getTranslation($langcode));
$this->assertEqual($metadata->getAuthor()
->id(), $values[$langcode]['uid'], 'Translation author correctly stored.');
$this->assertEqual($metadata->getCreatedTime(), $values[$langcode]['created'], 'Translation date correctly stored.');
}
// Try to post non valid values and check that they are rejected.
$langcode = 'en';
$edit = [
// User names have by default length 8.
'content_translation[uid]' => $this->randomMachineName(12),
'content_translation[created]' => '19/11/1978',
];
$this->drupalPostForm($entity->toUrl('edit-form'), $edit, $this->getFormSubmitAction($entity, $langcode));
$this->assertTrue($this->xpath('//div[contains(@class, "error")]//ul'), 'Invalid values generate a list of form errors.');
$metadata = $this->manager
->getTranslationMetadata($entity->getTranslation($langcode));
$this->assertEqual($metadata->getAuthor()
->id(), $values[$langcode]['uid'], 'Translation author correctly kept.');
$this->assertEqual($metadata->getCreatedTime(), $values[$langcode]['created'], 'Translation date correctly kept.');
}
/**
* Tests translation deletion.
*/
protected function doTestTranslationDeletion() {
// Confirm and delete a translation.
$this->drupalLogin($this->translator);
$langcode = 'fr';
$storage = $this->container
->get('entity_type.manager')
->getStorage($this->entityTypeId);
$storage->resetCache([
$this->entityId,
]);
$entity = $storage->load($this->entityId);
$language = ConfigurableLanguage::load($langcode);
$url = $entity->toUrl('edit-form', [
'language' => $language,
]);
$this->drupalPostForm($url, [], t('Delete translation'));
$this->drupalPostForm(NULL, [], t('Delete @language translation', [
'@language' => $language->getName(),
]));
$storage->resetCache([
$this->entityId,
]);
$entity = $storage->load($this->entityId, TRUE);
if ($this->assertTrue(is_object($entity), 'Entity found')) {
$translations = $entity->getTranslationLanguages();
$this->assertTrue(count($translations) == 2 && empty($translations[$langcode]), 'Translation successfully deleted.');
}
// Check that the translator cannot delete the original translation.
$args = [
$this->entityTypeId => $entity->id(),
'language' => 'en',
];
$this->drupalGet(Url::fromRoute("entity.{$this->entityTypeId}.content_translation_delete", $args));
$this->assertResponse(403);
}
/**
* Returns an array of entity field values to be tested.
*/
protected function getNewEntityValues($langcode) {
return [
$this->fieldName => [
[
'value' => $this->randomMachineName(16),
],
],
];
}
/**
* Returns an edit array containing the values to be posted.
*/
protected function getEditValues($values, $langcode, $new = FALSE) {
$edit = $values[$langcode];
$langcode = $new ? LanguageInterface::LANGCODE_NOT_SPECIFIED : $langcode;
foreach ($values[$langcode] as $property => $value) {
if (is_array($value)) {
$edit["{$property}[0][value]"] = $value[0]['value'];
unset($edit[$property]);
}
}
return $edit;
}
/**
* Returns the form action value when submitting a new translation.
*
* @param \Drupal\Core\Entity\EntityInterface $entity
* The entity being tested.
* @param string $langcode
* Language code for the form.
*
* @return string
* Name of the button to hit.
*/
protected function getFormSubmitActionForNewTranslation(EntityInterface $entity, $langcode) {
$entity->addTranslation($langcode, $entity->toArray());
return $this->getFormSubmitAction($entity, $langcode);
}
/**
* Returns the form action value to be used to submit the entity form.
*
* @param \Drupal\Core\Entity\EntityInterface $entity
* The entity being tested.
* @param string $langcode
* Language code for the form.
*
* @return string
* Name of the button to hit.
*/
protected function getFormSubmitAction(EntityInterface $entity, $langcode) {
return t('Save') . $this->getFormSubmitSuffix($entity, $langcode);
}
/**
* Returns appropriate submit button suffix based on translatability.
*
* @param \Drupal\Core\Entity\EntityInterface $entity
* The entity being tested.
* @param string $langcode
* Language code for the form.
*
* @return string
* Submit button suffix based on translatability.
*/
protected function getFormSubmitSuffix(EntityInterface $entity, $langcode) {
return '';
}
/**
* Returns the translation object to use to retrieve the translated values.
*
* @param \Drupal\Core\Entity\EntityInterface $entity
* The entity being tested.
* @param string $langcode
* The language code identifying the translation to be retrieved.
*
* @return \Drupal\Core\TypedData\TranslatableInterface
* The translation object to act on.
*/
protected function getTranslation(EntityInterface $entity, $langcode) {
return $entity->getTranslation($langcode);
}
/**
* Returns the value for the specified property in the given language.
*
* @param \Drupal\Core\Entity\EntityInterface $translation
* The translation object the property value should be retrieved from.
* @param string $property
* The property name.
* @param string $langcode
* The property value.
*
* @return
* The property value.
*/
protected function getValue(EntityInterface $translation, $property, $langcode) {
$key = $property == 'user_id' ? 'target_id' : 'value';
return $translation->get($property)->{$key};
}
/**
* Returns the name of the field that implements the changed timestamp.
*
* @param \Drupal\Core\Entity\EntityInterface $entity
* The entity being tested.
*
* @return string
* The field name.
*/
protected function getChangedFieldName($entity) {
return $entity->hasField('content_translation_changed') ? 'content_translation_changed' : 'changed';
}
/**
* Tests edit content translation.
*/
protected function doTestTranslationEdit() {
$storage = $this->container
->get('entity_type.manager')
->getStorage($this->entityTypeId);
$storage->resetCache([
$this->entityId,
]);
$entity = $storage->load($this->entityId);
$languages = $this->container
->get('language_manager')
->getLanguages();
foreach ($this->langcodes as $langcode) {
// We only want to test the title for non-english translations.
if ($langcode != 'en') {
$options = [
'language' => $languages[$langcode],
];
$url = $entity->toUrl('edit-form', $options);
$this->drupalGet($url);
$this->assertRaw($entity->getTranslation($langcode)
->label());
}
}
}
/**
* Tests the basic translation workflow.
*/
protected function doTestTranslationChanged() {
$storage = $this->container
->get('entity_type.manager')
->getStorage($this->entityTypeId);
$storage->resetCache([
$this->entityId,
]);
$entity = $storage->load($this->entityId);
$changed_field_name = $this->getChangedFieldName($entity);
$definition = $entity->getFieldDefinition($changed_field_name);
$config = $definition->getConfig($entity->bundle());
foreach ([
FALSE,
TRUE,
] as $translatable_changed_field) {
if ($definition->isTranslatable()) {
// For entities defining a translatable changed field we want to test
// the correct behavior of that field even if the translatability is
// revoked. In that case the changed timestamp should be synchronized
// across all translations.
$config->setTranslatable($translatable_changed_field);
$config->save();
}
elseif ($translatable_changed_field) {
// For entities defining a non-translatable changed field we cannot
// declare the field as translatable on the fly by modifying its config
// because the schema doesn't support this.
break;
}
foreach ($entity->getTranslationLanguages() as $language) {
// Ensure different timestamps.
sleep(1);
$langcode = $language->getId();
$edit = [
$this->fieldName . '[0][value]' => $this->randomString(),
];
$edit_path = $entity->toUrl('edit-form', [
'language' => $language,
]);
$this->drupalPostForm($edit_path, $edit, $this->getFormSubmitAction($entity, $langcode));
$storage = $this->container
->get('entity_type.manager')
->getStorage($this->entityTypeId);
$storage->resetCache([
$this->entityId,
]);
$entity = $storage->load($this->entityId);
$this->assertEqual($entity->getChangedTimeAcrossTranslations(), $entity->getTranslation($langcode)
->getChangedTime(), new FormattableMarkup('Changed time for language %language is the latest change over all languages.', [
'%language' => $language->getName(),
]));
}
$timestamps = [];
foreach ($entity->getTranslationLanguages() as $language) {
$next_timestamp = $entity->getTranslation($language->getId())
->getChangedTime();
if (!in_array($next_timestamp, $timestamps)) {
$timestamps[] = $next_timestamp;
}
}
if ($translatable_changed_field) {
$this->assertEqual(count($timestamps), count($entity->getTranslationLanguages()), 'All timestamps from all languages are different.');
}
else {
$this->assertEqual(count($timestamps), 1, 'All timestamps from all languages are identical.');
}
}
}
/**
* Test the changed time after API and FORM save without changes.
*/
public function doTestChangedTimeAfterSaveWithoutChanges() {
$storage = $this->container
->get('entity_type.manager')
->getStorage($this->entityTypeId);
$storage->resetCache([
$this->entityId,
]);
$entity = $storage->load($this->entityId);
// Test only entities, which implement the EntityChangedInterface.
if ($entity instanceof EntityChangedInterface) {
$changed_timestamp = $entity->getChangedTime();
$entity->save();
$storage = $this->container
->get('entity_type.manager')
->getStorage($this->entityTypeId);
$storage->resetCache([
$this->entityId,
]);
$entity = $storage->load($this->entityId);
$this->assertEqual($changed_timestamp, $entity->getChangedTime(), 'The entity\'s changed time wasn\'t updated after API save without changes.');
// Ensure different save timestamps.
sleep(1);
// Save the entity on the regular edit form.
$language = $entity->language();
$edit_path = $entity->toUrl('edit-form', [
'language' => $language,
]);
$this->drupalPostForm($edit_path, [], $this->getFormSubmitAction($entity, $language->getId()));
$storage->resetCache([
$this->entityId,
]);
$entity = $storage->load($this->entityId);
$this->assertNotEqual($changed_timestamp, $entity->getChangedTime(), 'The entity\'s changed time was updated after form save without changes.');
}
}
}
Members
Title Sort descending | Deprecated | Modifiers | Object type | Summary | Member alias | Overriden Title | 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. | ||||
AssertMailTrait::assertMail | protected | function | Asserts that the most recently sent email message has the given value. | ||||
AssertMailTrait::assertMailPattern | protected | function | Asserts that the most recently sent email message has the pattern in it. | ||||
AssertMailTrait::assertMailString | protected | function | Asserts that the most recently sent email message has the string in it. | ||||
AssertMailTrait::getMails | protected | function | Gets an array containing all emails sent during this test case. | Aliased as: drupalGetMails | |||
AssertMailTrait::verboseEmail | protected | function | Outputs to verbose the most recent $count emails sent. | ||||
AssertPageCacheContextsAndTagsTrait::assertCacheContext | protected | function | Asserts whether an expected cache context was present in the last response. | ||||
AssertPageCacheContextsAndTagsTrait::assertCacheContexts | protected | function | Ensures that some cache contexts are present in the current response. | ||||
AssertPageCacheContextsAndTagsTrait::assertCacheMaxAge | protected | function | Asserts the max age header. | ||||
AssertPageCacheContextsAndTagsTrait::assertCacheTags | protected | function | Ensures that some cache tags are present in the current response. | ||||
AssertPageCacheContextsAndTagsTrait::assertNoCacheContext | protected | function | Asserts that a cache context was not present in the last response. | ||||
AssertPageCacheContextsAndTagsTrait::assertPageCacheContextsAndTags | protected | function | Asserts page cache miss, then hit for the given URL; checks cache headers. | ||||
AssertPageCacheContextsAndTagsTrait::debugCacheTags | protected | function | Provides debug information for cache tags. | ||||
AssertPageCacheContextsAndTagsTrait::enablePageCaching | protected | function | Enables page caching. | ||||
AssertPageCacheContextsAndTagsTrait::getCacheHeaderValues | protected | function | Gets a specific header value as array. | ||||
BlockCreationTrait::placeBlock | protected | function | Creates a block instance based on default settings. | Aliased as: drupalPlaceBlock | |||
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. | ||||
ContentTranslationTestBase::$administrator | protected | property | The account to be used to test access to both workflows. | ||||
ContentTranslationTestBase::$bundle | protected | property | The bundle being tested. | ||||
ContentTranslationTestBase::$controller | protected | property | The translation controller for the current entity type. | ||||
ContentTranslationTestBase::$editor | protected | property | The account to be used to test multilingual entity editing. | ||||
ContentTranslationTestBase::$entityTypeId | protected | property | The entity type being tested. | ||||
ContentTranslationTestBase::$fieldName | protected | property | The name of the field used to test translation. | ||||
ContentTranslationTestBase::$langcodes | protected | property | The added languages. | ||||
ContentTranslationTestBase::$manager | protected | property | |||||
ContentTranslationTestBase::$modules | public static | property | Modules to enable. | ||||
ContentTranslationTestBase::$translator | protected | property | The account to be used to test translation operations. | ||||
ContentTranslationTestBase::createEntity | protected | function | Creates the entity to be translated. | ||||
ContentTranslationTestBase::enableTranslation | protected | function | Enables translation for the current entity type and bundle. | ||||
ContentTranslationTestBase::getAdministratorPermissions | protected | function | Returns an array of permissions needed for the administrator. | ||||
ContentTranslationTestBase::getEditorPermissions | protected | function | Returns an array of permissions needed for the editor. | ||||
ContentTranslationTestBase::getTranslatePermission | protected | function | Returns the translate permissions for the current entity and bundle. | ||||
ContentTranslationTestBase::getTranslatorPermissions | protected | function | Returns an array of permissions needed for the translator. | ||||
ContentTranslationTestBase::setUp | protected | function | Sets up a Drupal site for running functional and integration tests. | Overrides WebTestBase::setUp | |||
ContentTranslationTestBase::setupBundle | protected | function | Creates or initializes the bundle date if needed. | ||||
ContentTranslationTestBase::setupLanguages | protected | function | Adds additional languages. | ||||
ContentTranslationTestBase::setupTestFields | protected | function | Creates the test fields. | ||||
ContentTranslationTestBase::setupUsers | protected | function | Creates and activates translator, editor and admin users. | ||||
ContentTranslationUITestBase::$defaultCacheContexts | protected | property | Default cache contexts expected on a non-translated entity. | ||||
ContentTranslationUITestBase::$entityId | protected | property | The id of the entity being translated. | ||||
ContentTranslationUITestBase::$testHTMLEscapeForAllLanguages | protected | property | Flag to determine if "all languages" rendering is tested. | ||||
ContentTranslationUITestBase::$testLanguageSelector | protected | property | Whether the behavior of the language selector should be tested. | ||||
ContentTranslationUITestBase::doTestAuthoringInfo | protected | function | Tests the translation authoring information. | ||||
ContentTranslationUITestBase::doTestBasicTranslation | protected | function | Tests the basic translation workflow. | ||||
ContentTranslationUITestBase::doTestChangedTimeAfterSaveWithoutChanges | public | function | Test the changed time after API and FORM save without changes. | ||||
ContentTranslationUITestBase::doTestOutdatedStatus | protected | function | Tests up-to-date status tracking. | ||||
ContentTranslationUITestBase::doTestPublishedStatus | protected | function | Tests the translation publishing status. | ||||
ContentTranslationUITestBase::doTestTranslationChanged | protected | function | Tests the basic translation workflow. | ||||
ContentTranslationUITestBase::doTestTranslationDeletion | protected | function | Tests translation deletion. | ||||
ContentTranslationUITestBase::doTestTranslationEdit | protected | function | Tests edit content translation. | ||||
ContentTranslationUITestBase::doTestTranslationOverview | protected | function | Tests that the translation overview shows the correct values. | ||||
ContentTranslationUITestBase::getChangedFieldName | protected | function | Returns the name of the field that implements the changed timestamp. | ||||
ContentTranslationUITestBase::getEditValues | protected | function | Returns an edit array containing the values to be posted. | ||||
ContentTranslationUITestBase::getFormSubmitAction | protected | function | Returns the form action value to be used to submit the entity form. | ||||
ContentTranslationUITestBase::getFormSubmitActionForNewTranslation | protected | function | Returns the form action value when submitting a new translation. | ||||
ContentTranslationUITestBase::getFormSubmitSuffix | protected | function | Returns appropriate submit button suffix based on translatability. | ||||
ContentTranslationUITestBase::getNewEntityValues | protected | function | Returns an array of entity field values to be tested. | ||||
ContentTranslationUITestBase::getTranslation | protected | function | Returns the translation object to use to retrieve the translated values. | ||||
ContentTranslationUITestBase::getValue | protected | function | Returns the value for the specified property in the given language. | ||||
ContentTranslationUITestBase::testTranslationUI | public | function | Tests the basic translation UI. | ||||
ContentTypeCreationTrait::createContentType | protected | function | Creates a custom content type based on default settings. | Aliased as: drupalCreateContentType | 1 | ||
CronRunTrait::cronRun | protected | function | Runs cron on the test site. | ||||
EntityViewTrait::buildEntityView | protected | function | Builds the renderable view of an entity. | Aliased as: drupalBuildEntityView | |||
FunctionalTestSetupTrait::$apcuEnsureUniquePrefix | protected | property | The flag to set 'apcu_ensure_unique_prefix' setting. | 1 | |||
FunctionalTestSetupTrait::$classLoader | protected | property | The class loader to use for installation and initialization of setup. | ||||
FunctionalTestSetupTrait::$configDirectories | Deprecated | protected | property | The config directories used in this test. | |||
FunctionalTestSetupTrait::$rootUser | protected | property | The "#1" admin user. | ||||
FunctionalTestSetupTrait::doInstall | protected | function | Execute the non-interactive installer. | 1 | |||
FunctionalTestSetupTrait::getDatabaseTypes | protected | function | Returns all supported database driver installer objects. | ||||
FunctionalTestSetupTrait::initConfig | protected | function | Initialize various configurations post-installation. | 2 | |||
FunctionalTestSetupTrait::initKernel | protected | function | Initializes the kernel after installation. | ||||
FunctionalTestSetupTrait::initSettings | protected | function | Initialize settings created during install. | ||||
FunctionalTestSetupTrait::initUserSession | protected | function | Initializes user 1 for the site to be installed. | ||||
FunctionalTestSetupTrait::installDefaultThemeFromClassProperty | protected | function | Installs the default theme defined by `static::$defaultTheme` when needed. | ||||
FunctionalTestSetupTrait::installModulesFromClassProperty | protected | function | Install modules defined by `static::$modules`. | 1 | |||
FunctionalTestSetupTrait::installParameters | protected | function | Returns the parameters that will be used when Simpletest installs Drupal. | 9 | |||
FunctionalTestSetupTrait::prepareEnvironment | protected | function | Prepares the current environment for running the test. | 23 | |||
FunctionalTestSetupTrait::prepareRequestForGenerator | protected | function | Creates a mock request and sets it on the generator. | ||||
FunctionalTestSetupTrait::prepareSettings | protected | function | Prepares site settings and services before installation. | 2 | |||
FunctionalTestSetupTrait::rebuildAll | protected | function | Resets and rebuilds the environment after setup. | ||||
FunctionalTestSetupTrait::rebuildContainer | protected | function | Rebuilds \Drupal::getContainer(). | ||||
FunctionalTestSetupTrait::resetAll | protected | function | Resets all data structures after having enabled new modules. | ||||
FunctionalTestSetupTrait::setContainerParameter | protected | function | Changes parameters in the services.yml file. | ||||
FunctionalTestSetupTrait::setupBaseUrl | protected | function | Sets up the base URL based upon the environment variable. | ||||
FunctionalTestSetupTrait::writeSettings | protected | function | Rewrites the settings.php file of the test site. | ||||
GeneratePermutationsTrait::generatePermutations | public static | function | Converts a list of possible parameters into a stack of permutations. | ||||
NodeCreationTrait::createNode | protected | function | Creates a node based on default settings. | Aliased as: drupalCreateNode | |||
NodeCreationTrait::getNodeByTitle | public | function | Get a node from the database based on its title. | Aliased as: drupalGetNodeByTitle | |||
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. | ||||
RefreshVariablesTrait::refreshVariables | protected | function | Refreshes in-memory configuration and state information. | 3 | |||
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. | ||||
StorageCopyTrait::replaceStorageContents | protected static | function | Copy the configuration from one storage to another and remove stale items. | ||||
TestBase::$assertions | protected | property | Assertions thrown in that test case. | ||||
TestBase::$configImporter | protected | property | The config importer that can used in a 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::$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::$originalSessionName | protected | property | The name of the session cookie of the test-runner. | ||||
TestBase::$originalSettings | protected | property | The settings array. | ||||
TestBase::$results | public | property | Current results of this test case. | ||||
TestBase::$skipClasses | protected | property | This class is skipped when looking for the source of an assertion. | ||||
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::beforePrepareEnvironment | protected | function | Act on global state information before the environment is altered for a test. | 1 | |||
TestBase::checkRequirements | protected | function | Checks the matching requirements for Test. | 1 | |||
TestBase::checkTestHierarchyMismatch | public | function | Fail the test if it belongs to a PHPUnit-based framework. | ||||
TestBase::config | protected | function | Configuration accessor for tests. Returns non-overridden configuration. | ||||
TestBase::deleteAssert | public static | function | Delete an assertion record by message ID. | ||||
TestBase::error | protected | function | Fire an error assertion. | 1 | |||
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. | ||||
TestBase::getAssertionCall | protected | function | Cycles through backtrace until the first non-assertion method is found. | ||||
TestBase::getDatabasePrefix | public | function | Gets the database prefix. | ||||
TestBase::getTempFilesDirectory | public | function | Gets the temporary files directory. | ||||
TestBase::insertAssert | Deprecated | public static | function | Store an assertion from outside the testing context. | 1 | ||
TestBase::pass | protected | function | Fire an assertion that is always positive. | ||||
TestBase::prepareDatabasePrefix | private | function | Generates a database prefix for running tests. | Overrides TestSetupTrait::prepareDatabasePrefix | |||
TestBase::restoreEnvironment | private | function | Cleans up the test environment and restores the original environment. | ||||
TestBase::run | public | function | Run all tests in this class. | 2 | |||
TestBase::settingsSet | protected | function | Changes in memory settings. | ||||
TestBase::storeAssertion | protected | function | Helper method to store an assertion record in the configured database. | 1 | |||
TestBase::verbose | protected | function | Logs a verbose message in a text file. | ||||
TestFileCreationTrait::$generatedTestFiles | protected | property | Whether the files were copied to the test files directory. | ||||
TestFileCreationTrait::compareFiles | protected | function | Compares two files based on size and file name. | Aliased as: drupalCompareFiles | |||
TestFileCreationTrait::generateFile | public static | function | Generates a test file. | ||||
TestFileCreationTrait::getTestFiles | protected | function | Gets a list of files that can be used in tests. | Aliased as: drupalGetTestFiles | |||
TestSetupTrait::$configSchemaCheckerExclusions | protected static | property | An array of config object names that are excluded from schema checking. | ||||
TestSetupTrait::$container | protected | property | The dependency injection container used in the test. | ||||
TestSetupTrait::$kernel | protected | property | The DrupalKernel instance used in the test. | ||||
TestSetupTrait::$originalSite | protected | property | The site directory of the original parent site. | ||||
TestSetupTrait::$privateFilesDirectory | protected | property | The private file directory for the test environment. | ||||
TestSetupTrait::$publicFilesDirectory | protected | property | The public file directory for the test environment. | ||||
TestSetupTrait::$siteDirectory | protected | property | The site directory of this test run. | ||||
TestSetupTrait::$strictConfigSchema | protected | property | Set to TRUE to strict check all configuration saved. | 2 | |||
TestSetupTrait::$tempFilesDirectory | protected | property | The temporary file directory for the test environment. | ||||
TestSetupTrait::$testId | protected | property | The test run ID. | ||||
TestSetupTrait::changeDatabasePrefix | protected | function | Changes the database connection to the prefixed one. | ||||
TestSetupTrait::getConfigSchemaExclusions | protected | function | Gets the config schema exclusions for this test. | ||||
TestSetupTrait::getDatabaseConnection | public static | function | Returns the database connection to the site running Simpletest. | ||||
UserCreationTrait::checkPermissions | protected | function | Checks whether a given list of permission names is valid. | ||||
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. | ||||
UserCreationTrait::setCurrentUser | protected | function | Switch the current logged in user. | ||||
UserCreationTrait::setUpCurrentUser | protected | function | Creates a random user account and sets it as current user. | ||||
WebTestBase::$additionalCurlOptions | protected | property | Additional cURL options. | ||||
WebTestBase::$assertAjaxHeader | protected | property | Whether or not to assert the presence of the X-Drupal-Ajax-Token. | ||||
WebTestBase::$cookieFile | protected | property | The current cookie file used by cURL. | ||||
WebTestBase::$cookies | protected | property | The cookies of the page currently loaded in the internal browser. | ||||
WebTestBase::$curlCookies | protected | property | Cookies to set on curl requests. | ||||
WebTestBase::$curlHandle | protected | property | The handle of the current cURL connection. | ||||
WebTestBase::$customTranslations | protected | property | An array of custom translations suitable for drupal_rewrite_settings(). | ||||
WebTestBase::$dumpHeaders | protected | property | Indicates that headers should be dumped if verbose output is enabled. | 1 | |||
WebTestBase::$headers | protected | property | The headers of the page currently loaded in the internal browser. | ||||
WebTestBase::$loggedInUser | protected | property | The current user logged in using the internal browser. | ||||
WebTestBase::$maximumMetaRefreshCount | protected | property | The number of meta refresh redirects to follow, or NULL if unlimited. | ||||
WebTestBase::$maximumRedirects | protected | property | The maximum number of redirects to follow when handling responses. | ||||
WebTestBase::$metaRefreshCount | protected | property | The number of meta refresh redirects followed during ::drupalGet(). | ||||
WebTestBase::$originalBatch | protected | property | The original batch, before it was changed for testing purposes. | ||||
WebTestBase::$originalShutdownCallbacks | protected | property | The original shutdown handlers array, before it was cleaned for testing. | Overrides TestBase::$originalShutdownCallbacks | |||
WebTestBase::$originalUser | protected | property | The original user, before it was changed to a clean uid = 1 for testing. | Overrides TestBase::$originalUser | |||
WebTestBase::$profile | protected | property | The profile to install as a basis for testing. | 2 | |||
WebTestBase::$redirectCount | protected | property | The number of redirects followed during the handling of a request. | ||||
WebTestBase::$sessionId | protected | property | The current session ID, if available. | ||||
WebTestBase::$url | protected | property | The URL currently loaded in the internal browser. | ||||
WebTestBase::addCustomTranslations | protected | function | Queues custom translations to be written to settings.php. | ||||
WebTestBase::assertBlockAppears | protected | function | Checks to see whether a block appears on the page. | ||||
WebTestBase::assertCacheTag | protected | function | Asserts whether an expected cache tag was present in the last response. | ||||
WebTestBase::assertHeader | protected | function | Check if a HTTP response header exists and has the expected value. | ||||
WebTestBase::assertNoBlockAppears | protected | function | Checks to see whether a block does not appears on the page. | ||||
WebTestBase::assertNoCacheTag | protected | function | Asserts whether an expected cache tag was absent in the last response. | ||||
WebTestBase::assertNoResponse | protected | function | Asserts the page did not return the specified response code. | ||||
WebTestBase::assertResponse | protected | function | Asserts the page responds with the specified response code. | 1 | |||
WebTestBase::assertUrl | protected | function | Passes if the internal browser's URL matches the given path. | ||||
WebTestBase::buildUrl | protected | function | Builds an a absolute URL from a system path or a URL object. | ||||
WebTestBase::checkForMetaRefresh | protected | function | Checks for meta refresh tag and if found call drupalGet() recursively. | ||||
WebTestBase::clickLink | protected | function | Follows a link by complete name. | ||||
WebTestBase::clickLinkHelper | protected | function | Provides a helper for ::clickLink() and ::clickLinkPartialName(). | ||||
WebTestBase::clickLinkPartialName | protected | function | Follows a link by partial name. | ||||
WebTestBase::curlClose | protected | function | Close the cURL handler and unset the handler. | ||||
WebTestBase::curlExec | protected | function | Initializes and executes a cURL request. | 1 | |||
WebTestBase::curlHeaderCallback | protected | function | Reads headers and registers errors received from the tested site. | ||||
WebTestBase::curlInitialize | protected | function | Initializes the cURL connection. | ||||
WebTestBase::drupalGet | protected | function | Retrieves a Drupal path or an absolute path. | 1 | |||
WebTestBase::drupalGetAjax | protected | function | Requests a path or URL in drupal_ajax format and JSON-decodes the response. | ||||
WebTestBase::drupalGetHeader | protected | function | Gets the value of an HTTP response header. | 1 | |||
WebTestBase::drupalGetHeaders | protected | function | Gets the HTTP response headers of the requested page. | 1 | |||
WebTestBase::drupalGetJSON | protected | function | Retrieves a Drupal path or an absolute path and JSON decodes the result. | ||||
WebTestBase::drupalGetWithFormat | protected | function | Retrieves a Drupal path or an absolute path for a given format. | ||||
WebTestBase::drupalGetXHR | protected | function | Requests a Drupal path or an absolute path as if it is a XMLHttpRequest. | ||||
WebTestBase::drupalHead | protected | function | Retrieves only the headers for a Drupal path or an absolute path. | ||||
WebTestBase::drupalLogin | protected | function | Log in a user with the internal browser. | ||||
WebTestBase::drupalLogout | protected | function | Logs a user out of the internal browser and confirms. | ||||
WebTestBase::drupalPost | protected | function | Perform a POST HTTP request. | ||||
WebTestBase::drupalPostAjaxForm | protected | function | Executes an Ajax form submission. | ||||
WebTestBase::drupalPostForm | protected | function | Executes a form submission. | ||||
WebTestBase::drupalPostWithFormat | protected | function | Performs a POST HTTP request with a specific format. | ||||
WebTestBase::drupalProcessAjaxResponse | protected | function | Processes an AJAX response into current content. | ||||
WebTestBase::drupalUserIsLoggedIn | protected | function | Returns whether a given user account is logged in. | ||||
WebTestBase::findBlockInstance | protected | function | Find a block instance on the page. | ||||
WebTestBase::getAbsoluteUrl | protected | function | Takes a path and returns an absolute path. | ||||
WebTestBase::getAjaxPageStatePostData | protected | function | Get the Ajax page state from drupalSettings and prepare it for POSTing. | ||||
WebTestBase::handleForm | protected | function | Handles form input related to drupalPostForm(). | ||||
WebTestBase::isInChildSite | protected | function | Returns whether the test is being executed from within a test site. | ||||
WebTestBase::restoreBatch | protected | function | Restore the original batch. | ||||
WebTestBase::serializePostValues | protected | function | Serialize POST HTTP request values. | ||||
WebTestBase::setBatch | protected | function | Preserve the original batch, and instantiate the test batch. | ||||
WebTestBase::setHttpResponseDebugCacheabilityHeaders | protected | function | Enables/disables the cacheability headers. | ||||
WebTestBase::tearDown | protected | function | Cleans up after testing. | Overrides TestBase::tearDown | 1 | ||
WebTestBase::translatePostValues | protected | function | Transforms a nested array into a flat array suitable for WebTestBase::drupalPostForm(). | ||||
WebTestBase::writeCustomTranslations | protected | function | Writes custom translations to the test site's settings.php. | ||||
WebTestBase::__construct | public | function | Constructor for \Drupal\simpletest\WebTestBase. | Overrides TestBase::__construct | 1 | ||
XdebugRequestTrait::extractCookiesFromRequest | protected | function | Adds xdebug cookies, from request setup. |
Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.