class MediaEmbedFilterTest

Same name and namespace in other branches
  1. 9 core/modules/media/tests/src/Kernel/MediaEmbedFilterTest.php \Drupal\Tests\media\Kernel\MediaEmbedFilterTest
  2. 8.9.x core/modules/media/tests/src/Kernel/MediaEmbedFilterTest.php \Drupal\Tests\media\Kernel\MediaEmbedFilterTest
  3. 11.x core/modules/media/tests/src/Kernel/MediaEmbedFilterTest.php \Drupal\Tests\media\Kernel\MediaEmbedFilterTest

@coversDefaultClass \Drupal\media\Plugin\Filter\MediaEmbed @group media

Hierarchy

Expanded class hierarchy of MediaEmbedFilterTest

File

core/modules/media/tests/src/Kernel/MediaEmbedFilterTest.php, line 16

Namespace

Drupal\Tests\media\Kernel
View source
class MediaEmbedFilterTest extends MediaEmbedFilterTestBase {
    
    /**
     * {@inheritdoc}
     */
    protected static $modules = [
        // @see media_test_embed_entity_access()
        // @see media_test_embed_entity_view_alter()
'media_test_embed',
    ];
    
    /**
     * Ensures media entities are rendered correctly.
     *
     * @dataProvider providerTestBasics
     */
    public function testBasics(array $embed_attributes, $expected_view_mode, array $expected_attributes, CacheableMetadata $expected_cacheability) : void {
        $content = $this->createEmbedCode($embed_attributes);
        $result = $this->applyFilter($content);
        $this->assertCount(1, $this->cssSelect('div[data-media-embed-test-view-mode="' . $expected_view_mode . '"]'));
        $this->assertHasAttributes($this->cssSelect('div[data-media-embed-test-view-mode="' . $expected_view_mode . '"]')[0], $expected_attributes);
        $this->assertEqualsCanonicalizing($expected_cacheability->getCacheTags(), $result->getCacheTags());
        $this->assertEqualsCanonicalizing($expected_cacheability->getCacheContexts(), $result->getCacheContexts());
        $this->assertSame($expected_cacheability->getCacheMaxAge(), $result->getCacheMaxAge());
        $this->assertSame([
            'library',
        ], array_keys($result->getAttachments()));
        $this->assertSame([
            'media/filter.caption',
        ], $result->getAttachments()['library']);
    }
    
    /**
     * Data provider for testBasics().
     */
    public static function providerTestBasics() {
        $default_cacheability = (new CacheableMetadata())->setCacheTags([
            '_media_test_embed_filter_access:media:1',
            '_media_test_embed_filter_access:user:2',
            'config:image.style.thumbnail',
            'file:1',
            'media:1',
            'media_view',
            'user:2',
        ])
            ->setCacheContexts([
            'timezone',
            'user.permissions',
        ])
            ->setCacheMaxAge(Cache::PERMANENT);
        return [
            'data-entity-uuid only ⇒ default view mode used' => [
                [
                    'data-entity-type' => 'media',
                    'data-entity-uuid' => static::EMBEDDED_ENTITY_UUID,
                ],
                EntityDisplayRepositoryInterface::DEFAULT_DISPLAY_MODE,
                [],
                $default_cacheability,
            ],
            'data-entity-uuid + data-view-mode=full ⇒ specified view mode used' => [
                [
                    'data-entity-type' => 'media',
                    'data-entity-uuid' => static::EMBEDDED_ENTITY_UUID,
                    'data-view-mode' => 'full',
                ],
                'full',
                [],
                $default_cacheability,
            ],
            'data-entity-uuid + data-view-mode=default ⇒ specified view mode used' => [
                [
                    'data-entity-type' => 'media',
                    'data-entity-uuid' => static::EMBEDDED_ENTITY_UUID,
                    'data-view-mode' => EntityDisplayRepositoryInterface::DEFAULT_DISPLAY_MODE,
                ],
                EntityDisplayRepositoryInterface::DEFAULT_DISPLAY_MODE,
                [],
                $default_cacheability,
            ],
            'data-entity-uuid + data-view-mode=foobar ⇒ specified view mode used' => [
                [
                    'data-entity-type' => 'media',
                    'data-entity-uuid' => static::EMBEDDED_ENTITY_UUID,
                    'data-view-mode' => 'foobar',
                ],
                'foobar',
                [],
                (new CacheableMetadata())->setCacheTags([
                    '_media_test_embed_filter_access:media:1',
                    'config:image.style.medium',
                    'file:1',
                    'media:1',
                    'media_view',
                ])
                    ->setCacheContexts([
                    'user.permissions',
                ])
                    ->setCacheMaxAge(Cache::PERMANENT),
            ],
            'custom attributes are retained' => [
                [
                    'data-foo' => 'bar',
                    'foo' => 'bar',
                    'data-entity-type' => 'media',
                    'data-entity-uuid' => static::EMBEDDED_ENTITY_UUID,
                ],
                EntityDisplayRepositoryInterface::DEFAULT_DISPLAY_MODE,
                [
                    'data-foo' => 'bar',
                    'foo' => 'bar',
                ],
                $default_cacheability,
            ],
        ];
    }
    
    /**
     * Tests that entity access is respected by embedding an unpublished entity.
     *
     * @dataProvider providerAccessUnpublished
     */
    public function testAccessUnpublished($allowed_to_view_unpublished, $expected_rendered, CacheableMetadata $expected_cacheability, array $expected_attachments) : void {
        // Unpublish the embedded entity so we can test variations in behavior.
        $this->embeddedEntity
            ->setUnpublished()
            ->save();
        // Are we testing as a user who is allowed to view the embedded entity?
        if ($allowed_to_view_unpublished) {
            $this->container
                ->get('current_user')
                ->getAccount()
                ->addRole($this->drupalCreateRole([
                'view own unpublished media',
            ]));
        }
        $content = $this->createEmbedCode([
            'data-entity-type' => 'media',
            'data-entity-uuid' => static::EMBEDDED_ENTITY_UUID,
        ]);
        $result = $this->applyFilter($content);
        if (!$expected_rendered) {
            $this->assertEmpty($this->getRawContent());
        }
        else {
            $this->assertCount(1, $this->cssSelect('div[data-media-embed-test-view-mode="default"]'));
        }
        $this->assertEqualsCanonicalizing($expected_cacheability->getCacheTags(), $result->getCacheTags());
        $this->assertEqualsCanonicalizing($expected_cacheability->getCacheContexts(), $result->getCacheContexts());
        $this->assertSame($expected_cacheability->getCacheMaxAge(), $result->getCacheMaxAge());
        $this->assertSame($expected_attachments, $result->getAttachments());
    }
    
    /**
     * Data provider for testAccessUnpublished().
     */
    public static function providerAccessUnpublished() {
        return [
            'user cannot access embedded media' => [
                FALSE,
                FALSE,
                (new CacheableMetadata())->setCacheTags([
                    '_media_test_embed_filter_access:media:1',
                    'media:1',
                    'media_view',
                ])
                    ->setCacheContexts([
                    'user.permissions',
                ])
                    ->setCacheMaxAge(Cache::PERMANENT),
                [],
            ],
            'user can access embedded media' => [
                TRUE,
                TRUE,
                (new CacheableMetadata())->setCacheTags([
                    '_media_test_embed_filter_access:media:1',
                    '_media_test_embed_filter_access:user:2',
                    'config:image.style.thumbnail',
                    'file:1',
                    'media:1',
                    'media_view',
                    'user:2',
                ])
                    ->setCacheContexts([
                    'timezone',
                    'user',
                    'user.permissions',
                ])
                    ->setCacheMaxAge(Cache::PERMANENT),
                [
                    'library' => [
                        'media/filter.caption',
                    ],
                ],
            ],
        ];
    }
    
    /**
     * @covers ::applyPerEmbedMediaOverrides
     * @dataProvider providerOverridesAltAndTitle
     */
    public function testOverridesAltAndTitle($title_field_property_enabled, array $expected_title_attributes) : void {
        // The `alt` field property is enabled by default, the `title` one is not.
        if ($title_field_property_enabled) {
            $source_field = FieldConfig::load('media.image.field_media_image');
            $source_field->setSetting('title_field', TRUE);
            $source_field->save();
        }
        $base = [
            'data-entity-type' => 'media',
            'data-entity-uuid' => static::EMBEDDED_ENTITY_UUID,
        ];
        $input = $this->createEmbedCode($base);
        $input .= $this->createEmbedCode([
            'alt' => 'alt 1',
            'title' => 'title 1',
        ] + $base);
        $input .= $this->createEmbedCode([
            'alt' => 'alt 2',
            'title' => 'title 2',
        ] + $base);
        $input .= $this->createEmbedCode([
            'alt' => 'alt 3',
            'title' => 'title 3',
        ] + $base);
        $input .= $this->createEmbedCode([
            'alt' => '""',
            'title' => 'title 4',
        ] + $base);
        $this->applyFilter($input);
        $img_nodes = $this->cssSelect('img');
        $this->assertCount(5, $img_nodes);
        $this->assertHasAttributes($img_nodes[0], [
            'alt' => 'default alt',
            'title' => $expected_title_attributes[0],
        ]);
        $this->assertHasAttributes($img_nodes[1], [
            'alt' => 'alt 1',
            'title' => $expected_title_attributes[1],
        ]);
        $this->assertHasAttributes($img_nodes[2], [
            'alt' => 'alt 2',
            'title' => $expected_title_attributes[2],
        ]);
        $this->assertHasAttributes($img_nodes[3], [
            'alt' => 'alt 3',
            'title' => $expected_title_attributes[3],
        ]);
        $this->assertHasAttributes($img_nodes[4], [
            'alt' => '',
            'title' => $expected_title_attributes[4],
        ]);
    }
    
    /**
     * Data provider for testOverridesAltAndTitle().
     */
    public static function providerOverridesAltAndTitle() {
        return [
            '`title` field property disabled ⇒ `title` is not overridable' => [
                FALSE,
                [
                    NULL,
                    NULL,
                    NULL,
                    NULL,
                    NULL,
                ],
            ],
            '`title` field property enabled ⇒ `title` is overridable' => [
                TRUE,
                [
                    NULL,
                    'title 1',
                    'title 2',
                    'title 3',
                    'title 4',
                ],
            ],
        ];
    }
    
    /**
     * Tests the indicator for missing entities.
     *
     * @dataProvider providerMissingEntityIndicator
     */
    public function testMissingEntityIndicator($uuid, array $filter_ids, array $additional_attributes) : void {
        $content = $this->createEmbedCode([
            'data-entity-type' => 'media',
            'data-entity-uuid' => $uuid,
            'data-view-mode' => 'foobar',
        ] + $additional_attributes);
        // If the UUID being used in the embed is that of the sample entity, first
        // assert that it currently results in a functional embed, then delete it.
        if ($uuid === static::EMBEDDED_ENTITY_UUID) {
            $result = $this->processText($content, 'en', $filter_ids);
            $this->setRawContent($result->getProcessedText());
            $this->assertCount(1, $this->cssSelect('div[data-media-embed-test-view-mode="foobar"]'));
            $this->embeddedEntity
                ->delete();
        }
        $result = $this->processText($content, 'en', $filter_ids);
        $this->setRawContent($result->getProcessedText());
        $this->assertCount(0, $this->cssSelect('div[data-media-embed-test-view-mode="foobar"]'));
        $this->assertCount(1, $this->cssSelect('div.this-error-message-is-themeable'));
        if (in_array('filter_align', $filter_ids, TRUE) && !empty($additional_attributes['data-align'])) {
            $this->assertCount(1, $this->cssSelect('div.align-' . $additional_attributes['data-align']));
        }
    }
    
    /**
     * Data provider for testMissingEntityIndicator().
     */
    public static function providerMissingEntityIndicator() {
        return [
            'invalid UUID' => [
                'uuid' => 'invalidUUID',
                'filter_ids' => [
                    'filter_align',
                    'filter_caption',
                    'media_embed',
                ],
                'additional_attributes' => [],
            ],
            'valid UUID but for a deleted entity' => [
                'uuid' => static::EMBEDDED_ENTITY_UUID,
                'filter_ids' => [
                    'filter_align',
                    'filter_caption',
                    'media_embed',
                ],
                'additional_attributes' => [],
            ],
            'invalid UUID; data-align attribute without filter_align enabled' => [
                'uuid' => 'invalidUUID',
                'filter_ids' => [
                    'filter_caption',
                    'media_embed',
                ],
                'additional_attributes' => [
                    'data-align' => 'right',
                ],
            ],
            'invalid UUID; data-align attribute with filter_align enabled' => [
                'uuid' => 'invalidUUID',
                'filter_ids' => [
                    'filter_align',
                    'filter_caption',
                    'media_embed',
                ],
                'additional_attributes' => [
                    'data-align' => 'left',
                ],
            ],
            'valid UUID but for a deleted entity; data-align attribute with filter_align enabled' => [
                'uuid' => static::EMBEDDED_ENTITY_UUID,
                'filter_ids' => [
                    'filter_align',
                    'filter_caption',
                    'media_embed',
                ],
                'additional_attributes' => [
                    'data-align' => 'center',
                ],
            ],
        ];
    }
    
    /**
     * Tests that only <drupal-media> tags are processed.
     */
    public function testOnlyDrupalMediaTagProcessed() : void {
        $content = $this->createEmbedCode([
            'data-entity-type' => 'media',
            'data-entity-uuid' => $this->embeddedEntity
                ->uuid(),
        ]);
        $content = str_replace('drupal-media', 'drupal-entity', $content);
        $filter_result = $this->processText($content, 'en', [
            'media_embed',
        ]);
        // If input equals output, the filter didn't change anything.
        $this->assertSame($content, $filter_result->getProcessedText());
    }
    
    /**
     * Tests recursive rendering protection.
     */
    public function testRecursionProtection() : void {
        $text = $this->createEmbedCode([
            'data-entity-type' => 'media',
            'data-entity-uuid' => static::EMBEDDED_ENTITY_UUID,
        ]);
        // Render and verify the presence of the embedded entity 20 times.
        for ($i = 0; $i < 20; $i++) {
            $this->applyFilter($text);
            $this->assertCount(1, $this->cssSelect('div[data-media-embed-test-view-mode="default"]'));
        }
        // Render a 21st time, this is exceeding the recursion limit. The entity
        // embed markup will be stripped.
        $this->applyFilter($text);
        $this->assertEmpty($this->getRawContent());
    }
    
    /**
     * @covers \Drupal\filter\Plugin\Filter\FilterAlign
     * @covers \Drupal\filter\Plugin\Filter\FilterCaption
     * @dataProvider providerFilterIntegration
     */
    public function testFilterIntegration(array $filter_ids, array $additional_attributes, $verification_selector, $expected_verification_success, array $expected_asset_libraries = [], $prefix = '', $suffix = '') : void {
        $content = $this->createEmbedCode([
            'data-entity-type' => 'media',
            'data-entity-uuid' => static::EMBEDDED_ENTITY_UUID,
        ] + $additional_attributes);
        $content = $prefix . $content . $suffix;
        $result = $this->processText($content, 'en', $filter_ids);
        $this->setRawContent($result->getProcessedText());
        $this->assertCount($expected_verification_success ? 1 : 0, $this->cssSelect($verification_selector));
        $this->assertCount(1, $this->cssSelect('div[data-media-embed-test-view-mode="default"]'));
        $this->assertEqualsCanonicalizing([
            '_media_test_embed_filter_access:media:1',
            '_media_test_embed_filter_access:user:2',
            'config:image.style.thumbnail',
            'file:1',
            'media:1',
            'media_view',
            'user:2',
        ], $result->getCacheTags());
        $this->assertEqualsCanonicalizing([
            'timezone',
            'user.permissions',
        ], $result->getCacheContexts());
        $this->assertSame(Cache::PERMANENT, $result->getCacheMaxAge());
        $this->assertSame([
            'library',
        ], array_keys($result->getAttachments()));
        $this->assertSame($expected_asset_libraries, $result->getAttachments()['library']);
    }
    
    /**
     * Data provider for testFilterIntegration().
     */
    public static function providerFilterIntegration() {
        $default_asset_libraries = [
            'media/filter.caption',
        ];
        $caption_additional_attributes = [
            'data-caption' => 'Yo.',
        ];
        $caption_verification_selector = 'figure > figcaption';
        $caption_test_cases = [
            '`data-caption`; only `media_embed` ⇒ caption absent' => [
                [
                    'media_embed',
                ],
                $caption_additional_attributes,
                $caption_verification_selector,
                FALSE,
                $default_asset_libraries,
            ],
            '`data-caption`; `filter_caption` + `media_embed` ⇒ caption present' => [
                [
                    'filter_caption',
                    'media_embed',
                ],
                $caption_additional_attributes,
                $caption_verification_selector,
                TRUE,
                [
                    'filter/caption',
                    'media/filter.caption',
                ],
            ],
            '`<a>` + `data-caption`; `filter_caption` + `media_embed` ⇒ caption present, link preserved' => [
                [
                    'filter_caption',
                    'media_embed',
                ],
                $caption_additional_attributes,
                'figure > a[href="https://www.drupal.org"] + figcaption',
                TRUE,
                [
                    'filter/caption',
                    'media/filter.caption',
                ],
                '<a href="https://www.drupal.org">',
                '</a>',
            ],
        ];
        $align_additional_attributes = [
            'data-align' => 'center',
        ];
        $align_verification_selector = 'div[data-media-embed-test-view-mode].align-center';
        $align_test_cases = [
            '`data-align`; `media_embed` ⇒ alignment absent' => [
                [
                    'media_embed',
                ],
                $align_additional_attributes,
                $align_verification_selector,
                FALSE,
                $default_asset_libraries,
            ],
            '`data-align`; `filter_align` + `media_embed` ⇒ alignment present' => [
                [
                    'filter_align',
                    'media_embed',
                ],
                $align_additional_attributes,
                $align_verification_selector,
                TRUE,
                $default_asset_libraries,
            ],
            '`<a>` + `data-align`; `filter_align` + `media_embed` ⇒ alignment present, link preserved' => [
                [
                    'filter_align',
                    'media_embed',
                ],
                $align_additional_attributes,
                'a[href="https://www.drupal.org"] > div[data-media-embed-test-view-mode].align-center',
                TRUE,
                $default_asset_libraries,
                '<a href="https://www.drupal.org">',
                '</a>',
            ],
        ];
        $caption_and_align_test_cases = [
            '`data-caption` + `data-align`; `filter_align` + `filter_caption` + `media_embed` ⇒ aligned caption present' => [
                [
                    'filter_align',
                    'filter_caption',
                    'media_embed',
                ],
                $align_additional_attributes + $caption_additional_attributes,
                'figure.align-center > figcaption',
                TRUE,
                [
                    'filter/caption',
                    'media/filter.caption',
                ],
            ],
            '`<a>` + `data-caption` + `data-align`; `filter_align` + `filter_caption` + `media_embed` ⇒ aligned caption present, link preserved' => [
                [
                    'filter_align',
                    'filter_caption',
                    'media_embed',
                ],
                $align_additional_attributes + $caption_additional_attributes,
                'figure.align-center > a[href="https://www.drupal.org"] + figcaption',
                TRUE,
                [
                    'filter/caption',
                    'media/filter.caption',
                ],
                '<a href="https://www.drupal.org">',
                '</a>',
            ],
        ];
        return $caption_test_cases + $align_test_cases + $caption_and_align_test_cases;
    }

}

Members

Title Sort descending Deprecated Modifiers Object type Summary Member alias Overriden Title Overrides
AssertContentTrait::$content protected property The current raw content.
AssertContentTrait::$drupalSettings protected property The drupalSettings value from the current raw $content.
AssertContentTrait::$elements protected property The XML structure parsed from the current raw $content. 1
AssertContentTrait::$plainTextContent protected property The plain-text content of raw $content (text nodes).
AssertContentTrait::assertEscaped protected function Passes if the raw text IS found escaped on the loaded page, fail otherwise.
AssertContentTrait::assertField protected function Asserts that a field exists with the given name or ID.
AssertContentTrait::assertFieldById protected function Asserts that a field exists with the given ID and value.
AssertContentTrait::assertFieldByName protected function Asserts that a field exists with the given name and value.
AssertContentTrait::assertFieldByXPath protected function Asserts that a field exists in the current page by the given XPath.
AssertContentTrait::assertFieldChecked protected function Asserts that a checkbox field in the current page is checked.
AssertContentTrait::assertFieldsByValue protected function Asserts that a field exists in the current page with a given Xpath result.
AssertContentTrait::assertLink protected function Passes if a link with the specified label is found.
AssertContentTrait::assertLinkByHref protected function Passes if a link containing a given href (part) is found.
AssertContentTrait::assertNoDuplicateIds protected function Asserts that each HTML ID is used for just a single element.
AssertContentTrait::assertNoEscaped protected function Passes if raw text IS NOT found escaped on loaded page, fail otherwise.
AssertContentTrait::assertNoField protected function Asserts that a field does not exist with the given name or ID.
AssertContentTrait::assertNoFieldById protected function Asserts that a field does not exist with the given ID and value.
AssertContentTrait::assertNoFieldByName protected function Asserts that a field does not exist with the given name and value.
AssertContentTrait::assertNoFieldByXPath protected function Asserts that a field does not exist or its value does not match, by XPath.
AssertContentTrait::assertNoFieldChecked protected function Asserts that a checkbox field in the current page is not checked.
AssertContentTrait::assertNoLink protected function Passes if a link with the specified label is not found.
AssertContentTrait::assertNoLinkByHref protected function Passes if a link containing a given href (part) is not found.
AssertContentTrait::assertNoLinkByHrefInMainRegion protected function Passes if a link containing a given href is not found in the main region.
AssertContentTrait::assertNoOption protected function Asserts that a select option in the current page does not exist.
AssertContentTrait::assertNoOptionSelected protected function Asserts that a select option in the current page is not checked.
AssertContentTrait::assertNoPattern protected function Triggers a pass if the perl regex pattern is not found in raw content.
AssertContentTrait::assertNoRaw protected function Passes if the raw text is NOT found on the loaded page, fail otherwise.
AssertContentTrait::assertNoText protected function Passes if the page (with HTML stripped) does not contains the text.
AssertContentTrait::assertNoTitle protected function Pass if the page title is not the given string.
AssertContentTrait::assertNoUniqueText protected function Passes if the text is found MORE THAN ONCE on the text version of the page.
AssertContentTrait::assertOption protected function Asserts that a select option in the current page exists.
AssertContentTrait::assertOptionByText protected function Asserts that a select option with the visible text exists.
AssertContentTrait::assertOptionSelected protected function Asserts that a select option in the current page is checked.
AssertContentTrait::assertOptionSelectedWithDrupalSelector protected function Asserts that a select option in the current page is checked.
AssertContentTrait::assertOptionWithDrupalSelector protected function Asserts that a select option in the current page exists.
AssertContentTrait::assertPattern protected function Triggers a pass if the Perl regex pattern is found in the raw content.
AssertContentTrait::assertRaw protected function Passes if the raw text IS found on the loaded page, fail otherwise.
AssertContentTrait::assertText protected function Passes if the page (with HTML stripped) contains the text.
AssertContentTrait::assertTextHelper protected function Helper for assertText and assertNoText.
AssertContentTrait::assertTextPattern protected function Asserts that a Perl regex pattern is found in the plain-text content.
AssertContentTrait::assertThemeOutput protected function Asserts themed output.
AssertContentTrait::assertTitle protected function Pass if the page title is the given string.
AssertContentTrait::assertUniqueText protected function Passes if the text is found ONLY ONCE on the text version of the page.
AssertContentTrait::assertUniqueTextHelper protected function Helper for assertUniqueText and assertNoUniqueText.
AssertContentTrait::buildXPathQuery protected function Builds an XPath query.
AssertContentTrait::constructFieldXpath protected function Helper: Constructs an XPath for the given set of attributes and value.
AssertContentTrait::cssSelect protected function Searches elements using a CSS selector in the raw content.
AssertContentTrait::getAllOptions protected function Get all option elements, including nested options, in a select.
AssertContentTrait::getDrupalSettings protected function Gets the value of drupalSettings for the currently-loaded page.
AssertContentTrait::getRawContent protected function Gets the current raw content.
AssertContentTrait::getSelectedItem protected function Get the selected value from a select field.
AssertContentTrait::getTextContent protected function Retrieves the plain-text content from the current raw content.
AssertContentTrait::parse protected function Parse content returned from curlExec using DOM and SimpleXML.
AssertContentTrait::removeWhiteSpace protected function Removes all white-space between HTML tags from the raw content.
AssertContentTrait::setDrupalSettings protected function Sets the value of drupalSettings for the currently-loaded page.
AssertContentTrait::setRawContent protected function Sets the raw content (e.g. HTML).
AssertContentTrait::xpath protected function Performs an xpath search on the contents of the internal browser.
ConfigTestTrait::configImporter protected function Returns a ConfigImporter object to import test configuration.
ConfigTestTrait::copyConfig protected function Copies configuration objects from source storage to target storage.
ExtensionListTestTrait::getModulePath protected function Gets the path for the specified module.
ExtensionListTestTrait::getThemePath protected function Gets the path for the specified theme.
KernelTestBase::$backupGlobals protected property Back up and restore any global variables that may be changed by tests.
KernelTestBase::$backupStaticAttributes protected property Back up and restore static class properties that may be changed by tests.
KernelTestBase::$backupStaticAttributesBlacklist protected property Contains a few static class properties for performance.
KernelTestBase::$classLoader protected property
KernelTestBase::$configImporter protected property @todo Move into Config test base class. 6
KernelTestBase::$configSchemaCheckerExclusions protected static property An array of config object names that are excluded from schema checking. 3
KernelTestBase::$container protected property
KernelTestBase::$databasePrefix protected property
KernelTestBase::$keyValue protected property The key_value service that must persist between container rebuilds.
KernelTestBase::$preserveGlobalState protected property Do not forward any global state from the parent process to the processes
that run the actual tests.
KernelTestBase::$root protected property The app root.
KernelTestBase::$runTestInSeparateProcess protected property Kernel tests are run in separate processes because they allow autoloading
of code from extensions. Running the test in a separate process isolates
this behavior from other tests. Subclasses should not override this
property.
KernelTestBase::$siteDirectory protected property
KernelTestBase::$strictConfigSchema protected property Set to TRUE to strict check all configuration saved. 9
KernelTestBase::$usesSuperUserAccessPolicy protected property Set to TRUE to make user 1 a super user. 8
KernelTestBase::$vfsRoot protected property The virtual filesystem root directory.
KernelTestBase::assertPostConditions protected function 1
KernelTestBase::bootEnvironment protected function Bootstraps a basic test environment.
KernelTestBase::bootKernel protected function Bootstraps a kernel for a test. 1
KernelTestBase::config protected function Configuration accessor for tests. Returns non-overridden configuration.
KernelTestBase::disableModules protected function Disables modules for this test.
KernelTestBase::enableModules protected function Enables modules for this test. 1
KernelTestBase::getConfigSchemaExclusions protected function Gets the config schema exclusions for this test.
KernelTestBase::getDatabaseConnectionInfo protected function Returns the Database connection info to be used for this test. 2
KernelTestBase::getDatabasePrefix public function
KernelTestBase::getExtensionsForModules private function Returns Extension objects for $modules to enable.
KernelTestBase::getModulesToEnable private static function Returns the modules to enable for this test.
KernelTestBase::initFileCache protected function Initializes the FileCache component.
KernelTestBase::installConfig protected function Installs default configuration for a given list of modules.
KernelTestBase::installEntitySchema protected function Installs the storage schema for a specific entity type.
KernelTestBase::installSchema protected function Installs database tables from a module schema definition.
KernelTestBase::register public function Registers test-specific services. Overrides ServiceProviderInterface::register 27
KernelTestBase::render protected function Renders a render array. 1
KernelTestBase::setInstallProfile protected function Sets the install profile and rebuilds the container to update it.
KernelTestBase::setSetting protected function Sets an in-memory Settings variable.
KernelTestBase::setUpBeforeClass public static function 1
KernelTestBase::setUpFilesystem protected function Sets up the filesystem, so things like the file directory. 2
KernelTestBase::stop Deprecated protected function Stops test execution.
KernelTestBase::tearDown protected function 6
KernelTestBase::tearDownCloseDatabaseConnection public function @after
KernelTestBase::vfsDump protected function Dumps the current state of the virtual filesystem to STDOUT.
KernelTestBase::__get public function
KernelTestBase::__sleep public function Prevents serializing any properties.
MediaEmbedFilterTest::$modules protected static property Modules to enable. Overrides MediaEmbedFilterTestBase::$modules
MediaEmbedFilterTest::providerAccessUnpublished public static function Data provider for testAccessUnpublished().
MediaEmbedFilterTest::providerFilterIntegration public static function Data provider for testFilterIntegration().
MediaEmbedFilterTest::providerMissingEntityIndicator public static function Data provider for testMissingEntityIndicator().
MediaEmbedFilterTest::providerOverridesAltAndTitle public static function Data provider for testOverridesAltAndTitle().
MediaEmbedFilterTest::providerTestBasics public static function Data provider for testBasics().
MediaEmbedFilterTest::testAccessUnpublished public function Tests that entity access is respected by embedding an unpublished entity.
MediaEmbedFilterTest::testBasics public function Ensures media entities are rendered correctly.
MediaEmbedFilterTest::testFilterIntegration public function @covers \Drupal\filter\Plugin\Filter\FilterAlign
@covers \Drupal\filter\Plugin\Filter\FilterCaption
@dataProvider providerFilterIntegration
MediaEmbedFilterTest::testMissingEntityIndicator public function Tests the indicator for missing entities.
MediaEmbedFilterTest::testOnlyDrupalMediaTagProcessed public function Tests that only &lt;drupal-media&gt; tags are processed.
MediaEmbedFilterTest::testOverridesAltAndTitle public function @covers ::applyPerEmbedMediaOverrides
@dataProvider providerOverridesAltAndTitle
MediaEmbedFilterTest::testRecursionProtection public function Tests recursive rendering protection.
MediaEmbedFilterTestBase::$embeddedEntity protected property The sample Media entity to embed.
MediaEmbedFilterTestBase::$image protected property The image file to use in tests.
MediaEmbedFilterTestBase::applyFilter protected function Applies the `media_embed` filter to text, pipes to raw content.
MediaEmbedFilterTestBase::assertHasAttributes protected function Assert that the SimpleXMLElement object has the given attributes.
MediaEmbedFilterTestBase::createEmbedCode protected function Gets an embed code with given attributes.
MediaEmbedFilterTestBase::EMBEDDED_ENTITY_UUID constant The UUID to use for the embedded entity.
MediaEmbedFilterTestBase::processText protected function Processes text through the provided filters.
MediaEmbedFilterTestBase::setUp protected function Overrides KernelTestBase::setUp 2
MediaTypeCreationTrait::createMediaType protected function Create a media type for a source plugin.
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.
StorageCopyTrait::replaceStorageContents protected static function Copy the configuration from one storage to another and remove stale items.
TestFileCreationTrait::$generatedTestFiles protected property Whether the files were copied to the test files directory.
TestFileCreationTrait::compareFiles protected function Compares two files based on size and file name.
TestFileCreationTrait::generateFile public static function Generates a test file.
TestFileCreationTrait::getTestFiles protected function Gets a list of files that can be used in tests.
TestRequirementsTrait::checkModuleRequirements Deprecated private function Checks missing module requirements.
TestRequirementsTrait::checkRequirements Deprecated protected function Check module requirements for the Drupal use case.
TestRequirementsTrait::getDrupalRoot protected static function Returns the Drupal root directory.
UserCreationTrait::checkPermissions protected function Checks whether a given list of permission names is valid.
UserCreationTrait::createAdminRole protected function Creates an administrative role.
UserCreationTrait::createRole protected function Creates a role with specified permissions. Aliased as: drupalCreateRole
UserCreationTrait::createUser protected function Create a user with a given set of permissions. Aliased as: drupalCreateUser
UserCreationTrait::grantPermissions protected function Grant permissions to a user role.
UserCreationTrait::setCurrentUser protected function Switch the current logged in user.
UserCreationTrait::setUpCurrentUser protected function Creates a random user account and sets it as current user.

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