IconRegistryTest.php

Go to the documentation of this file.

<?php
 
/*
 * 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\Core\Tests\Unit\Imaging;
 
use Prophecy\Argument;
use ‪TYPO3\CMS\Core\Cache\CacheManager;
use ‪TYPO3\CMS\Core\Cache\Frontend\FrontendInterface;
use ‪TYPO3\CMS\Core\Exception;
use ‪TYPO3\CMS\Core\Imaging\IconProvider\FontawesomeIconProvider;
use ‪TYPO3\CMS\Core\Imaging\IconProviderInterface;
use ‪TYPO3\CMS\Core\Imaging\IconRegistry;
use ‪TYPO3\CMS\Core\Utility\GeneralUtility;
use TYPO3\TestingFramework\Core\Unit\UnitTestCase;
 
class ‪IconRegistryTest extends UnitTestCase
{
    protected ‪$notRegisteredIconIdentifier = 'my-super-unregistered-identifier';
 
    public function ‪setUp(): void
    {
        parent::setUp();
        $cacheManagerProphecy = $this->prophesize(CacheManager::class);
        GeneralUtility::setSingletonInstance(CacheManager::class, $cacheManagerProphecy->reveal());
        $cacheFrontendProphecy = $this->prophesize(FrontendInterface::class);
        $cacheManagerProphecy->getCache('assets')->willReturn($cacheFrontendProphecy->reveal());
        $cacheFrontendProphecy->get(Argument::cetera())->willReturn(false);
        $cacheFrontendProphecy->set(Argument::cetera())->willReturn(null);
    }
 
    public function ‪tearDown(): void
    {
        // Drop cache manager singleton again
        GeneralUtility::purgeInstances();
        parent::tearDown();
    }
 
    public function ‪getDefaultIconIdentifierReturnsTheCorrectDefaultIconIdentifierString()
    {
        $result = (new ‪IconRegistry())->getDefaultIconIdentifier();
        self::assertEquals($result, 'default-not-found');
    }
 
    public function ‪isRegisteredReturnsTrueForRegisteredIcon()
    {
        $subject = new IconRegistry();
        $result = $subject->isRegistered($subject->getDefaultIconIdentifier());
        self::assertEquals($result, true);
    }
 
    public function ‪isRegisteredReturnsFalseForNotRegisteredIcon()
    {
        $result = (new IconRegistry())->isRegistered($this->notRegisteredIconIdentifier);
        self::assertEquals($result, false);
    }
 
    public function ‪registerIconAddNewIconToRegistry()
    {
        $unregisteredIcon = 'foo-bar-unregistered';
        $subject = new IconRegistry();
        self::assertFalse($subject->isRegistered($unregisteredIcon));
        $subject->registerIcon($unregisteredIcon, FontawesomeIconProvider::class, [
            'name' => 'pencil',
            'additionalClasses' => 'fa-fw'
        ]);
        self::assertTrue($subject->isRegistered($unregisteredIcon));
    }
 
    public function ‪registerIconThrowsInvalidArgumentExceptionWithInvalidIconProvider()
    {
        $this->expectException(\InvalidArgumentException::class);
        $this->expectExceptionCode(1437425803);
 
        (new IconRegistry())->registerIcon($this->notRegisteredIconIdentifier, GeneralUtility::class);
    }
 
    public function ‪getIconConfigurationByIdentifierThrowsExceptionWithUnregisteredIconIdentifier()
    {
        $this->expectException(Exception::class);
        $this->expectExceptionCode(1437425804);
 
        (new IconRegistry())->getIconConfigurationByIdentifier($this->notRegisteredIconIdentifier);
    }
 
    public function ‪getIconConfigurationByIdentifierReturnsCorrectConfiguration()
    {
        $result = (new IconRegistry())->getIconConfigurationByIdentifier('default-not-found');
        // result must contain at least provider and options array
        self::assertArrayHasKey('provider', $result);
        self::assertArrayHasKey('options', $result);
        // the provider must implement the IconProviderInterface
        self::assertTrue(in_array(IconProviderInterface::class, class_implements($result['provider'])));
    }
 
    public function ‪getAllRegisteredIconIdentifiersReturnsAnArrayWithIconIdentifiers()
    {
        self::assertIsArray((new IconRegistry())->getAllRegisteredIconIdentifiers());
    }
 
    public function ‪getAllRegisteredIconIdentifiersReturnsArrayWithAllRegisteredIconIdentifiers()
    {
        $result = (new IconRegistry())->getAllRegisteredIconIdentifiers();
        self::assertIsArray($result);
        self::assertContains('default-not-found', $result);
    }
 
    public function ‪getIconIdentifierForFileExtensionReturnsDefaultIconIdentifierForEmptyFileExtension()
    {
        $result = (new IconRegistry())->getIconIdentifierForFileExtension('');
        self::assertEquals('mimetypes-other-other', $result);
    }
 
    public function ‪getIconIdentifierForFileExtensionReturnsDefaultIconIdentifierForUnknownFileExtension()
    {
        $result = (new IconRegistry())->getIconIdentifierForFileExtension('xyz');
        self::assertEquals('mimetypes-other-other', $result);
    }
 
    public function ‪getIconIdentifierForFileExtensionReturnsImageIconIdentifierForImageFileExtension()
    {
        $result = (new IconRegistry())->getIconIdentifierForFileExtension('jpg');
        self::assertEquals('mimetypes-media-image', $result);
    }
 
    public function ‪registerFileExtensionRegisterAnIcon()
    {
        $subject = new IconRegistry();
        $subject->registerFileExtension('abc', 'xyz');
        $result = $subject->getIconIdentifierForFileExtension('abc');
        self::assertEquals('xyz', $result);
    }
 
    public function ‪registerFileExtensionOverwriteAnExistingIcon()
    {
        $subject = new IconRegistry();
        $subject->registerFileExtension('jpg', 'xyz');
        $result = $subject->getIconIdentifierForFileExtension('jpg');
        self::assertEquals('xyz', $result);
    }
 
    public function ‪registerMimeTypeIconRegisterAnIcon()
    {
        $subject = new IconRegistry();
        $subject->registerMimeTypeIcon('foo/bar', 'mimetype-foo-bar');
        $result = $subject->getIconIdentifierForMimeType('foo/bar');
        self::assertEquals('mimetype-foo-bar', $result);
    }
 
    public function ‪registerMimeTypeIconOverwriteAnExistingIcon()
    {
        $subject = new IconRegistry();
        $subject->registerMimeTypeIcon('video/*', 'mimetype-foo-bar');
        $result = $subject->getIconIdentifierForMimeType('video/*');
        self::assertEquals('mimetype-foo-bar', $result);
    }
 
    public function ‪getIconIdentifierForMimeTypeWithUnknownMimeTypeReturnNull()
    {
        $result = (new IconRegistry())->getIconIdentifierForMimeType('bar/foo');
        self::assertNull($result);
    }
}