AbstractFormElementTest.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
/*
 * This file is part of the TYPO3 CMS project.
 *
 * It is free software; you can redistribute it and/or modify it under
 * the terms of the GNU General Public License, either version 2
 * of the License, or any later version.
 *
 * For the full copyright and license information, please read the
 * LICENSE.txt file that was distributed with this source code.
 *
 * The TYPO3 project - inspiring people to share!
 */
 
namespace ‪TYPO3\CMS\Form\Tests\Unit\Domain\FormElements;
 
use ‪TYPO3\CMS\Core\Utility\GeneralUtility;
use ‪TYPO3\CMS\Form\Domain\Exception\IdentifierNotValidException;
use ‪TYPO3\CMS\Form\Domain\Model\FormDefinition;
use ‪TYPO3\CMS\Form\Domain\Model\FormElements\AbstractFormElement;
use ‪TYPO3\CMS\Form\Domain\Model\FormElements\GenericFormElement;
use TYPO3\TestingFramework\Core\Unit\UnitTestCase;
 
class ‪AbstractFormElementTest extends UnitTestCase
{
    public function ‪newInstanceHasNoProperties(): void
    {
        $subject = $this->getMockForAbstractClass(AbstractFormElement::class, ['an_id', 'a_type']);
        self::assertNotNull($subject);
        self::assertCount(0, $subject->getProperties());
    }
 
    public function ‪setSimpleProperties(): void
    {
        $subject = $this->getMockForAbstractClass(AbstractFormElement::class, ['an_id', 'a_type']);
 
        $subject->setProperty('foo', 'bar');
        $subject->setProperty('buz', 'qax');
        $properties = $subject->getProperties();
 
        self::assertCount(2, $properties);
        self::assertArrayHasKey('foo', $properties);
        self::assertEquals('bar', $properties['foo']);
        self::assertArrayHasKey('buz', $properties);
        self::assertEquals('qax', $properties['buz']);
    }
 
    public function ‪overrideProperties(): void
    {
        $subject = $this->getMockForAbstractClass(AbstractFormElement::class, ['an_id', 'a_type']);
 
        $subject->setProperty('foo', 'bar');
        $subject->setProperty('foo', 'buz');
 
        $properties = $subject->getProperties();
        self::assertCount(1, $properties);
        self::assertArrayHasKey('foo', $properties);
        self::assertEquals('buz', $properties['foo']);
    }
 
    public function ‪setArrayProperties(): void
    {
        $subject = $this->getMockForAbstractClass(AbstractFormElement::class, ['an_id', 'a_type']);
 
        $subject->setProperty('foo', ['bar' => 'baz', 'bla' => 'blubb']);
        $properties = $subject->getProperties();
 
        self::assertCount(1, $properties);
        self::assertArrayHasKey('foo', $properties);
 
        //check arrays details
        self::assertIsArray($properties['foo']);
        self::assertCount(2, $properties['foo']);
        self::assertArrayHasKey('bar', $properties['foo']);
        self::assertEquals('baz', $properties['foo']['bar']);
    }
 
    public function ‪setPropertyUnsetIfValueIsNull(): void
    {
        $subject = $this->getMockForAbstractClass(AbstractFormElement::class, ['an_id', 'a_type']);
 
        $expected = ['foo-1' => ['bar-1' => 'foo-2']];
        $subject->setProperty('foo-1', ['bar-1' => 'foo-2']);
        $subject->setProperty('foo-2', ['bar-2' => 'foo-3']);
        $subject->setProperty('foo-2', null);
 
        self::assertSame($expected, $subject->getProperties());
    }
 
    public function ‪setPropertyUnsetIfValueIsArrayWithSomeNullVales(): void
    {
        $subject = $this->getMockForAbstractClass(AbstractFormElement::class, ['an_id', 'a_type']);
 
        $expected = [
            'foo-1' => [
                'bar-1' => 'foo-2',
            ],
            'foo-2' => [
                'bar-2' => 'foo-3',
            ],
        ];
        $subject->setProperty('foo-1', ['bar-1' => 'foo-2']);
        $subject->setProperty('foo-2', ['bar-2' => 'foo-3', 'bar-3' => 'foo-4']);
        $subject->setProperty('foo-2', ['bar-3' => null]);
 
        self::assertSame($expected, $subject->getProperties());
    }
 
    public function ‪constructThrowsExceptionWhenIdentifierIsEmpty(): void
    {
        $this->expectException(IdentifierNotValidException::class);
        $this->expectExceptionCode(1477082502);
 
        // GenericFormElement inherits from AbstractFormElement and serves as concrete implementation
        new ‪GenericFormElement('', 'a_type');
    }
 
    public function ‪constructMustNotThrowExceptionWhenIdentifierIsNonEmptyString(): void
    {
        $mock = $this->getMockForAbstractClass(
            AbstractFormElement::class,
            ['is_in', 'a_type'],
            '',
            true,
            true,
            true,
            []
        );
        self::assertInstanceOf(AbstractFormElement::class, $mock);
    }
 
    public function ‪initializeFormElementExpectedCallInitializeFormObjectHooks(): void
    {
        $abstractFormElementMock = $this->getMockForAbstractClass(
            AbstractFormElement::class,
            [],
            '',
            false,
            false,
            true,
            []
        );
        $secondMock = $this->getMockForAbstractClass(
            AbstractFormElement::class,
            [],
            '',
            false,
            false,
            true,
            [
                'initializeFormElement',
            ]
        );
 
        $secondMock->
        expects(self::once())
            ->method('initializeFormElement')
            ->with($abstractFormElementMock);
 
        GeneralUtility::addInstance(\get_class($secondMock), $secondMock);
 
        ‪$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['ext/form']['initializeFormElement'] = [
            \get_class($secondMock),
        ];
 
        $abstractFormElementMock->initializeFormElement();
    }
 
    public function ‪getUniqueIdentifierExpectedUnique(): void
    {
        $abstractFormElementMock1 = $this->getMockForAbstractClass(
            AbstractFormElement::class,
            [],
            '',
            false,
            false,
            true,
            [
                'getRootForm',
            ]
        );
 
        $abstractFormElementMock2 = $this->getMockForAbstractClass(
            AbstractFormElement::class,
            [],
            '',
            false,
            false,
            true,
            [
                'getRootForm',
            ]
        );
 
        $formDefinition1 = $this->createMock(FormDefinition::class);
        $formDefinition1
            ->method('getIdentifier')
            ->willReturn('c');
 
        $abstractFormElementMock1
            ->method('getRootForm')
            ->willReturn($formDefinition1);
 
        $formDefinition2 = $this->createMock(FormDefinition::class);
        $formDefinition2
            ->method('getIdentifier')
            ->willReturn('d');
 
        $abstractFormElementMock2
            ->method('getRootForm')
            ->willReturn($formDefinition2);
 
        self::assertNotSame(
            $abstractFormElementMock1->getUniqueIdentifier(),
            $abstractFormElementMock2->getUniqueIdentifier()
        );
    }
 
    public function ‪setDefaultValueSetStringValueIfKeyDoesNotExists(): void
    {
        $formDefinitionMock = $this->getAccessibleMock(FormDefinition::class, [
            'dummy',
        ], [], '', false);
 
        $abstractFormElementMock = $this->getMockForAbstractClass(
            AbstractFormElement::class,
            ['is_in', 'a_type'],
            '',
            true,
            true,
            true,
            ['getRootForm']
        );
 
        $abstractFormElementMock
            ->method('getRootForm')
            ->willReturn($formDefinitionMock);
 
        $input = 'foo';
        $expected = 'foo';
 
        $abstractFormElementMock->setDefaultValue($input);
 
        self::assertSame($expected, $abstractFormElementMock->getDefaultValue());
    }
 
    public function ‪setDefaultValueSetArrayValueIfKeyDoesNotExists(): void
    {
        $formDefinitionMock = $this->getAccessibleMock(FormDefinition::class, [
            'dummy',
        ], [], '', false);
 
        $abstractFormElementMock = $this->getMockForAbstractClass(
            AbstractFormElement::class,
            ['is_in', 'a_type'],
            '',
            true,
            true,
            true,
            ['getRootForm']
        );
 
        $abstractFormElementMock
            ->method('getRootForm')
            ->willReturn($formDefinitionMock);
 
        $input = ['foo' => 'bar'];
        $expected = ['foo' => 'bar'];
 
        $abstractFormElementMock->setDefaultValue($input);
 
        self::assertSame($expected, $abstractFormElementMock->getDefaultValue());
    }
 
    public function ‪setDefaultValueUnsetIfValueIsArrayWithSomeNullVales(): void
    {
        $formDefinitionMock = $this->getAccessibleMock(FormDefinition::class, [
            'dummy',
        ], [], '', false);
 
        $abstractFormElementMock = $this->getMockForAbstractClass(
            AbstractFormElement::class,
            ['is_in', 'a_type'],
            '',
            true,
            true,
            true,
            ['getRootForm']
        );
 
        $abstractFormElementMock
            ->method('getRootForm')
            ->willReturn($formDefinitionMock);
 
        $input1 = [
            'foo-1' => [
                'bar-1' => 'foo-2',
            ],
            'foo-2' => [
                'bar-2' => 'foo-3',
                'bar-3' => 'foo-4',
            ],
        ];
 
        $input2 = [
            'foo-2' => [
                'bar-3' => null,
            ],
        ];
 
        $expected = [
            'foo-1' => [
                'bar-1' => 'foo-2',
            ],
            'foo-2' => [
                'bar-2' => 'foo-3',
            ],
        ];
 
        $abstractFormElementMock->setDefaultValue($input1);
        $abstractFormElementMock->setDefaultValue($input2);
 
        self::assertSame($expected, $abstractFormElementMock->getDefaultValue());
    }
 
    public function ‪setDefaultValueAddValueIfValueIsArray(): void
    {
        $formDefinitionMock = $this->getAccessibleMock(FormDefinition::class, [
            'dummy',
        ], [], '', false);
 
        $abstractFormElementMock = $this->getMockForAbstractClass(
            AbstractFormElement::class,
            ['is_in', 'a_type'],
            '',
            true,
            true,
            true,
            ['getRootForm']
        );
 
        $abstractFormElementMock
            ->method('getRootForm')
            ->willReturn($formDefinitionMock);
 
        $input1 = [
            'foo-1' => [
                'bar-1' => 'foo-2',
            ],
            'foo-2' => [
                'bar-2' => 'foo-3',
            ],
        ];
 
        $input2 = [
            'foo-2' => [
                'bar-3' => 'foo-4',
            ],
        ];
 
        $expected = [
            'foo-1' => [
                'bar-1' => 'foo-2',
            ],
            'foo-2' => [
                'bar-2' => 'foo-3',
                'bar-3' => 'foo-4',
            ],
        ];
 
        $abstractFormElementMock->setDefaultValue($input1);
        $abstractFormElementMock->setDefaultValue($input2);
 
        self::assertSame($expected, $abstractFormElementMock->getDefaultValue());
    }
}