class FieldItemListTest
Same name in other branches
- 9 core/tests/Drupal/Tests/Core/Field/FieldItemListTest.php \Drupal\Tests\Core\Field\FieldItemListTest
- 8.9.x core/tests/Drupal/Tests/Core/Field/FieldItemListTest.php \Drupal\Tests\Core\Field\FieldItemListTest
- 10 core/tests/Drupal/Tests/Core/Field/FieldItemListTest.php \Drupal\Tests\Core\Field\FieldItemListTest
@coversDefaultClass \Drupal\Core\Field\FieldItemList @group Field
Hierarchy
- class \Drupal\Tests\UnitTestCase extends \PHPUnit\Framework\TestCase uses \Drupal\Tests\PhpUnitCompatibilityTrait, \Prophecy\PhpUnit\ProphecyTrait, \Drupal\TestTools\Extension\DeprecationBridge\ExpectDeprecationTrait, \Drupal\Tests\RandomGeneratorTrait
- class \Drupal\Tests\Core\Field\FieldItemListTest extends \Drupal\Tests\UnitTestCase
Expanded class hierarchy of FieldItemListTest
File
-
core/
tests/ Drupal/ Tests/ Core/ Field/ FieldItemListTest.php, line 21
Namespace
Drupal\Tests\Core\FieldView source
class FieldItemListTest extends UnitTestCase {
/**
* @covers ::equals
*
* @dataProvider providerTestEquals
*/
public function testEquals($expected, ?FieldItemInterface $first_field_item = NULL, ?FieldItemInterface $second_field_item = NULL) : void {
// Mock the field type manager and place it in the container.
$field_type_manager = $this->createMock('Drupal\\Core\\Field\\FieldTypePluginManagerInterface');
$container = new ContainerBuilder();
$container->set('plugin.manager.field.field_type', $field_type_manager);
\Drupal::setContainer($container);
// Set up three properties, one of them being computed.
$property_definitions['0'] = $this->createMock('Drupal\\Core\\TypedData\\DataDefinitionInterface');
$property_definitions['0']->expects($this->any())
->method('isComputed')
->willReturn(FALSE);
$property_definitions['1'] = $this->createMock('Drupal\\Core\\TypedData\\DataDefinitionInterface');
$property_definitions['1']->expects($this->any())
->method('isComputed')
->willReturn(FALSE);
$property_definitions['2'] = $this->createMock('Drupal\\Core\\TypedData\\DataDefinitionInterface');
$property_definitions['2']->expects($this->any())
->method('isComputed')
->willReturn(TRUE);
$field_storage_definition = $this->createMock('Drupal\\Core\\Field\\FieldStorageDefinitionInterface');
$field_storage_definition->expects($this->any())
->method('getPropertyDefinitions')
->willReturn($property_definitions);
$field_definition = $this->createMock('Drupal\\Core\\Field\\FieldDefinitionInterface');
$field_definition->expects($this->any())
->method('getFieldStorageDefinition')
->willReturn($field_storage_definition);
$field_list_a = new FieldItemList($field_definition);
$field_list_b = new FieldItemList($field_definition);
// Set up the mocking necessary for creating field items.
$field_type_manager->expects($this->any())
->method('createFieldItem')
->willReturnOnConsecutiveCalls($first_field_item, $second_field_item);
// Set the field item values.
if ($first_field_item instanceof FieldItemInterface) {
$field_list_a->setValue($first_field_item);
}
if ($second_field_item instanceof FieldItemInterface) {
$field_list_b->setValue($second_field_item);
}
$this->assertEquals($expected, $field_list_a->equals($field_list_b));
}
/**
* Data provider for testEquals.
*/
public static function providerTestEquals() {
// Tests field item lists with no values.
$datasets[] = [
TRUE,
];
/** @var \Drupal\Core\Field\FieldItemBase $field_item_a */
$field_item_a = new FieldItemTestClass();
$field_item_a->setValue([
1,
]);
// Tests field item lists where one has a value and one does not.
$datasets[] = [
FALSE,
$field_item_a,
];
// Tests field item lists where both have the same value.
$datasets[] = [
TRUE,
$field_item_a,
$field_item_a,
];
/** @var \Drupal\Core\Field\FieldItemBase $fv */
$field_item_b = new FieldItemTestClass();
$field_item_b->setValue([
2,
]);
// Tests field item lists where both have the different values.
$datasets[] = [
FALSE,
$field_item_a,
$field_item_b,
];
/** @var \Drupal\Core\Field\FieldItemBase $fv */
$field_item_c = new FieldItemTestClass();
$field_item_c->setValue([
'0' => 1,
'1' => 2,
]);
$field_item_d = new FieldItemTestClass();
$field_item_d->setValue([
'1' => 2,
'0' => 1,
]);
// Tests field item lists where both have the differently ordered values.
$datasets[] = [
TRUE,
$field_item_c,
$field_item_d,
];
/** @var \Drupal\Core\Field\FieldItemBase $field_item_e */
$field_item_e = new FieldItemTestClass();
$field_item_e->setValue([
'2',
]);
// Tests field item lists where both have same values but different data
// types.
$datasets[] = [
TRUE,
$field_item_b,
$field_item_e,
];
/** @var \Drupal\Core\Field\FieldItemBase $field_item_f */
$field_item_f = new FieldItemTestClass();
$field_item_f->setValue([
'0' => 1,
'1' => 2,
'2' => 3,
]);
/** @var \Drupal\Core\Field\FieldItemBase $field_item_g */
$field_item_g = new FieldItemTestClass();
$field_item_g->setValue([
'0' => 1,
'1' => 2,
'2' => 4,
]);
// Tests field item lists where both have same values for the non-computed
// properties ('0' and '1') and a different value for the computed one
// ('2').
$datasets[] = [
TRUE,
$field_item_f,
$field_item_g,
];
/** @var \Drupal\Core\Field\FieldItemBase $field_item_h */
$field_item_h = new FieldItemTestClass();
$field_item_h->setValue([
'0' => 1,
'1' => 2,
'3' => 3,
]);
/** @var \Drupal\Core\Field\FieldItemBase $field_item_i */
$field_item_i = new FieldItemTestClass();
$field_item_i->setValue([
'0' => 1,
'1' => 2,
'3' => 4,
]);
// Tests field item lists where both have same values for the non-computed
// properties ('0' and '1') and a different value for a property that does
// not exist ('3').
$datasets[] = [
TRUE,
$field_item_h,
$field_item_i,
];
/** @var \Drupal\Core\Field\FieldItemBase $field_item_j */
$field_item_j = new FieldItemTestClass();
$field_item_j->setValue([
'0' => 1,
]);
/** @var \Drupal\Core\Field\FieldItemBase $field_item_k */
$field_item_k = new FieldItemTestClass();
$field_item_k->setValue([
'0' => 1,
'1' => NULL,
]);
/** @var \Drupal\Core\Field\FieldItemBase $field_item_l */
$field_item_l = new FieldItemTestClass();
$field_item_l->setValue([
'0' => 1,
'1' => FALSE,
]);
/** @var \Drupal\Core\Field\FieldItemBase $field_item_m */
$field_item_m = new FieldItemTestClass();
$field_item_m->setValue([
'0' => 1,
'1' => '',
]);
// Tests filter properties with a NULL value. Empty strings or other false-y
// values are not filtered.
$datasets[] = [
TRUE,
$field_item_j,
$field_item_k,
];
$datasets[] = [
FALSE,
$field_item_j,
$field_item_l,
];
$datasets[] = [
FALSE,
$field_item_j,
$field_item_m,
];
return $datasets;
}
/**
* Tests identical behavior of ::hasAffectingChanges with ::equals.
*
* @covers ::hasAffectingChanges
*
* @dataProvider providerTestEquals
*/
public function testHasAffectingChanges($expected, ?FieldItemInterface $first_field_item = NULL, ?FieldItemInterface $second_field_item = NULL) : void {
// Mock the field type manager and place it in the container.
$field_type_manager = $this->createMock(FieldTypePluginManagerInterface::class);
$container = new ContainerBuilder();
$container->set('plugin.manager.field.field_type', $field_type_manager);
\Drupal::setContainer($container);
$field_storage_definition = $this->createMock(FieldStorageDefinitionInterface::class);
$field_storage_definition->expects($this->any())
->method('getColumns')
->willReturn([
0 => '0',
1 => '1',
]);
// Set up three properties, one of them being computed.
$property_definitions['0'] = $this->createMock('Drupal\\Core\\TypedData\\DataDefinitionInterface');
$property_definitions['0']->expects($this->any())
->method('isComputed')
->willReturn(FALSE);
$property_definitions['1'] = $this->createMock('Drupal\\Core\\TypedData\\DataDefinitionInterface');
$property_definitions['1']->expects($this->any())
->method('isComputed')
->willReturn(FALSE);
$property_definitions['2'] = $this->createMock('Drupal\\Core\\TypedData\\DataDefinitionInterface');
$property_definitions['2']->expects($this->any())
->method('isComputed')
->willReturn(TRUE);
$field_storage_definition = $this->createMock('Drupal\\Core\\Field\\FieldStorageDefinitionInterface');
$field_storage_definition->expects($this->any())
->method('getPropertyDefinitions')
->willReturn($property_definitions);
$field_definition = $this->createMock(FieldDefinitionInterface::class);
$field_definition->expects($this->any())
->method('getFieldStorageDefinition')
->willReturn($field_storage_definition);
$field_definition->expects($this->any())
->method('isComputed')
->willReturn(FALSE);
$field_list_a = new FieldItemList($field_definition);
$field_list_b = new FieldItemList($field_definition);
// Set up the mocking necessary for creating field items.
$field_type_manager->expects($this->any())
->method('createFieldItem')
->willReturnOnConsecutiveCalls($first_field_item, $second_field_item);
// Set the field item values.
if ($first_field_item instanceof FieldItemInterface) {
$field_list_a->setValue($first_field_item);
}
if ($second_field_item instanceof FieldItemInterface) {
$field_list_b->setValue($second_field_item);
}
$this->assertEquals($expected, !$field_list_a->hasAffectingChanges($field_list_b, ''));
}
/**
* @covers ::equals
*/
public function testEqualsEmptyItems() : void {
/** @var \Drupal\Core\Field\FieldItemBase $fv */
$first_field_item = new FieldItemTestClass();
$first_field_item->setValue([
'0' => 1,
'1' => 2,
]);
$second_field_item = new FieldItemTestClass();
$second_field_item->setValue([
'1' => 2,
'0' => 1,
]);
$empty_field_item = new FieldItemTestClass();
// Mock the field type manager and place it in the container.
$field_type_manager = $this->createMock('Drupal\\Core\\Field\\FieldTypePluginManagerInterface');
$container = new ContainerBuilder();
$container->set('plugin.manager.field.field_type', $field_type_manager);
\Drupal::setContainer($container);
// Set up the properties of the field item.
$property_definitions['0'] = $this->createMock('Drupal\\Core\\TypedData\\DataDefinitionInterface');
$property_definitions['0']->expects($this->any())
->method('isComputed')
->willReturn(FALSE);
$property_definitions['1'] = $this->createMock('Drupal\\Core\\TypedData\\DataDefinitionInterface');
$property_definitions['1']->expects($this->any())
->method('isComputed')
->willReturn(FALSE);
$field_storage_definition = $this->createMock('Drupal\\Core\\Field\\FieldStorageDefinitionInterface');
$field_storage_definition->expects($this->any())
->method('getPropertyDefinitions')
->willReturn($property_definitions);
$field_definition = $this->createMock('Drupal\\Core\\Field\\FieldDefinitionInterface');
$field_definition->expects($this->any())
->method('getFieldStorageDefinition')
->willReturn($field_storage_definition);
$field_list_a = new FieldItemList($field_definition);
$field_list_b = new FieldItemList($field_definition);
// Set up the mocking necessary for creating field items.
$field_type_manager->expects($this->any())
->method('createFieldItem')
->willReturnOnConsecutiveCalls($first_field_item, $second_field_item, $empty_field_item, $empty_field_item);
// Set the field item values.
$field_list_a->setValue($first_field_item);
$field_list_b->setValue($second_field_item);
$field_list_a->appendItem($empty_field_item);
// Field list A has an empty item.
$this->assertEquals(FALSE, $field_list_a->equals($field_list_b));
// Field lists A and B have empty items.
$field_list_b->appendItem($empty_field_item);
$this->assertEquals(TRUE, $field_list_a->equals($field_list_b));
// Field list B has an empty item.
$field_list_a->filterEmptyItems();
$this->assertEquals(FALSE, $field_list_a->equals($field_list_b));
// Neither field lists A and B have empty items.
$field_list_b->filterEmptyItems();
$this->assertEquals(TRUE, $field_list_a->equals($field_list_b));
}
/**
* @covers ::defaultValuesForm
*/
public function testDefaultValuesForm() : void {
$field_definition = $this->createMock(FieldDefinitionInterface::class);
$field_definition->expects($this->any())
->method('getType')
->willReturn('field_type');
/** @var \Drupal\Core\Field\FieldItemList|\PHPUnit\Framework\MockObject\MockObject $field_list */
$field_list = $this->getMockBuilder(FieldItemList::class)
->onlyMethods([
'defaultValueWidget',
])
->setConstructorArgs([
$field_definition,
])
->getMock();
$field_list->expects($this->any())
->method('defaultValueWidget')
->willReturn(NULL);
$form = [];
$form_state = new FormState();
$string_translation = $this->getStringTranslationStub();
$field_list->setStringTranslation($string_translation);
$this->assertEquals('No widget available for: <em class="placeholder">field_type</em>.', $field_list->defaultValuesForm($form, $form_state)['#markup']);
}
/**
* @covers ::defaultValuesFormValidate
*/
public function testDefaultValuesFormValidate() : void {
$field_definition = $this->createMock(FieldDefinitionInterface::class);
/** @var \Drupal\Core\Field\FieldItemList|\PHPUnit\Framework\MockObject\MockObject $field_list */
$field_list = $this->getMockBuilder(FieldItemList::class)
->onlyMethods([
'defaultValueWidget',
'validate',
])
->setConstructorArgs([
$field_definition,
])
->getMock();
$field_list->expects($this->any())
->method('defaultValueWidget')
->willReturn(NULL);
$field_list->expects($this->never())
->method('validate');
$form = [];
$form_state = new FormState();
$field_list->defaultValuesFormValidate([], $form, $form_state);
}
/**
* @covers ::defaultValuesFormSubmit
*/
public function testDefaultValuesFormSubmit() : void {
$field_definition = $this->createMock(FieldDefinitionInterface::class);
/** @var \Drupal\Core\Field\FieldItemList|\PHPUnit\Framework\MockObject\MockObject $field_list */
$field_list = $this->getMockBuilder(FieldItemList::class)
->onlyMethods([
'defaultValueWidget',
'getValue',
])
->setConstructorArgs([
$field_definition,
])
->getMock();
$field_list->expects($this->any())
->method('defaultValueWidget')
->willReturn(NULL);
$form = [];
$form_state = new FormState();
$field_list->expects($this->never())
->method('getValue');
$this->assertSame([], $field_list->defaultValuesFormSubmit([], $form, $form_state));
}
}
Members
Title Sort descending | Modifiers | Object type | Summary | Overrides |
---|---|---|---|---|
ExpectDeprecationTrait::expectDeprecation | public | function | Adds an expected deprecation. | |
ExpectDeprecationTrait::getCallableName | private static | function | Returns a callable as a string suitable for inclusion in a message. | |
ExpectDeprecationTrait::setUpErrorHandler | public | function | Sets up the test error handler. | |
ExpectDeprecationTrait::tearDownErrorHandler | public | function | Tears down the test error handler. | |
FieldItemListTest::providerTestEquals | public static | function | Data provider for testEquals. | |
FieldItemListTest::testDefaultValuesForm | public | function | @covers ::defaultValuesForm | |
FieldItemListTest::testDefaultValuesFormSubmit | public | function | @covers ::defaultValuesFormSubmit | |
FieldItemListTest::testDefaultValuesFormValidate | public | function | @covers ::defaultValuesFormValidate | |
FieldItemListTest::testEquals | public | function | @covers ::equals | |
FieldItemListTest::testEqualsEmptyItems | public | function | @covers ::equals | |
FieldItemListTest::testHasAffectingChanges | public | function | Tests identical behavior of ::hasAffectingChanges with ::equals. | |
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. | |
UnitTestCase::$root | protected | property | The app root. | |
UnitTestCase::getClassResolverStub | protected | function | Returns a stub class resolver. | |
UnitTestCase::getConfigFactoryStub | public | function | Returns a stub config factory that behaves according to the passed array. | |
UnitTestCase::getConfigStorageStub | public | function | Returns a stub config storage that returns the supplied configuration. | |
UnitTestCase::getContainerWithCacheTagsInvalidator | protected | function | Sets up a container with a cache tags invalidator. | |
UnitTestCase::getStringTranslationStub | public | function | Returns a stub translation manager that just returns the passed string. | |
UnitTestCase::setUp | protected | function | 367 | |
UnitTestCase::setUpBeforeClass | public static | function |
Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.