class ConfigEntityTest
Same name in this branch
- 9 core/modules/config/tests/src/FunctionalJavascript/ConfigEntityTest.php \Drupal\Tests\config\FunctionalJavascript\ConfigEntityTest
Same name and namespace in other branches
- 11.x core/modules/config/tests/src/FunctionalJavascript/ConfigEntityTest.php \Drupal\Tests\config\FunctionalJavascript\ConfigEntityTest
- 11.x core/modules/config/tests/src/Functional/ConfigEntityTest.php \Drupal\Tests\config\Functional\ConfigEntityTest
- 11.x core/modules/migrate/tests/src/Kernel/Plugin/source/ConfigEntityTest.php \Drupal\Tests\migrate\Kernel\Plugin\source\ConfigEntityTest
- 10 core/modules/config/tests/src/FunctionalJavascript/ConfigEntityTest.php \Drupal\Tests\config\FunctionalJavascript\ConfigEntityTest
- 10 core/modules/config/tests/src/Functional/ConfigEntityTest.php \Drupal\Tests\config\Functional\ConfigEntityTest
- 8.9.x core/modules/config/tests/src/FunctionalJavascript/ConfigEntityTest.php \Drupal\Tests\config\FunctionalJavascript\ConfigEntityTest
- 8.9.x core/modules/config/tests/src/Functional/ConfigEntityTest.php \Drupal\Tests\config\Functional\ConfigEntityTest
Tests configuration entities.
@group config
Hierarchy
- class \Drupal\Tests\BrowserTestBase uses \Drupal\Core\Test\FunctionalTestSetupTrait, \Drupal\Tests\UiHelperTrait, \Drupal\Core\Test\TestSetupTrait, \Drupal\Tests\block\Traits\BlockCreationTrait, \Drupal\FunctionalTests\AssertLegacyTrait, \Drupal\Tests\RandomGeneratorTrait, \Drupal\Tests\node\Traits\NodeCreationTrait, \Drupal\Tests\node\Traits\ContentTypeCreationTrait, \Drupal\Tests\ConfigTestTrait, \Drupal\Tests\TestRequirementsTrait, \Drupal\Tests\user\Traits\UserCreationTrait, \Drupal\Tests\XdebugRequestTrait, \Drupal\Tests\Traits\PhpUnitWarnings, \Drupal\Tests\PhpUnitCompatibilityTrait, \Symfony\Bridge\PhpUnit\ExpectDeprecationTrait, \Drupal\Tests\ExtensionListTestTrait implements \PHPUnit\Framework\TestCase
- class \Drupal\Tests\config\Functional\ConfigEntityTest implements \Drupal\Tests\BrowserTestBase
Expanded class hierarchy of ConfigEntityTest
File
-
core/
modules/ config/ tests/ src/ Functional/ ConfigEntityTest.php, line 19
Namespace
Drupal\Tests\config\FunctionalView source
class ConfigEntityTest extends BrowserTestBase {
/**
* The maximum length for the entity storage used in this test.
*/
const MAX_ID_LENGTH = ConfigEntityStorage::MAX_ID_LENGTH;
/**
* Modules to enable.
*
* @var array
*/
protected static $modules = [
'config_test',
];
/**
* {@inheritdoc}
*/
protected $defaultTheme = 'stark';
/**
* Tests CRUD operations.
*/
public function testCRUD() {
$default_langcode = \Drupal::languageManager()->getDefaultLanguage()
->getId();
// Verify default properties on a newly created empty entity.
$storage = \Drupal::entityTypeManager()->getStorage('config_test');
$empty = $storage->create();
$this->assertNull($empty->label);
$this->assertNull($empty->style);
$this->assertSame($default_langcode, $empty->language()
->getId());
// Verify ConfigEntity properties/methods on the newly created empty entity.
$this->assertTrue($empty->isNew());
$this->assertNull($empty->getOriginalId());
$this->assertSame('config_test', $empty->bundle());
$this->assertNull($empty->id());
$this->assertTrue(Uuid::isValid($empty->uuid()));
$this->assertNull($empty->label());
$this->assertNull($empty->get('id'));
$this->assertTrue(Uuid::isValid($empty->get('uuid')));
$this->assertNull($empty->get('label'));
$this->assertNull($empty->get('style'));
$this->assertSame($default_langcode, $empty->language()
->getId());
// Verify Entity properties/methods on the newly created empty entity.
$this->assertSame('config_test', $empty->getEntityTypeId());
// The URI can only be checked after saving.
try {
$empty->toUrl();
$this->fail('EntityMalformedException was thrown.');
} catch (EntityMalformedException $e) {
// Expected exception; just continue testing.
}
// Verify that an empty entity cannot be saved.
try {
$empty->save();
$this->fail('EntityMalformedException was thrown.');
} catch (EntityMalformedException $e) {
// Expected exception; just continue testing.
}
// Verify that an entity with an empty ID string is considered empty, too.
$empty_id = $storage->create([
'id' => '',
]);
$this->assertTrue($empty_id->isNew());
try {
$empty_id->save();
$this->fail('EntityMalformedException was thrown.');
} catch (EntityMalformedException $e) {
// Expected exception; just continue testing.
}
// Verify properties on a newly created entity.
$config_test = $storage->create($expected = [
'id' => $this->randomMachineName(),
'label' => $this->randomString(),
'style' => $this->randomMachineName(),
]);
$this->assertNotEquals($empty->uuid(), $config_test->uuid());
$this->assertSame($expected['label'], $config_test->label);
$this->assertSame($expected['style'], $config_test->style);
$this->assertSame($default_langcode, $config_test->language()
->getId());
// Verify methods on the newly created entity.
$this->assertTrue($config_test->isNew());
$this->assertSame($expected['id'], $config_test->getOriginalId());
$this->assertSame($expected['id'], $config_test->id());
$this->assertTrue(Uuid::isValid($config_test->uuid()));
$expected['uuid'] = $config_test->uuid();
$this->assertSame($expected['label'], $config_test->label());
// Verify that the entity can be saved.
try {
$status = $config_test->save();
} catch (EntityMalformedException $e) {
$this->fail('EntityMalformedException was not thrown.');
}
// The entity path can only be checked after saving.
$this->assertSame(Url::fromRoute('entity.config_test.edit_form', [
'config_test' => $expected['id'],
])->toString(), $config_test->toUrl()
->toString());
// Verify that the correct status is returned and properties did not change.
$this->assertSame(SAVED_NEW, $status);
$this->assertSame($expected['id'], $config_test->id());
$this->assertSame($expected['uuid'], $config_test->uuid());
$this->assertSame($expected['label'], $config_test->label());
$this->assertFalse($config_test->isNew());
$this->assertSame($expected['id'], $config_test->getOriginalId());
// Save again, and verify correct status and properties again.
$status = $config_test->save();
$this->assertSame(SAVED_UPDATED, $status);
$this->assertSame($expected['id'], $config_test->id());
$this->assertSame($expected['uuid'], $config_test->uuid());
$this->assertSame($expected['label'], $config_test->label());
$this->assertFalse($config_test->isNew());
$this->assertSame($expected['id'], $config_test->getOriginalId());
// Verify that a configuration entity can be saved with an ID of the
// maximum allowed length, but not longer.
// Test with a short ID.
$id_length_config_test = $storage->create([
'id' => $this->randomMachineName(8),
]);
try {
$id_length_config_test->save();
} catch (ConfigEntityIdLengthException $e) {
$this->fail($e->getMessage());
}
// Test with an ID of the maximum allowed length.
$id_length_config_test = $storage->create([
'id' => $this->randomMachineName(static::MAX_ID_LENGTH),
]);
try {
$id_length_config_test->save();
} catch (ConfigEntityIdLengthException $e) {
$this->fail($e->getMessage());
}
// Test with an ID exceeding the maximum allowed length.
$id_length_config_test = $storage->create([
'id' => $this->randomMachineName(static::MAX_ID_LENGTH + 1),
]);
try {
$status = $id_length_config_test->save();
$this->fail(new FormattableMarkup("config_test entity with ID length @length exceeding the maximum allowed length of @max saved successfully", [
'@length' => strlen($id_length_config_test->id()),
'@max' => static::MAX_ID_LENGTH,
]));
} catch (ConfigEntityIdLengthException $e) {
// Expected exception; just continue testing.
}
// Ensure that creating an entity with the same id as an existing one is not
// possible.
$same_id = $storage->create([
'id' => $config_test->id(),
]);
$this->assertTrue($same_id->isNew());
try {
$same_id->save();
$this->fail('Not possible to overwrite an entity.');
} catch (EntityStorageException $e) {
// Expected exception; just continue testing.
}
// Verify that renaming the ID returns correct status and properties.
$ids = [
$expected['id'],
'second_' . $this->randomMachineName(4),
'third_' . $this->randomMachineName(4),
];
for ($i = 1; $i < 3; $i++) {
$old_id = $ids[$i - 1];
$new_id = $ids[$i];
// Before renaming, everything should point to the current ID.
$this->assertSame($old_id, $config_test->id());
$this->assertSame($old_id, $config_test->getOriginalId());
// Rename.
$config_test->set('id', $new_id);
$this->assertSame($new_id, $config_test->id());
$status = $config_test->save();
$this->assertSame(SAVED_UPDATED, $status);
$this->assertFalse($config_test->isNew());
// Verify that originalID points to new ID directly after renaming.
$this->assertSame($new_id, $config_test->id());
$this->assertSame($new_id, $config_test->getOriginalId());
}
// Test config entity prepopulation.
\Drupal::state()->set('config_test.prepopulate', TRUE);
$config_test = $storage->create([
'foo' => 'bar',
]);
$this->assertEquals('baz', $config_test->get('foo'), 'Initial value correctly populated');
}
/**
* Tests CRUD operations through the UI.
*/
public function testCrudUi() {
$this->drupalLogin($this->drupalCreateUser([
'administer site configuration',
]));
$id = strtolower($this->randomMachineName());
$label1 = $this->randomMachineName();
$label2 = $this->randomMachineName();
$label3 = $this->randomMachineName();
$message_insert = "{$label1} configuration has been created.";
$message_update = "{$label2} configuration has been updated.";
$message_delete = "The test configuration {$label2} has been deleted.";
// Create a configuration entity.
$edit = [
'id' => $id,
'label' => $label1,
];
$this->drupalGet('admin/structure/config_test/add');
$this->submitForm($edit, 'Save');
$this->assertSession()
->addressEquals('admin/structure/config_test');
$this->assertSession()
->statusCodeEquals(200);
$this->assertSession()
->pageTextContains($message_insert);
$this->assertSession()
->pageTextNotContains($message_update);
$this->assertSession()
->linkByHrefExists("admin/structure/config_test/manage/{$id}");
// Update the configuration entity.
$edit = [
'label' => $label2,
];
$this->drupalGet("admin/structure/config_test/manage/{$id}");
$this->submitForm($edit, 'Save');
$this->assertSession()
->addressEquals('admin/structure/config_test');
$this->assertSession()
->statusCodeEquals(200);
$this->assertSession()
->pageTextNotContains($message_insert);
$this->assertSession()
->pageTextContains($message_update);
$this->assertSession()
->linkByHrefExists("admin/structure/config_test/manage/{$id}");
$this->assertSession()
->linkByHrefExists("admin/structure/config_test/manage/{$id}/delete");
// Delete the configuration entity.
$this->drupalGet("admin/structure/config_test/manage/{$id}");
$this->clickLink('Delete');
$this->assertSession()
->addressEquals("admin/structure/config_test/manage/{$id}/delete");
$this->submitForm([], 'Delete');
$this->assertSession()
->addressEquals('admin/structure/config_test');
$this->assertSession()
->statusCodeEquals(200);
$this->assertSession()
->pageTextNotContains($message_update);
$this->assertSession()
->pageTextContains($message_delete);
$this->assertSession()
->pageTextNotContains($label1);
$this->assertSession()
->linkByHrefNotExists("admin/structure/config_test/manage/{$id}");
// Re-create a configuration entity.
$edit = [
'id' => $id,
'label' => $label1,
];
$this->drupalGet('admin/structure/config_test/add');
$this->submitForm($edit, 'Save');
$this->assertSession()
->addressEquals('admin/structure/config_test');
$this->assertSession()
->statusCodeEquals(200);
$this->assertSession()
->pageTextContains($label1);
$this->assertSession()
->linkByHrefExists("admin/structure/config_test/manage/{$id}");
// Rename the configuration entity's ID/machine name.
$edit = [
'id' => strtolower($this->randomMachineName()),
'label' => $label3,
];
$this->drupalGet("admin/structure/config_test/manage/{$id}");
$this->submitForm($edit, 'Save');
$this->assertSession()
->addressEquals('admin/structure/config_test');
$this->assertSession()
->statusCodeEquals(200);
$this->assertSession()
->pageTextNotContains($label1);
$this->assertSession()
->pageTextNotContains($label2);
$this->assertSession()
->pageTextContains($label3);
$this->assertSession()
->linkByHrefNotExists("admin/structure/config_test/manage/{$id}");
$id = $edit['id'];
$this->assertSession()
->linkByHrefExists("admin/structure/config_test/manage/{$id}");
// Create a configuration entity with '0' machine name.
$edit = [
'id' => '0',
'label' => '0',
];
$this->drupalGet('admin/structure/config_test/add');
$this->submitForm($edit, 'Save');
$this->assertSession()
->statusCodeEquals(200);
$this->assertSession()
->pageTextContains('0 configuration has been created.');
$this->assertSession()
->linkByHrefExists('admin/structure/config_test/manage/0');
$this->assertSession()
->linkByHrefExists('admin/structure/config_test/manage/0/delete');
$this->drupalGet('admin/structure/config_test/manage/0/delete');
$this->submitForm([], 'Delete');
$storage = \Drupal::entityTypeManager()->getStorage('config_test');
$this->assertNull($storage->load(0), 'Test entity deleted');
// Create a configuration entity with a property that uses AJAX to show
// extra form elements. Test this scenario in a non-JS case by using a
// 'js-hidden' submit button.
// @see \Drupal\Tests\config\FunctionalJavascript\ConfigEntityTest::testAjaxOnAddPage()
$this->drupalGet('admin/structure/config_test/add');
$id = strtolower($this->randomMachineName());
$edit = [
'id' => $id,
'label' => $this->randomString(),
'size' => 'custom',
];
$this->assertSession()
->fieldExists('size');
$this->assertSession()
->fieldNotExists('size_value');
$this->submitForm($edit, 'Change size');
$this->assertSession()
->fieldExists('size');
$this->assertSession()
->fieldExists('size_value');
// Submit the form with the regular 'Save' button and check that the entity
// values are correct.
$edit += [
'size_value' => 'medium',
];
$this->submitForm($edit, 'Save');
$entity = $storage->load($id);
$this->assertEquals('custom', $entity->get('size'));
$this->assertEquals('medium', $entity->get('size_value'));
}
}
Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.