class TimezoneTest

Same name in this branch
  1. 8.9.x core/modules/simpletest/src/Tests/TimeZoneTest.php \Drupal\simpletest\Tests\TimeZoneTest
  2. 8.9.x core/modules/system/tests/src/Kernel/Timezone/TimezoneTest.php \Drupal\Tests\system\Kernel\Timezone\TimezoneTest
Same name in other branches
  1. 9 core/modules/system/tests/src/Kernel/Timezone/TimezoneTest.php \Drupal\Tests\system\Kernel\Timezone\TimezoneTest
  2. 9 core/tests/Drupal/KernelTests/Core/Datetime/Element/TimezoneTest.php \Drupal\KernelTests\Core\Datetime\Element\TimezoneTest
  3. 10 core/tests/Drupal/KernelTests/Core/Datetime/Element/TimezoneTest.php \Drupal\KernelTests\Core\Datetime\Element\TimezoneTest
  4. 11.x core/tests/Drupal/KernelTests/Core/Datetime/Element/TimezoneTest.php \Drupal\KernelTests\Core\Datetime\Element\TimezoneTest

Tests the timezone handling of datetime and datelist element types.

A range of different permutations of #default_value and #date_timezone for an element are setup in a single form by the buildForm() method, and tested in various ways for both element types.

@group Form

Hierarchy

Expanded class hierarchy of TimezoneTest

File

core/tests/Drupal/KernelTests/Core/Datetime/Element/TimezoneTest.php, line 22

Namespace

Drupal\KernelTests\Core\Datetime\Element
View source
class TimezoneTest extends EntityKernelTestBase implements FormInterface {
    
    /**
     * {@inheritdoc}
     */
    public static $modules = [
        'system',
    ];
    
    /**
     * The date used in tests.
     *
     * @var \Drupal\Core\Datetime\DrupalDateTime
     */
    protected $date;
    
    /**
     * An array of timezones with labels denoting their use in the tests.
     *
     * @var array
     */
    protected $timezones = [
        // UTC-12, no DST.
'zone A' => 'Pacific/Kwajalein',
        // UTC-7, no DST.
'zone B' => 'America/Phoenix',
        // UTC+5:30, no DST.
'user' => 'Asia/Kolkata',
        'UTC' => 'UTC',
    ];
    
    /**
     * The test date formatted in various formats and timezones.
     *
     * @var array
     */
    protected $formattedDates = [];
    
    /**
     * HTML date format pattern.
     *
     * @var string
     */
    protected $dateFormat;
    
    /**
     * HTML time format pattern.
     *
     * @var string
     */
    protected $timeFormat;
    
    /**
     * The element type that is being tested ('datetime' or 'datelist').
     *
     * @var string
     */
    protected $elementType;
    
    /**
     * The number of test elements on the form.
     *
     * @var int
     */
    protected $testConditions;
    
    /**
     * {@inheritdoc}
     */
    public function buildForm(array $form, FormStateInterface $form_state) {
        $form['test1'] = [
            '#title' => 'No default date, #date_timezone present',
            '#type' => $this->elementType,
            '#default_value' => '',
            '#date_timezone' => $this->timezones['zone A'],
            '#test_expect_timezone' => 'zone A',
        ];
        $form['test2'] = [
            '#title' => 'No default date, no #date_timezone',
            '#type' => $this->elementType,
            '#default_value' => '',
            '#test_expect_timezone' => 'user',
        ];
        $form['test3'] = [
            '#title' => 'Default date present with default timezone, #date_timezone same',
            '#type' => $this->elementType,
            '#default_value' => $this->date,
            '#date_timezone' => $this->timezones['user'],
            '#test_expect_timezone' => 'user',
        ];
        $form['test4'] = [
            '#title' => 'Default date present with default timezone, #date_timezone different',
            '#type' => $this->elementType,
            '#default_value' => $this->date,
            '#date_timezone' => $this->timezones['zone A'],
            '#test_expect_timezone' => 'zone A',
        ];
        $form['test5'] = [
            '#title' => 'Default date present with default timezone, no #date_timezone',
            '#type' => $this->elementType,
            '#default_value' => $this->date,
            '#test_expect_timezone' => 'user',
        ];
        $dateWithTimeZoneA = clone $this->date;
        $dateWithTimeZoneA->setTimezone(new \DateTimeZone($this->timezones['zone A']));
        $form['test6'] = [
            '#title' => 'Default date present with unusual timezone, #date_timezone same',
            '#type' => $this->elementType,
            '#default_value' => $dateWithTimeZoneA,
            '#date_timezone' => $this->timezones['zone A'],
            '#test_expect_timezone' => 'zone A',
        ];
        $form['test7'] = [
            '#title' => 'Default date present with unusual timezone, #date_timezone different',
            '#type' => $this->elementType,
            '#default_value' => $dateWithTimeZoneA,
            '#date_timezone' => $this->timezones['zone B'],
            '#test_expect_timezone' => 'zone B',
        ];
        $form['test8'] = [
            '#title' => 'Default date present with unusual timezone, no #date_timezone',
            '#type' => $this->elementType,
            '#default_value' => $dateWithTimeZoneA,
            '#test_expect_timezone' => 'user',
        ];
        $this->testConditions = 8;
        return $form;
    }
    
    /**
     * {@inheritdoc}
     */
    protected function setUp() {
        parent::setUp();
        $this->installConfig([
            'system',
        ]);
        // Setup the background time zones.
        $this->timezones['php initial'] = date_default_timezone_get();
        $user = $this->createUser();
        $user->set('timezone', $this->timezones['user'])
            ->save();
        // This also sets PHP's assumed time.
        \Drupal::currentUser()->setAccount($user);
        // Set a reference date to use in tests.
        $this->date = new DrupalDatetime('2000-01-01 12:00', NULL);
        // Create arrays listing the dates and times of $this->date formatted
        // according to the various timezones of $this->timezones.
        $this->dateFormat = DateFormat::load('html_date')->getPattern();
        $this->timeFormat = DateFormat::load('html_time')->getPattern();
        $date = clone $this->date;
        foreach ($this->timezones as $label => $timezone) {
            $date->setTimezone(new \DateTimeZone($timezone));
            $this->formattedDates['date'][$label] = $date->format($this->dateFormat);
            $this->formattedDates['time'][$label] = $date->format($this->timeFormat);
            $this->formattedDates['day'][$label] = $date->format('j');
            $this->formattedDates['month'][$label] = $date->format('n');
            $this->formattedDates['year'][$label] = $date->format('Y');
            $this->formattedDates['hour'][$label] = $date->format('G');
            $this->formattedDates['minute'][$label] = $date->format('i');
            $this->formattedDates['second'][$label] = $date->format('s');
        }
        // Validate the timezone setup.
        $this->assertEquals($this->timezones['user'], date_default_timezone_get(), 'Subsequent tests assume specific value for date_default_timezone_get().');
        $this->assertEquals(date_default_timezone_get(), $this->date
            ->getTimezone()
            ->getName(), 'Subsequent tests assume DrupalDateTime objects default to Drupal user time zone if none specified');
    }
    
    /**
     * Tests datetime elements interpret their times correctly when saving.
     *
     * Initial times are inevitably presented to the user using a timezone, and so
     * the time must be interpreted using the same timezone when it is time to
     * save the form, otherwise stored times may be changed without the user
     * changing the element's values.
     */
    public function testDatetimeElementTimesUnderstoodCorrectly() {
        $this->assertTimesUnderstoodCorrectly('datetime', [
            'date',
            'time',
        ]);
    }
    
    /**
     * Tests datelist elements interpret their times correctly when saving.
     *
     * See testDatetimeElementTimesUnderstoodCorrectly() for more explanation.
     */
    public function testDatelistElementTimesUnderstoodCorrectly() {
        $this->assertTimesUnderstoodCorrectly('datelist', [
            'day',
            'month',
            'year',
            'hour',
            'minute',
            'second',
        ]);
    }
    
    /**
     * On datetime elements test #date_timezone after ::processDatetime.
     *
     * The element's render array has a #date_timezone value that should
     * accurately reflect the timezone that will be used to interpret times
     * entered through the element.
     */
    public function testDatetimeTimezonePropertyProcessed() {
        $this->assertDateTimezonePropertyProcessed('datetime');
    }
    
    /**
     * On datelist elements test #date_timezone after ::processDatetime.
     *
     * See testDatetimeTimezonePropertyProcessed() for more explanation.
     */
    public function testDatelistTimezonePropertyProcessed() {
        $this->assertDateTimezonePropertyProcessed('datelist');
    }
    
    /**
     * Asserts that elements interpret dates using the expected time zones.
     *
     * @param string $elementType
     *   The element type to test.
     * @param array $inputs
     *   The names of the default input elements used by this element type.
     *
     * @throws \Exception
     */
    protected function assertTimesUnderstoodCorrectly($elementType, array $inputs) {
        $this->elementType = $elementType;
        // Simulate the form being saved, with the user adding the date for any
        // initially empty elements, but not changing other elements.
        $form_state = new FormState();
        $form_builder = $this->container
            ->get('form_builder');
        $form = $this->setupForm($form_state, $form_builder);
        foreach ($form as $elementName => $element) {
            if (isset($element['#type']) && $element['#type'] === $this->elementType && $element['#default_value'] === '') {
                $newValues = [];
                // Build an array of new values for the initially empty elements,
                // depending on the inputs required by the element type, and using
                // the timezone that will be expected for that test element.
                foreach ($inputs as $input) {
                    $newValues[$input] = $this->formattedDates[$input][$element['#test_expect_timezone']];
                }
                $form_state->setValue([
                    $elementName,
                ], $newValues);
            }
        }
        $form_builder->submitForm($this, $form_state);
        // Examine the output of each test element.
        $utc = new \DateTimeZone('UTC');
        $expectedDateUTC = clone $this->date;
        $expectedDateUTC->setTimezone($utc)
            ->format('Y-m-d H:i:s');
        $wrongDates = [];
        $wrongTimezones = [];
        $rightDates = 0;
        foreach ($form_state->getCompleteForm() as $elementName => $element) {
            if (isset($element['#type']) && $element['#type'] === $this->elementType) {
                $actualDate = $form_state->getValue($elementName);
                $actualTimezone = array_search($actualDate->getTimezone()
                    ->getName(), $this->timezones);
                $actualDateUTC = $actualDate->setTimezone($utc)
                    ->format('Y-m-d H:i:s');
                // Check that $this->date has not anywhere been accidentally changed
                // from its default timezone, invalidating the test logic.
                $this->assertEquals(date_default_timezone_get(), $this->date
                    ->getTimezone()
                    ->getName(), "Test date still set to user timezone.");
                // Build a list of cases where the result is not as expected.
                // Check the time has been understood correctly.
                if ($actualDate != $this->date) {
                    $wrongDates[$element['#title']] = $actualDateUTC;
                }
                else {
                    // Explicitly counting test passes prevents the test from seeming to
                    // pass just because the whole loop is being skipped.
                    $rightDates++;
                }
                // Check the correct timezone is set on the value object.
                if ($element['#test_expect_timezone'] !== $actualTimezone) {
                    $wrongTimezones[$element['#title']] = [
                        $element['#test_expect_timezone'],
                        $actualTimezone,
                    ];
                }
            }
        }
        $message = "On all elements the time should be understood correctly as {$expectedDateUTC}: \n" . print_r($wrongDates, TRUE);
        $this->assertEquals($this->testConditions, $rightDates, $message);
        $message = "On all elements the correct timezone should be set on the value object: (expected, actual) \n" . print_r($wrongTimezones, TRUE);
        $this->assertCount(0, $wrongTimezones, $message);
    }
    
    /**
     * Asserts that elements set #date_timezone correctly.
     *
     * @param string $elementType
     *   The element type to test.
     *
     * @throws \Exception
     */
    public function assertDateTimezonePropertyProcessed($elementType) {
        $this->elementType = $elementType;
        // Simulate form being loaded and default values displayed to user.
        $form_state = new FormState();
        $form_builder = $this->container
            ->get('form_builder');
        $this->setupForm($form_state, $form_builder);
        // Check the #date_timezone property on each processed test element.
        $wrongTimezones = [];
        foreach ($form_state->getCompleteForm() as $elementName => $element) {
            if (isset($element['#type']) && $element['#type'] === $this->elementType) {
                // Check the correct timezone is set on the value object.
                $actualTimezone = array_search($element['#date_timezone'], $this->timezones, TRUE);
                if ($element['#test_expect_timezone'] !== $actualTimezone) {
                    $wrongTimezones[$element['#title']] = [
                        $element['#test_expect_timezone'],
                        $actualTimezone,
                    ];
                }
            }
            $this->assertEquals($this->timezones['user'], date_default_timezone_get(), 'Subsequent tests assume specific value for date_default_timezone_get().');
            $message = "The correct timezone should be set on the processed {$this->elementType}  elements: (expected, actual) \n" . print_r($wrongTimezones, TRUE);
            $this->assertCount(0, $wrongTimezones, $message);
        }
    }
    
    /**
     * Simulate form being loaded and default values displayed to user.
     *
     * @param \Drupal\Core\Form\FormStateInterface $form_state
     *   A form_state object.
     * @param \Drupal\Core\Form\FormBuilderInterface $form_builder
     *   A form_builder object.
     *
     * @return \Drupal\Core\Form\FormStateInterface
     *   The modified form state.
     */
    protected function setupForm(FormStateInterface $form_state, FormBuilderInterface $form_builder) {
        $form_id = $form_builder->getFormId($this, $form_state);
        $form = $form_builder->retrieveForm($form_id, $form_state);
        $form_state->setValidationEnforced();
        $form_state->clearErrors();
        $form_builder->prepareForm($form_id, $form, $form_state);
        $form_builder->processForm($form_id, $form, $form_state);
        return $form_builder->retrieveForm($form_id, $form_state);
    }
    
    /**
     * {@inheritdoc}
     */
    public function getFormId() {
        return 'test_datetime_elements';
    }
    
    /**
     * {@inheritdoc}
     */
    public function submitForm(array &$form, FormStateInterface $form_state) {
    }
    
    /**
     * {@inheritdoc}
     */
    public function validateForm(array &$form, FormStateInterface $form_state) {
    }

}

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 the raw text IS NOT found escaped on the 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::getUrl protected function Get the current URL from the cURL handler. 1
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.
AssertHelperTrait::castSafeStrings protected static function Casts MarkupInterface objects into strings.
AssertLegacyTrait::assert protected function
AssertLegacyTrait::assertEqual protected function
AssertLegacyTrait::assertIdentical protected function
AssertLegacyTrait::assertIdenticalObject protected function
AssertLegacyTrait::assertNotEqual protected function
AssertLegacyTrait::assertNotIdentical protected function
AssertLegacyTrait::pass protected function
AssertLegacyTrait::verbose protected function
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.
DeprecatedServicePropertyTrait::__get public function Allows to access deprecated/removed properties.
EntityKernelTestBase::$deprecatedProperties protected property The list of deprecated services.
EntityKernelTestBase::$entityTypeManager protected property The entity type manager service. 1
EntityKernelTestBase::$generatedIds protected property A list of generated identifiers.
EntityKernelTestBase::$state protected property The state service.
EntityKernelTestBase::createUser protected function Creates a user.
EntityKernelTestBase::generateRandomEntityId protected function Generates a random ID avoiding collisions.
EntityKernelTestBase::getHooksInfo protected function Returns the entity_test hook invocation info.
EntityKernelTestBase::installModule protected function Installs a module and refreshes services.
EntityKernelTestBase::refreshServices protected function Refresh services. 1
EntityKernelTestBase::reloadEntity protected function Reloads the given entity from the storage and returns it.
EntityKernelTestBase::uninstallModule protected function Uninstalls a module and refreshes services.
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. 7
KernelTestBase::$configSchemaCheckerExclusions protected static property An array of config object names that are excluded from schema checking.
KernelTestBase::$container protected property
KernelTestBase::$databasePrefix protected property
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. 6
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 private function Bootstraps a kernel for a test.
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.
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. 1
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::isTestInIsolation Deprecated protected function Returns whether the current test method is running in a separate process.
KernelTestBase::prepareTemplate protected function
KernelTestBase::register public function Registers test-specific services. Overrides ServiceProviderInterface::register 26
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 protected function Stops test execution.
KernelTestBase::tearDown protected function 5
KernelTestBase::tearDownCloseDatabaseConnection public function @after
KernelTestBase::vfsDump protected function Dumps the current state of the virtual filesystem to STDOUT.
KernelTestBase::__sleep public function Prevents serializing any properties.
PhpunitCompatibilityTrait::getMock Deprecated public function Returns a mock object for the specified class using the available method.
PhpunitCompatibilityTrait::setExpectedException Deprecated public function Compatibility layer for PHPUnit 6 to support PHPUnit 4 code.
RandomGeneratorTrait::$randomGenerator protected property The random generator.
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. 1
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 public function Callback for random string validation.
StorageCopyTrait::replaceStorageContents protected static function Copy the configuration from one storage to another and remove stale items.
TestRequirementsTrait::checkModuleRequirements private function Checks missing module requirements.
TestRequirementsTrait::checkRequirements protected function Check module requirements for the Drupal use case. 1
TestRequirementsTrait::getDrupalRoot protected static function Returns the Drupal root directory.
TimezoneTest::$date protected property The date used in tests.
TimezoneTest::$dateFormat protected property HTML date format pattern.
TimezoneTest::$elementType protected property The element type that is being tested ('datetime' or 'datelist').
TimezoneTest::$formattedDates protected property The test date formatted in various formats and timezones.
TimezoneTest::$modules public static property Modules to enable. Overrides EntityKernelTestBase::$modules
TimezoneTest::$testConditions protected property The number of test elements on the form.
TimezoneTest::$timeFormat protected property HTML time format pattern.
TimezoneTest::$timezones protected property An array of timezones with labels denoting their use in the tests.
TimezoneTest::assertDateTimezonePropertyProcessed public function Asserts that elements set #date_timezone correctly.
TimezoneTest::assertTimesUnderstoodCorrectly protected function Asserts that elements interpret dates using the expected time zones.
TimezoneTest::buildForm public function Form constructor. Overrides FormInterface::buildForm
TimezoneTest::getFormId public function Returns a unique string identifying the form. Overrides FormInterface::getFormId
TimezoneTest::setUp protected function Overrides EntityKernelTestBase::setUp
TimezoneTest::setupForm protected function Simulate form being loaded and default values displayed to user.
TimezoneTest::submitForm public function Form submission handler. Overrides FormInterface::submitForm
TimezoneTest::testDatelistElementTimesUnderstoodCorrectly public function Tests datelist elements interpret their times correctly when saving.
TimezoneTest::testDatelistTimezonePropertyProcessed public function On datelist elements test #date_timezone after ::processDatetime.
TimezoneTest::testDatetimeElementTimesUnderstoodCorrectly public function Tests datetime elements interpret their times correctly when saving.
TimezoneTest::testDatetimeTimezonePropertyProcessed public function On datetime elements test #date_timezone after ::processDatetime.
TimezoneTest::validateForm public function Form validation handler. Overrides FormInterface::validateForm
UserCreationTrait::checkPermissions protected function Checks whether a given list of permission names is valid. Aliased as: drupalCheckPermissions
UserCreationTrait::createAdminRole protected function Creates an administrative role. Aliased as: drupalCreateAdminRole
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. Aliased as: drupalGrantPermissions
UserCreationTrait::setCurrentUser protected function Switch the current logged in user. Aliased as: drupalSetCurrentUser
UserCreationTrait::setUpCurrentUser protected function Creates a random user account and sets it as current user. Aliased as: drupalSetUpCurrentUser

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