class TokenTest

Same name in this branch
  1. 10 core/tests/Drupal/Tests/Core/Render/Element/TokenTest.php \Drupal\Tests\Core\Render\Element\TokenTest
Same name in other branches
  1. 9 core/tests/Drupal/Tests/Core/Render/Element/TokenTest.php \Drupal\Tests\Core\Render\Element\TokenTest
  2. 9 core/tests/Drupal/Tests/Core/Utility/TokenTest.php \Drupal\Tests\Core\Utility\TokenTest
  3. 8.9.x core/tests/Drupal/Tests/Core/Render/Element/TokenTest.php \Drupal\Tests\Core\Render\Element\TokenTest
  4. 8.9.x core/tests/Drupal/Tests/Core/Utility/TokenTest.php \Drupal\Tests\Core\Utility\TokenTest
  5. 11.x core/tests/Drupal/Tests/Core/Render/Element/TokenTest.php \Drupal\Tests\Core\Render\Element\TokenTest
  6. 11.x core/tests/Drupal/Tests/Core/Utility/TokenTest.php \Drupal\Tests\Core\Utility\TokenTest

@coversDefaultClass \Drupal\Core\Utility\Token @group Utility

Hierarchy

Expanded class hierarchy of TokenTest

File

core/tests/Drupal/Tests/Core/Utility/TokenTest.php, line 20

Namespace

Drupal\Tests\Core\Utility
View source
class TokenTest extends UnitTestCase {
    
    /**
     * The cache used for testing.
     *
     * @var \Drupal\Core\Cache\CacheBackendInterface|\PHPUnit\Framework\MockObject\MockObject
     */
    protected $cache;
    
    /**
     * The language manager used for testing.
     *
     * @var \Drupal\Core\Language\LanguageManagerInterface|\PHPUnit\Framework\MockObject\MockObject
     */
    protected $languageManager;
    
    /**
     * The module handler service used for testing.
     *
     * @var \Drupal\Core\Extension\ModuleHandlerInterface|\PHPUnit\Framework\MockObject\MockObject
     */
    protected $moduleHandler;
    
    /**
     * The language interface used for testing.
     *
     * @var \Drupal\Core\Language\LanguageInterface|\PHPUnit\Framework\MockObject\MockObject
     */
    protected $language;
    
    /**
     * The token service under test.
     *
     * @var \Drupal\Core\Utility\Token|\PHPUnit\Framework\MockObject\MockObject
     */
    protected $token;
    
    /**
     * The cache tags invalidator.
     *
     * @var \Drupal\Core\Cache\CacheTagsInvalidatorInterface|\PHPUnit\Framework\MockObject\MockObject
     */
    protected $cacheTagsInvalidator;
    
    /**
     * The cache contexts manager.
     *
     * @var \Drupal\Core\Cache\Context\CacheContextsManager
     */
    protected $cacheContextManager;
    
    /**
     * The renderer.
     *
     * @var \Drupal\Core\Render\RendererInterface|\PHPUnit\Framework\MockObject\MockObject
     */
    protected $renderer;
    
    /**
     * {@inheritdoc}
     */
    protected function setUp() : void {
        parent::setUp();
        $this->cache = $this->createMock('\\Drupal\\Core\\Cache\\CacheBackendInterface');
        $this->languageManager = $this->createMock('Drupal\\Core\\Language\\LanguageManagerInterface');
        $this->moduleHandler = $this->createMock('\\Drupal\\Core\\Extension\\ModuleHandlerInterface');
        $this->language = $this->createMock('\\Drupal\\Core\\Language\\LanguageInterface');
        $this->cacheTagsInvalidator = $this->createMock('\\Drupal\\Core\\Cache\\CacheTagsInvalidatorInterface');
        $this->renderer = $this->createMock('Drupal\\Core\\Render\\RendererInterface');
        $this->token = new Token($this->moduleHandler, $this->cache, $this->languageManager, $this->cacheTagsInvalidator, $this->renderer);
        $container = new ContainerBuilder();
        $this->cacheContextManager = new CacheContextsManager($container, [
            'current_user',
            'custom_context',
        ]);
        $container->set('cache_contexts_manager', $this->cacheContextManager);
        \Drupal::setContainer($container);
    }
    
    /**
     * @covers ::getInfo
     */
    public function testGetInfo() : void {
        $token_info = [
            'types' => [
                'foo' => [
                    'name' => $this->randomMachineName(),
                ],
            ],
        ];
        $this->language
            ->expects($this->atLeastOnce())
            ->method('getId')
            ->willReturn($this->randomMachineName());
        $this->languageManager
            ->expects($this->once())
            ->method('getCurrentLanguage')
            ->with(LanguageInterface::TYPE_CONTENT)
            ->willReturn($this->language);
        // The persistent cache must only be hit once, after which the info is
        // cached statically.
        $this->cache
            ->expects($this->once())
            ->method('get');
        $this->cache
            ->expects($this->once())
            ->method('set')
            ->with('token_info:' . $this->language
            ->getId(), $token_info);
        $this->moduleHandler
            ->expects($this->once())
            ->method('invokeAll')
            ->with('token_info')
            ->willReturn($token_info);
        $this->moduleHandler
            ->expects($this->once())
            ->method('alter')
            ->with('token_info', $token_info);
        // Get the information for the first time. The cache should be checked, the
        // hooks invoked, and the info should be set to the cache should.
        $this->token
            ->getInfo();
        // Get the information for the second time. The data must be returned from
        // the static cache, so the persistent cache must not be accessed and the
        // hooks must not be invoked.
        $this->token
            ->getInfo();
    }
    
    /**
     * @covers ::replace
     */
    public function testReplaceWithBubbleableMetadataObject() : void {
        $this->moduleHandler
            ->expects($this->any())
            ->method('invokeAll')
            ->willReturn([
            '[node:title]' => 'hello world',
        ]);
        $bubbleable_metadata = new BubbleableMetadata();
        $bubbleable_metadata->setCacheContexts([
            'current_user',
        ]);
        $bubbleable_metadata->setCacheMaxAge(12);
        $node = $this->prophesize('Drupal\\node\\NodeInterface');
        $node->getCacheTags()
            ->willReturn([
            'node:1',
        ]);
        $node->getCacheContexts()
            ->willReturn([
            'custom_context',
        ]);
        $node->getCacheMaxAge()
            ->willReturn(10);
        $node = $node->reveal();
        $result = $this->token
            ->replace('[node:title]', [
            'node' => $node,
        ], [], $bubbleable_metadata);
        $this->assertEquals('hello world', $result);
        $this->assertEquals([
            'node:1',
        ], $bubbleable_metadata->getCacheTags());
        $this->assertEquals([
            'current_user',
            'custom_context',
        ], $bubbleable_metadata->getCacheContexts());
        $this->assertEquals(10, $bubbleable_metadata->getCacheMaxAge());
    }
    
    /**
     * @covers ::replace
     */
    public function testReplaceWithHookTokensWithBubbleableMetadata() : void {
        $this->moduleHandler
            ->expects($this->any())
            ->method('invokeAll')
            ->willReturnCallback(function ($hook_name, $args) {
            $cacheable_metadata = $args[4];
            $cacheable_metadata->addCacheContexts([
                'custom_context',
            ]);
            $cacheable_metadata->addCacheTags([
                'node:1',
            ]);
            $cacheable_metadata->setCacheMaxAge(10);
            return [
                '[node:title]' => 'hello world',
            ];
        });
        $node = $this->prophesize('Drupal\\node\\NodeInterface');
        $node->getCacheContexts()
            ->willReturn([]);
        $node->getCacheTags()
            ->willReturn([]);
        $node->getCacheMaxAge()
            ->willReturn(14);
        $node = $node->reveal();
        $bubbleable_metadata = new BubbleableMetadata();
        $bubbleable_metadata->setCacheContexts([
            'current_user',
        ]);
        $bubbleable_metadata->setCacheMaxAge(12);
        $result = $this->token
            ->replace('[node:title]', [
            'node' => $node,
        ], [], $bubbleable_metadata);
        $this->assertEquals('hello world', $result);
        $this->assertEquals([
            'node:1',
        ], $bubbleable_metadata->getCacheTags());
        $this->assertEquals([
            'current_user',
            'custom_context',
        ], $bubbleable_metadata->getCacheContexts());
        $this->assertEquals(10, $bubbleable_metadata->getCacheMaxAge());
    }
    
    /**
     * @covers ::replace
     * @covers ::replace
     */
    public function testReplaceWithHookTokensAlterWithBubbleableMetadata() : void {
        $this->moduleHandler
            ->expects($this->any())
            ->method('invokeAll')
            ->willReturn([]);
        $this->moduleHandler
            ->expects($this->any())
            ->method('alter')
            ->willReturnCallback(function ($hook_name, array &$replacements, array $context, BubbleableMetadata $bubbleable_metadata) {
            $replacements['[node:title]'] = 'hello world';
            $bubbleable_metadata->addCacheContexts([
                'custom_context',
            ]);
            $bubbleable_metadata->addCacheTags([
                'node:1',
            ]);
            $bubbleable_metadata->setCacheMaxAge(10);
        });
        $node = $this->prophesize('Drupal\\node\\NodeInterface');
        $node->getCacheContexts()
            ->willReturn([]);
        $node->getCacheTags()
            ->willReturn([]);
        $node->getCacheMaxAge()
            ->willReturn(14);
        $node = $node->reveal();
        $bubbleable_metadata = new BubbleableMetadata();
        $bubbleable_metadata->setCacheContexts([
            'current_user',
        ]);
        $bubbleable_metadata->setCacheMaxAge(12);
        $result = $this->token
            ->replace('[node:title]', [
            'node' => $node,
        ], [], $bubbleable_metadata);
        $this->assertEquals('hello world', $result);
        $this->assertEquals([
            'node:1',
        ], $bubbleable_metadata->getCacheTags());
        $this->assertEquals([
            'current_user',
            'custom_context',
        ], $bubbleable_metadata->getCacheContexts());
        $this->assertEquals(10, $bubbleable_metadata->getCacheMaxAge());
    }
    
    /**
     * @covers ::resetInfo
     */
    public function testResetInfo() : void {
        $this->cacheTagsInvalidator
            ->expects($this->once())
            ->method('invalidateTags')
            ->with([
            'token_info',
        ]);
        $this->token
            ->resetInfo();
    }
    
    /**
     * @covers ::replace
     * @dataProvider providerTestReplaceEscaping
     */
    public function testReplaceEscaping($string, array $tokens, $expected) : void {
        $this->moduleHandler
            ->expects($this->any())
            ->method('invokeAll')
            ->willReturnCallback(function ($type, $args) {
            return $args[2]['tokens'];
        });
        $result = $this->token
            ->replace($string, [
            'tokens' => $tokens,
        ]);
        $this->assertIsString($result);
        $this->assertEquals($expected, $result);
    }
    public static function providerTestReplaceEscaping() {
        $data = [];
        // No tokens. The first argument to Token::replace() should not be escaped.
        $data['no-tokens'] = [
            'muh',
            [],
            'muh',
        ];
        $data['html-in-string'] = [
            '<h1>Giraffe</h1>',
            [],
            '<h1>Giraffe</h1>',
        ];
        $data['html-in-string-quote'] = [
            '<h1>Giraffe"</h1>',
            [],
            '<h1>Giraffe"</h1>',
        ];
        $data['simple-placeholder-with-plain-text'] = [
            '<h1>[token:meh]</h1>',
            [
                '[token:meh]' => 'Giraffe"',
            ],
            '<h1>' . Html::escape('Giraffe"') . '</h1>',
        ];
        $data['simple-placeholder-with-safe-html'] = [
            '<h1>[token:meh]</h1>',
            [
                '[token:meh]' => Markup::create('<em>Emphasized</em>'),
            ],
            '<h1><em>Emphasized</em></h1>',
        ];
        return $data;
    }
    
    /**
     * @covers ::replacePlain
     */
    public function testReplacePlain() : void {
        $this->setupSiteTokens();
        $base = 'Wow, great "[site:name]" has a slogan "[site:slogan]"';
        $plain = $this->token
            ->replacePlain($base);
        $this->assertEquals($plain, 'Wow, great "Your <best> buys" has a slogan "We are best"');
    }
    
    /**
     * Scans dummy text, then tests the output.
     */
    public function testScan() : void {
        // Define text with valid and not valid, fake and existing token-like
        // strings.
        $text = 'First a [valid:simple], but dummy token, and a dummy [valid:token with: spaces].';
        $text .= 'Then a [not valid:token].';
        $text .= 'Then an [:empty token type].';
        $text .= 'Then an [empty token:].';
        $text .= 'Then a totally empty token: [:].';
        $text .= 'Last an existing token: [node:author:name].';
        $token_wannabes = $this->token
            ->scan($text);
        $this->assertTrue(isset($token_wannabes['valid']['simple']), 'A simple valid token has been matched.');
        $this->assertTrue(isset($token_wannabes['valid']['token with: spaces']), 'A valid token with space characters in the token name has been matched.');
        $this->assertFalse(isset($token_wannabes['not valid']), 'An invalid token with spaces in the token type has not been matched.');
        $this->assertFalse(isset($token_wannabes['empty token']), 'An empty token has not been matched.');
        $this->assertFalse(isset($token_wannabes['']['empty token type']), 'An empty token type has not been matched.');
        $this->assertFalse(isset($token_wannabes['']['']), 'An empty token and type has not been matched.');
        $this->assertTrue(isset($token_wannabes['node']), 'An existing valid token has been matched.');
    }
    
    /**
     * Tests passing a non-string value to Token::scan().
     *
     * @group legacy
     */
    public function testScanDeprecation() : void {
        $this->expectDeprecation('Calling Drupal\\Core\\Utility\\Token::scan() with a $text parameter of type other than string is deprecated in drupal:10.1.0 and will cause an error in drupal:11.0.0. See https://www.drupal.org/node/3334317');
        $this->assertSame([], $this->token
            ->scan(NULL));
    }
    
    /**
     * Sets up the token library to return site tokens.
     */
    protected function setupSiteTokens() {
        // The site name is plain text, but the slogan is markup.
        $tokens = [
            '[site:name]' => 'Your <best> buys',
            '[site:slogan]' => Markup::Create('We are <b>best</b>'),
        ];
        $this->moduleHandler
            ->expects($this->any())
            ->method('invokeAll')
            ->willReturn($tokens);
    }

}

Members

Title Sort descending Deprecated Modifiers Object type Summary Overriden Title Overrides
PhpUnitWarnings::$deprecationWarnings private static property Deprecation warnings from PHPUnit to raise with @trigger_error().
PhpUnitWarnings::addWarning public function Converts PHPUnit deprecation warnings to E_USER_DEPRECATED.
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.
RandomGeneratorTrait::randomStringValidate Deprecated public function Callback for random string validation.
TokenTest::$cache protected property The cache used for testing.
TokenTest::$cacheContextManager protected property The cache contexts manager.
TokenTest::$cacheTagsInvalidator protected property The cache tags invalidator.
TokenTest::$language protected property The language interface used for testing.
TokenTest::$languageManager protected property The language manager used for testing.
TokenTest::$moduleHandler protected property The module handler service used for testing.
TokenTest::$renderer protected property The renderer.
TokenTest::$token protected property The token service under test.
TokenTest::providerTestReplaceEscaping public static function
TokenTest::setUp protected function Overrides UnitTestCase::setUp
TokenTest::setupSiteTokens protected function Sets up the token library to return site tokens.
TokenTest::testGetInfo public function @covers ::getInfo
TokenTest::testReplaceEscaping public function @covers ::replace
@dataProvider providerTestReplaceEscaping
TokenTest::testReplacePlain public function @covers ::replacePlain
TokenTest::testReplaceWithBubbleableMetadataObject public function @covers ::replace
TokenTest::testReplaceWithHookTokensAlterWithBubbleableMetadata public function @covers ::replace
@covers ::replace
TokenTest::testReplaceWithHookTokensWithBubbleableMetadata public function @covers ::replace
TokenTest::testResetInfo public function @covers ::resetInfo
TokenTest::testScan public function Scans dummy text, then tests the output.
TokenTest::testScanDeprecation public function Tests passing a non-string value to Token::scan().
UnitTestCase::$root protected property The app root. 1
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::setUpBeforeClass public static function
UnitTestCase::__get public function

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.