class LocaleTranslationUiTest in Drupal 8
Same name and namespace in other branches
- 9 core/modules/locale/tests/src/Functional/LocaleTranslationUiTest.php \Drupal\Tests\locale\Functional\LocaleTranslationUiTest
- 10 core/modules/locale/tests/src/Functional/LocaleTranslationUiTest.php \Drupal\Tests\locale\Functional\LocaleTranslationUiTest
Adds a new locale and translates its name. Checks the validation of translation strings and search results.
@group locale
Hierarchy
- class \Drupal\Tests\BrowserTestBase extends \PHPUnit\Framework\TestCase uses FunctionalTestSetupTrait, TestSetupTrait, AssertLegacyTrait, BlockCreationTrait, ConfigTestTrait, ContentTypeCreationTrait, NodeCreationTrait, PhpunitCompatibilityTrait, RandomGeneratorTrait, TestRequirementsTrait, UiHelperTrait, UserCreationTrait, XdebugRequestTrait
- class \Drupal\Tests\locale\Functional\LocaleTranslationUiTest
Expanded class hierarchy of LocaleTranslationUiTest
File
- core/
modules/ locale/ tests/ src/ Functional/ LocaleTranslationUiTest.php, line 17
Namespace
Drupal\Tests\locale\FunctionalView source
class LocaleTranslationUiTest extends BrowserTestBase {
/**
* Modules to enable.
*
* @var array
*/
public static $modules = [
'locale',
];
/**
* {@inheritdoc}
*/
protected $defaultTheme = 'stark';
/**
* Enable interface translation to English.
*/
public function testEnglishTranslation() {
$admin_user = $this
->drupalCreateUser([
'administer languages',
'access administration pages',
]);
$this
->drupalLogin($admin_user);
$this
->drupalPostForm('admin/config/regional/language/edit/en', [
'locale_translate_english' => TRUE,
], t('Save language'));
$this
->assertLinkByHref('/admin/config/regional/translate?langcode=en', 0, 'Enabled interface translation to English.');
}
/**
* Adds a language and tests string translation by users with the appropriate permissions.
*/
public function testStringTranslation() {
// User to add and remove language.
$admin_user = $this
->drupalCreateUser([
'administer languages',
'access administration pages',
]);
// User to translate and delete string.
$translate_user = $this
->drupalCreateUser([
'translate interface',
'access administration pages',
]);
// Code for the language.
$langcode = 'xx';
// The English name for the language. This will be translated.
$name = 'cucurbitaceae';
// This will be the translation of $name.
$translation = $this
->randomMachineName(16);
$translation_to_en = $this
->randomMachineName(16);
// Add custom language.
$this
->drupalLogin($admin_user);
$edit = [
'predefined_langcode' => 'custom',
'langcode' => $langcode,
'label' => $name,
'direction' => LanguageInterface::DIRECTION_LTR,
];
$this
->drupalPostForm('admin/config/regional/language/add', $edit, t('Add custom language'));
// Add string.
t($name, [], [
'langcode' => $langcode,
])
->render();
// Reset locale cache.
$this->container
->get('string_translation')
->reset();
$this
->assertRaw('"edit-languages-' . $langcode . '-weight"', 'Language code found.');
$this
->assertText(t($name), 'Test language added.');
$this
->drupalLogout();
// Search for the name and translate it.
$this
->drupalLogin($translate_user);
$search = [
'string' => $name,
'langcode' => $langcode,
'translation' => 'untranslated',
];
$this
->drupalPostForm('admin/config/regional/translate', $search, t('Filter'));
$this
->assertText($name, 'Search found the string as untranslated.');
// No t() here, it's surely not translated yet.
$this
->assertText($name, 'name found on edit screen.');
$this
->assertNoOption('edit-langcode', 'en', 'No way to translate the string to English.');
$this
->drupalLogout();
$this
->drupalLogin($admin_user);
$this
->drupalPostForm('admin/config/regional/language/edit/en', [
'locale_translate_english' => TRUE,
], t('Save language'));
$this
->drupalLogout();
$this
->drupalLogin($translate_user);
$this
->drupalPostForm('admin/config/regional/translate', $search, t('Filter'));
$this
->assertText($name, 'Search found the string as untranslated.');
// Assume this is the only result, given the random name.
$textarea = current($this
->xpath('//textarea'));
$lid = $textarea
->getAttribute('name');
$edit = [
$lid => $translation,
];
$this
->drupalPostForm('admin/config/regional/translate', $edit, t('Save translations'));
$this
->assertText(t('The strings have been saved.'), 'The strings have been saved.');
$url_bits = explode('?', $this
->getUrl());
$this
->assertEqual($url_bits[0], Url::fromRoute('locale.translate_page', [], [
'absolute' => TRUE,
])
->toString(), 'Correct page redirection.');
$search = [
'string' => $name,
'langcode' => $langcode,
'translation' => 'translated',
];
$this
->drupalPostForm('admin/config/regional/translate', $search, t('Filter'));
$this
->assertRaw($translation, 'Non-English translation properly saved.');
$search = [
'string' => $name,
'langcode' => 'en',
'translation' => 'untranslated',
];
$this
->drupalPostForm('admin/config/regional/translate', $search, t('Filter'));
$textarea = current($this
->xpath('//textarea'));
$lid = $textarea
->getAttribute('name');
$edit = [
$lid => $translation_to_en,
];
$this
->drupalPostForm('admin/config/regional/translate', $edit, t('Save translations'));
$search = [
'string' => $name,
'langcode' => 'en',
'translation' => 'translated',
];
$this
->drupalPostForm('admin/config/regional/translate', $search, t('Filter'));
$this
->assertRaw($translation_to_en, 'English translation properly saved.');
$this
->assertTrue($name != $translation && t($name, [], [
'langcode' => $langcode,
]) == $translation, 't() works for non-English.');
// Refresh the locale() cache to get fresh data from t() below. We are in
// the same HTTP request and therefore t() is not refreshed by saving the
// translation above.
$this->container
->get('string_translation')
->reset();
// Now we should get the proper fresh translation from t().
$this
->assertTrue($name != $translation_to_en && t($name, [], [
'langcode' => 'en',
]) == $translation_to_en, 't() works for English.');
$this
->assertTrue(t($name, [], [
'langcode' => LanguageInterface::LANGCODE_SYSTEM,
]) == $name, 't() works for LanguageInterface::LANGCODE_SYSTEM.');
$search = [
'string' => $name,
'langcode' => 'en',
'translation' => 'untranslated',
];
$this
->drupalPostForm('admin/config/regional/translate', $search, t('Filter'));
$this
->assertText(t('No strings available.'), 'String is translated.');
// Test invalidation of 'rendered' cache tag after string translation.
$this
->drupalLogout();
$this
->drupalGet('xx/user/login');
$this
->assertText('Enter the password that accompanies your username.');
$this
->drupalLogin($translate_user);
$search = [
'string' => 'accompanies your username',
'langcode' => $langcode,
'translation' => 'untranslated',
];
$this
->drupalPostForm('admin/config/regional/translate', $search, t('Filter'));
$textarea = current($this
->xpath('//textarea'));
$lid = $textarea
->getAttribute('name');
$edit = [
$lid => 'Please enter your Llama username.',
];
$this
->drupalPostForm('admin/config/regional/translate', $edit, t('Save translations'));
$this
->drupalLogout();
$this
->drupalGet('xx/user/login');
$this
->assertText('Please enter your Llama username.');
// Delete the language.
$this
->drupalLogin($admin_user);
$path = 'admin/config/regional/language/delete/' . $langcode;
// This a confirm form, we do not need any fields changed.
$this
->drupalPostForm($path, [], t('Delete'));
// We need raw here because %language and %langcode will add HTML.
$t_args = [
'%language' => $name,
'%langcode' => $langcode,
];
$this
->assertRaw(t('The %language (%langcode) language has been removed.', $t_args), 'The test language has been removed.');
// Reload to remove $name.
$this
->drupalGet($path);
// Verify that language is no longer found.
$this
->assertSession()
->statusCodeEquals(404);
$this
->drupalLogout();
// Delete the string.
$this
->drupalLogin($translate_user);
$search = [
'string' => $name,
'langcode' => 'en',
'translation' => 'translated',
];
$this
->drupalPostForm('admin/config/regional/translate', $search, t('Filter'));
// Assume this is the only result, given the random name.
$textarea = current($this
->xpath('//textarea'));
$lid = $textarea
->getAttribute('name');
$edit = [
$lid => '',
];
$this
->drupalPostForm('admin/config/regional/translate', $edit, t('Save translations'));
$this
->assertRaw($name, 'The strings have been saved.');
$this
->drupalLogin($translate_user);
$search = [
'string' => $name,
'langcode' => 'en',
'translation' => 'untranslated',
];
$this
->drupalPostForm('admin/config/regional/translate', $search, t('Filter'));
$this
->assertNoText(t('No strings available.'), 'The translation has been removed');
}
/**
* Adds a language and checks that the JavaScript translation files are
* properly created and rebuilt on deletion.
*/
public function testJavaScriptTranslation() {
$user = $this
->drupalCreateUser([
'translate interface',
'administer languages',
'access administration pages',
]);
$this
->drupalLogin($user);
$config = $this
->config('locale.settings');
$langcode = 'xx';
// The English name for the language. This will be translated.
$name = $this
->randomMachineName(16);
// Add custom language.
$edit = [
'predefined_langcode' => 'custom',
'langcode' => $langcode,
'label' => $name,
'direction' => LanguageInterface::DIRECTION_LTR,
];
$this
->drupalPostForm('admin/config/regional/language/add', $edit, t('Add custom language'));
$this->container
->get('language_manager')
->reset();
// Build the JavaScript translation file.
// Retrieve the source string of the first string available in the
// {locales_source} table and translate it.
$query = Database::getConnection()
->select('locales_source', 's');
$query
->addJoin('INNER', 'locales_location', 'l', 's.lid = l.lid');
$source = $query
->fields('s', [
'source',
])
->condition('l.type', 'javascript')
->range(0, 1)
->execute()
->fetchField();
$search = [
'string' => $source,
'langcode' => $langcode,
'translation' => 'all',
];
$this
->drupalPostForm('admin/config/regional/translate', $search, t('Filter'));
$textarea = current($this
->xpath('//textarea'));
$lid = $textarea
->getAttribute('name');
$edit = [
$lid => $this
->randomMachineName(),
];
$this
->drupalPostForm('admin/config/regional/translate', $edit, t('Save translations'));
// Trigger JavaScript translation parsing and building.
_locale_rebuild_js($langcode);
$locale_javascripts = \Drupal::state()
->get('locale.translation.javascript') ?: [];
$js_file = 'public://' . $config
->get('javascript.directory') . '/' . $langcode . '_' . $locale_javascripts[$langcode] . '.js';
$this
->assertFileExists($js_file);
// Test JavaScript translation rebuilding.
\Drupal::service('file_system')
->delete($js_file);
$this
->assertFileNotExists($js_file);
_locale_rebuild_js($langcode);
$this
->assertFileExists($js_file);
}
/**
* Tests the validation of the translation input.
*/
public function testStringValidation() {
// User to add language and strings.
$admin_user = $this
->drupalCreateUser([
'administer languages',
'access administration pages',
'translate interface',
]);
$this
->drupalLogin($admin_user);
$langcode = 'xx';
// The English name for the language. This will be translated.
$name = $this
->randomMachineName(16);
// These will be the invalid translations of $name.
$key = $this
->randomMachineName(16);
$bad_translations[$key] = "<script>alert('xss');</script>" . $key;
$key = $this
->randomMachineName(16);
$bad_translations[$key] = '<img SRC="javascript:alert(\'xss\');">' . $key;
$key = $this
->randomMachineName(16);
$bad_translations[$key] = '<<SCRIPT>alert("xss");//<</SCRIPT>' . $key;
$key = $this
->randomMachineName(16);
$bad_translations[$key] = "<BODY ONLOAD=alert('xss')>" . $key;
// Add custom language.
$edit = [
'predefined_langcode' => 'custom',
'langcode' => $langcode,
'label' => $name,
'direction' => LanguageInterface::DIRECTION_LTR,
];
$this
->drupalPostForm('admin/config/regional/language/add', $edit, t('Add custom language'));
// Add string.
t($name, [], [
'langcode' => $langcode,
])
->render();
// Reset locale cache.
$search = [
'string' => $name,
'langcode' => $langcode,
'translation' => 'all',
];
$this
->drupalPostForm('admin/config/regional/translate', $search, t('Filter'));
// Find the edit path.
$textarea = current($this
->xpath('//textarea'));
$lid = $textarea
->getAttribute('name');
foreach ($bad_translations as $translation) {
$edit = [
$lid => $translation,
];
$this
->drupalPostForm('admin/config/regional/translate', $edit, t('Save translations'));
// Check for a form error on the textarea.
$form_class = $this
->xpath('//form[@id="locale-translate-edit-form"]//textarea/@class');
$this
->assertStringContainsString('error', $form_class[0]
->getText(), 'The string was rejected as unsafe.');
$this
->assertNoText(t('The string has been saved.'), 'The string was not saved.');
}
}
/**
* Tests translation search form.
*/
public function testStringSearch() {
// User to add and remove language.
$admin_user = $this
->drupalCreateUser([
'administer languages',
'access administration pages',
]);
// User to translate and delete string.
$translate_user = $this
->drupalCreateUser([
'translate interface',
'access administration pages',
]);
// Code for the language.
$langcode = 'xx';
// The English name for the language. This will be translated.
$name = $this
->randomMachineName(16);
// This will be the translation of $name.
$translation = $this
->randomMachineName(16);
// Add custom language.
$this
->drupalLogin($admin_user);
$edit = [
'predefined_langcode' => 'custom',
'langcode' => $langcode,
'label' => $name,
'direction' => LanguageInterface::DIRECTION_LTR,
];
$this
->drupalPostForm('admin/config/regional/language/add', $edit, t('Add custom language'));
$edit = [
'predefined_langcode' => 'custom',
'langcode' => 'yy',
'label' => $this
->randomMachineName(16),
'direction' => LanguageInterface::DIRECTION_LTR,
];
$this
->drupalPostForm('admin/config/regional/language/add', $edit, t('Add custom language'));
// Add string.
t($name, [], [
'langcode' => $langcode,
])
->render();
// Reset locale cache.
$this->container
->get('string_translation')
->reset();
$this
->drupalLogout();
// Search for the name.
$this
->drupalLogin($translate_user);
$search = [
'string' => $name,
'langcode' => $langcode,
'translation' => 'all',
];
$this
->drupalPostForm('admin/config/regional/translate', $search, t('Filter'));
// assertText() seems to remove the input field where $name always could be
// found, so this is not a false assert. See how assertNoText succeeds
// later.
$this
->assertText($name, 'Search found the string.');
// Ensure untranslated string doesn't appear if searching on 'only
// translated strings'.
$search = [
'string' => $name,
'langcode' => $langcode,
'translation' => 'translated',
];
$this
->drupalPostForm('admin/config/regional/translate', $search, t('Filter'));
$this
->assertText(t('No strings available.'), "Search didn't find the string.");
// Ensure untranslated string appears if searching on 'only untranslated
// strings'.
$search = [
'string' => $name,
'langcode' => $langcode,
'translation' => 'untranslated',
];
$this
->drupalPostForm('admin/config/regional/translate', $search, t('Filter'));
$this
->assertNoText(t('No strings available.'), 'Search found the string.');
// Add translation.
// Assume this is the only result, given the random name.
// We save the lid from the path.
$textarea = current($this
->xpath('//textarea'));
$lid = $textarea
->getAttribute('name');
$edit = [
$lid => $translation,
];
$this
->drupalPostForm('admin/config/regional/translate', $edit, t('Save translations'));
// Ensure translated string does appear if searching on 'only
// translated strings'.
$search = [
'string' => $translation,
'langcode' => $langcode,
'translation' => 'translated',
];
$this
->drupalPostForm('admin/config/regional/translate', $search, t('Filter'));
$this
->assertNoText(t('No strings available.'), 'Search found the translation.');
// Ensure translated source string doesn't appear if searching on 'only
// untranslated strings'.
$search = [
'string' => $name,
'langcode' => $langcode,
'translation' => 'untranslated',
];
$this
->drupalPostForm('admin/config/regional/translate', $search, t('Filter'));
$this
->assertText(t('No strings available.'), "Search didn't find the source string.");
// Ensure translated string doesn't appear if searching on 'only
// untranslated strings'.
$search = [
'string' => $translation,
'langcode' => $langcode,
'translation' => 'untranslated',
];
$this
->drupalPostForm('admin/config/regional/translate', $search, t('Filter'));
$this
->assertText(t('No strings available.'), "Search didn't find the translation.");
// Ensure translated string does appear if searching on the custom language.
$search = [
'string' => $translation,
'langcode' => $langcode,
'translation' => 'all',
];
$this
->drupalPostForm('admin/config/regional/translate', $search, t('Filter'));
$this
->assertNoText(t('No strings available.'), 'Search found the translation.');
// Ensure translated string doesn't appear if searching in System (English).
$search = [
'string' => $translation,
'langcode' => 'yy',
'translation' => 'all',
];
$this
->drupalPostForm('admin/config/regional/translate', $search, t('Filter'));
$this
->assertText(t('No strings available.'), "Search didn't find the translation.");
// Search for a string that isn't in the system.
$unavailable_string = $this
->randomMachineName(16);
$search = [
'string' => $unavailable_string,
'langcode' => $langcode,
'translation' => 'all',
];
$this
->drupalPostForm('admin/config/regional/translate', $search, t('Filter'));
$this
->assertText(t('No strings available.'), "Search didn't find the invalid string.");
}
/**
* Tests that only changed strings are saved customized when edited.
*/
public function testUICustomizedStrings() {
$user = $this
->drupalCreateUser([
'translate interface',
'administer languages',
'access administration pages',
]);
$this
->drupalLogin($user);
ConfigurableLanguage::createFromLangcode('de')
->save();
// Create test source string.
$string = $this->container
->get('locale.storage')
->createString([
'source' => $this
->randomMachineName(100),
'context' => $this
->randomMachineName(20),
])
->save();
// Create translation for new string and save it as non-customized.
$translation = $this->container
->get('locale.storage')
->createTranslation([
'lid' => $string->lid,
'language' => 'de',
'translation' => $this
->randomMachineName(100),
'customized' => 0,
])
->save();
// Reset locale cache.
$this->container
->get('string_translation')
->reset();
// Ensure non-customized translation string does appear if searching
// non-customized translation.
$search = [
'string' => $string
->getString(),
'langcode' => 'de',
'translation' => 'translated',
'customized' => '0',
];
$this
->drupalPostForm('admin/config/regional/translate', $search, t('Filter'));
$this
->assertText($translation
->getString(), 'Translation is found in search result.');
// Submit the translations without changing the translation.
$textarea = current($this
->xpath('//textarea'));
$lid = $textarea
->getAttribute('name');
$edit = [
$lid => $translation
->getString(),
];
$this
->drupalPostForm('admin/config/regional/translate', $edit, t('Save translations'));
// Ensure unchanged translation string does appear if searching
// non-customized translation.
$search = [
'string' => $string
->getString(),
'langcode' => 'de',
'translation' => 'translated',
'customized' => '0',
];
$this
->drupalPostForm('admin/config/regional/translate', $search, t('Filter'));
$this
->assertText($string
->getString(), 'Translation is not marked as customized.');
// Submit the translations with a new translation.
$textarea = current($this
->xpath('//textarea'));
$lid = $textarea
->getAttribute('name');
$edit = [
$lid => $this
->randomMachineName(100),
];
$this
->drupalPostForm('admin/config/regional/translate', $edit, t('Save translations'));
// Ensure changed translation string does appear if searching customized
// translation.
$search = [
'string' => $string
->getString(),
'langcode' => 'de',
'translation' => 'translated',
'customized' => '1',
];
$this
->drupalPostForm('admin/config/regional/translate', $search, t('Filter'));
$this
->assertText($string
->getString(), "Translation is marked as customized.");
}
}
Members
Name | Modifiers | Type | Description | Overrides |
---|---|---|---|---|
AssertHelperTrait:: |
protected static | function | Casts MarkupInterface objects into strings. | |
AssertLegacyTrait:: |
protected | function | Deprecated Scheduled for removal in Drupal 10.0.0. Use self::assertTrue() instead. | |
AssertLegacyTrait:: |
protected | function | Asserts whether an expected cache tag was present in the last response. | |
AssertLegacyTrait:: |
protected | function | Asserts that the element with the given CSS selector is not present. | |
AssertLegacyTrait:: |
protected | function | Asserts that the element with the given CSS selector is present. | |
AssertLegacyTrait:: |
protected | function | Deprecated Scheduled for removal in Drupal 10.0.0. Use self::assertEquals() instead. | |
AssertLegacyTrait:: |
protected | function | Passes if the raw text IS found escaped on the loaded page, fail otherwise. | |
AssertLegacyTrait:: |
protected | function | Asserts that a field exists with the given name or ID. | |
AssertLegacyTrait:: |
protected | function | Asserts that a field exists with the given ID and value. | |
AssertLegacyTrait:: |
protected | function | Asserts that a field exists with the given name and value. | |
AssertLegacyTrait:: |
protected | function | Asserts that a field exists in the current page by the given XPath. | |
AssertLegacyTrait:: |
protected | function | Asserts that a checkbox field in the current page is checked. | |
AssertLegacyTrait:: |
protected | function | Asserts that a field exists in the current page with a given Xpath result. | |
AssertLegacyTrait:: |
protected | function | Checks that current response header equals value. | |
AssertLegacyTrait:: |
protected | function | Deprecated Scheduled for removal in Drupal 10.0.0. Use self::assertSame() instead. | |
AssertLegacyTrait:: |
protected | function | Deprecated Scheduled for removal in Drupal 10.0.0. Use self::assertEquals() instead. | |
AssertLegacyTrait:: |
protected | function | Passes if a link with the specified label is found. | |
AssertLegacyTrait:: |
protected | function | Passes if a link containing a given href (part) is found. | |
AssertLegacyTrait:: |
protected | function | Asserts whether an expected cache tag was absent in the last response. | |
AssertLegacyTrait:: |
protected | function | Passes if the raw text is not found escaped on the loaded page. | |
AssertLegacyTrait:: |
protected | function | Asserts that a field does NOT exist with the given name or ID. | |
AssertLegacyTrait:: |
protected | function | Asserts that a field does not exist with the given ID and value. | |
AssertLegacyTrait:: |
protected | function | Asserts that a field does not exist with the given name and value. | |
AssertLegacyTrait:: |
protected | function | Asserts that a field does not exist or its value does not match, by XPath. | |
AssertLegacyTrait:: |
protected | function | Asserts that a checkbox field in the current page is not checked. | |
AssertLegacyTrait:: |
protected | function | Passes if a link with the specified label is not found. | |
AssertLegacyTrait:: |
protected | function | Passes if a link containing a given href (part) is not found. | |
AssertLegacyTrait:: |
protected | function | Asserts that a select option does NOT exist in the current page. | |
AssertLegacyTrait:: |
protected | function | Triggers a pass if the Perl regex pattern is not found in the raw content. | |
AssertLegacyTrait:: |
protected | function | Passes if the raw text IS not found on the loaded page, fail otherwise. | 1 |
AssertLegacyTrait:: |
protected | function | Deprecated Scheduled for removal in Drupal 10.0.0. Use self::assertNotEquals() instead. | |
AssertLegacyTrait:: |
protected | function | Passes if the page (with HTML stripped) does not contains the text. | 1 |
AssertLegacyTrait:: |
protected | function | Deprecated Scheduled for removal in Drupal 10.0.0. Use self::assertNotSame() instead. | |
AssertLegacyTrait:: |
protected | function | Passes if the text is found MORE THAN ONCE on the text version of the page. | |
AssertLegacyTrait:: |
protected | function | Asserts that a select option in the current page exists. | |
AssertLegacyTrait:: |
protected | function | Asserts that a select option with the visible text exists. | |
AssertLegacyTrait:: |
protected | function | Asserts that a select option in the current page is checked. | |
AssertLegacyTrait:: |
protected | function | Triggers a pass if the Perl regex pattern is found in the raw content. | |
AssertLegacyTrait:: |
protected | function | Passes if the raw text IS found on the loaded page, fail otherwise. | 1 |
AssertLegacyTrait:: |
protected | function | Asserts the page responds with the specified response code. | 1 |
AssertLegacyTrait:: |
protected | function | Passes if the page (with HTML stripped) contains the text. | 1 |
AssertLegacyTrait:: |
protected | function | Helper for assertText and assertNoText. | |
AssertLegacyTrait:: |
protected | function | Pass if the page title is the given string. | |
AssertLegacyTrait:: |
protected | function | Passes if the text is found ONLY ONCE on the text version of the page. | |
AssertLegacyTrait:: |
protected | function | Passes if the internal browser's URL matches the given path. | |
AssertLegacyTrait:: |
protected | function | Builds an XPath query. | |
AssertLegacyTrait:: |
protected | function | Helper: Constructs an XPath for the given set of attributes and value. | |
AssertLegacyTrait:: |
protected | function | Get all option elements, including nested options, in a select. | |
AssertLegacyTrait:: |
protected | function | Gets the current raw content. | |
AssertLegacyTrait:: |
protected | function | Deprecated Scheduled for removal in Drupal 10.0.0. Use self::assertTrue() instead. | |
AssertLegacyTrait:: |
protected | function | ||
BlockCreationTrait:: |
protected | function | Creates a block instance based on default settings. Aliased as: drupalPlaceBlock | |
BrowserHtmlDebugTrait:: |
protected | property | The Base URI to use for links to the output files. | |
BrowserHtmlDebugTrait:: |
protected | property | Class name for HTML output logging. | |
BrowserHtmlDebugTrait:: |
protected | property | Counter for HTML output logging. | |
BrowserHtmlDebugTrait:: |
protected | property | Counter storage for HTML output logging. | |
BrowserHtmlDebugTrait:: |
protected | property | Directory name for HTML output logging. | |
BrowserHtmlDebugTrait:: |
protected | property | HTML output output enabled. | |
BrowserHtmlDebugTrait:: |
protected | property | The file name to write the list of URLs to. | |
BrowserHtmlDebugTrait:: |
protected | property | HTML output test ID. | |
BrowserHtmlDebugTrait:: |
protected | function | Formats HTTP headers as string for HTML output logging. | |
BrowserHtmlDebugTrait:: |
protected | function | Returns headers in HTML output format. | 1 |
BrowserHtmlDebugTrait:: |
protected | function | Logs a HTML output message in a text file. | |
BrowserHtmlDebugTrait:: |
protected | function | Creates the directory to store browser output. | |
BrowserTestBase:: |
protected | property | The base URL. | |
BrowserTestBase:: |
protected | property | The config importer that can be used in a test. | |
BrowserTestBase:: |
protected | property | An array of custom translations suitable for drupal_rewrite_settings(). | |
BrowserTestBase:: |
protected | property | The database prefix of this test run. | |
BrowserTestBase:: |
protected | property | Mink session manager. | |
BrowserTestBase:: |
protected | property | ||
BrowserTestBase:: |
protected | property | 1 | |
BrowserTestBase:: |
protected | property | The original container. | |
BrowserTestBase:: |
protected | property | The original array of shutdown function callbacks. | |
BrowserTestBase:: |
protected | property | ||
BrowserTestBase:: |
protected | property | The profile to install as a basis for testing. | 39 |
BrowserTestBase:: |
protected | property | The app root. | |
BrowserTestBase:: |
protected | property | Browser tests are run in separate processes to prevent collisions between code that may be loaded by tests. | |
BrowserTestBase:: |
protected | property | Time limit in seconds for the test. | |
BrowserTestBase:: |
protected | property | The translation file directory for the test environment. | |
BrowserTestBase:: |
protected | function | Clean up the Simpletest environment. | |
BrowserTestBase:: |
protected | function | Configuration accessor for tests. Returns non-overridden configuration. | |
BrowserTestBase:: |
protected | function | Translates a CSS expression to its XPath equivalent. | |
BrowserTestBase:: |
protected | function | Gets the value of an HTTP response header. | |
BrowserTestBase:: |
protected | function | Returns all response headers. | |
BrowserTestBase:: |
public static | function | Ensures test files are deletable. | |
BrowserTestBase:: |
protected | function | Gets an instance of the default Mink driver. | |
BrowserTestBase:: |
protected | function | Gets the JavaScript drupalSettings variable for the currently-loaded page. | 1 |
BrowserTestBase:: |
protected | function | Obtain the HTTP client for the system under test. | |
BrowserTestBase:: |
protected | function | Get the Mink driver args from an environment variable, if it is set. Can be overridden in a derived class so it is possible to use a different value for a subset of tests, e.g. the JavaScript tests. | 1 |
BrowserTestBase:: |
protected | function | Helper function to get the options of select field. | |
BrowserTestBase:: |
protected | function |
Provides a Guzzle middleware handler to log every response received. Overrides BrowserHtmlDebugTrait:: |
|
BrowserTestBase:: |
public | function | Returns Mink session. | |
BrowserTestBase:: |
protected | function | Get session cookies from current session. | |
BrowserTestBase:: |
protected | function |
Retrieves the current calling line in the class under test. Overrides BrowserHtmlDebugTrait:: |
|
BrowserTestBase:: |
protected | function | Visits the front page when initializing Mink. | 3 |
BrowserTestBase:: |
protected | function | Initializes Mink sessions. | 1 |
BrowserTestBase:: |
public | function | Installs Drupal into the Simpletest site. | 1 |
BrowserTestBase:: |
protected | function | Registers additional Mink sessions. | |
BrowserTestBase:: |
protected | function | 475 | |
BrowserTestBase:: |
protected | function | 3 | |
BrowserTestBase:: |
protected | function | Transforms a nested array into a flat array suitable for drupalPostForm(). | |
BrowserTestBase:: |
protected | function | Performs an xpath search on the contents of the internal browser. | |
BrowserTestBase:: |
public | function | 1 | |
BrowserTestBase:: |
public | function | Prevents serializing any properties. | |
ConfigTestTrait:: |
protected | function | Returns a ConfigImporter object to import test configuration. | |
ConfigTestTrait:: |
protected | function | Copies configuration objects from source storage to target storage. | |
ContentTypeCreationTrait:: |
protected | function | Creates a custom content type based on default settings. Aliased as: drupalCreateContentType | 1 |
FunctionalTestSetupTrait:: |
protected | property | The flag to set 'apcu_ensure_unique_prefix' setting. | 1 |
FunctionalTestSetupTrait:: |
protected | property | The class loader to use for installation and initialization of setup. | |
FunctionalTestSetupTrait:: |
protected | property | The config directories used in this test. | |
FunctionalTestSetupTrait:: |
protected | property | The "#1" admin user. | |
FunctionalTestSetupTrait:: |
protected | function | Execute the non-interactive installer. | 1 |
FunctionalTestSetupTrait:: |
protected | function | Returns all supported database driver installer objects. | |
FunctionalTestSetupTrait:: |
protected | function | Initialize various configurations post-installation. | 2 |
FunctionalTestSetupTrait:: |
protected | function | Initializes the kernel after installation. | |
FunctionalTestSetupTrait:: |
protected | function | Initialize settings created during install. | |
FunctionalTestSetupTrait:: |
protected | function | Initializes user 1 for the site to be installed. | |
FunctionalTestSetupTrait:: |
protected | function | Installs the default theme defined by `static::$defaultTheme` when needed. | |
FunctionalTestSetupTrait:: |
protected | function | Install modules defined by `static::$modules`. | 1 |
FunctionalTestSetupTrait:: |
protected | function | Returns the parameters that will be used when Simpletest installs Drupal. | 9 |
FunctionalTestSetupTrait:: |
protected | function | Prepares the current environment for running the test. | 23 |
FunctionalTestSetupTrait:: |
protected | function | Creates a mock request and sets it on the generator. | |
FunctionalTestSetupTrait:: |
protected | function | Prepares site settings and services before installation. | 2 |
FunctionalTestSetupTrait:: |
protected | function | Resets and rebuilds the environment after setup. | |
FunctionalTestSetupTrait:: |
protected | function | Rebuilds \Drupal::getContainer(). | |
FunctionalTestSetupTrait:: |
protected | function | Resets all data structures after having enabled new modules. | |
FunctionalTestSetupTrait:: |
protected | function | Changes parameters in the services.yml file. | |
FunctionalTestSetupTrait:: |
protected | function | Sets up the base URL based upon the environment variable. | |
FunctionalTestSetupTrait:: |
protected | function | Rewrites the settings.php file of the test site. | |
LocaleTranslationUiTest:: |
protected | property |
The theme to install as the default for testing. Overrides BrowserTestBase:: |
|
LocaleTranslationUiTest:: |
public static | property |
Modules to enable. Overrides BrowserTestBase:: |
|
LocaleTranslationUiTest:: |
public | function | Enable interface translation to English. | |
LocaleTranslationUiTest:: |
public | function | Adds a language and checks that the JavaScript translation files are properly created and rebuilt on deletion. | |
LocaleTranslationUiTest:: |
public | function | Tests translation search form. | |
LocaleTranslationUiTest:: |
public | function | Adds a language and tests string translation by users with the appropriate permissions. | |
LocaleTranslationUiTest:: |
public | function | Tests the validation of the translation input. | |
LocaleTranslationUiTest:: |
public | function | Tests that only changed strings are saved customized when edited. | |
NodeCreationTrait:: |
protected | function | Creates a node based on default settings. Aliased as: drupalCreateNode | |
NodeCreationTrait:: |
public | function | Get a node from the database based on its title. Aliased as: drupalGetNodeByTitle | |
PhpunitCompatibilityTrait:: |
public | function | Returns a mock object for the specified class using the available method. | |
PhpunitCompatibilityTrait:: |
public | function | Compatibility layer for PHPUnit 6 to support PHPUnit 4 code. | |
RandomGeneratorTrait:: |
protected | property | The random generator. | |
RandomGeneratorTrait:: |
protected | function | Gets the random generator for the utility methods. | |
RandomGeneratorTrait:: |
protected | function | Generates a unique random string containing letters and numbers. | 1 |
RandomGeneratorTrait:: |
public | function | Generates a random PHP object. | |
RandomGeneratorTrait:: |
public | function | Generates a pseudo-random string of ASCII characters of codes 32 to 126. | |
RandomGeneratorTrait:: |
public | function | Callback for random string validation. | |
RefreshVariablesTrait:: |
protected | function | Refreshes in-memory configuration and state information. | 3 |
SessionTestTrait:: |
protected | property | The name of the session cookie. | |
SessionTestTrait:: |
protected | function | Generates a session cookie name. | |
SessionTestTrait:: |
protected | function | Returns the session name in use on the child site. | |
StorageCopyTrait:: |
protected static | function | Copy the configuration from one storage to another and remove stale items. | |
TestRequirementsTrait:: |
private | function | Checks missing module requirements. | |
TestRequirementsTrait:: |
protected | function | Check module requirements for the Drupal use case. | 1 |
TestRequirementsTrait:: |
protected static | function | Returns the Drupal root directory. | |
TestSetupTrait:: |
protected static | property | An array of config object names that are excluded from schema checking. | |
TestSetupTrait:: |
protected | property | The dependency injection container used in the test. | |
TestSetupTrait:: |
protected | property | The DrupalKernel instance used in the test. | |
TestSetupTrait:: |
protected | property | The site directory of the original parent site. | |
TestSetupTrait:: |
protected | property | The private file directory for the test environment. | |
TestSetupTrait:: |
protected | property | The public file directory for the test environment. | |
TestSetupTrait:: |
protected | property | The site directory of this test run. | |
TestSetupTrait:: |
protected | property | Set to TRUE to strict check all configuration saved. | 2 |
TestSetupTrait:: |
protected | property | The temporary file directory for the test environment. | |
TestSetupTrait:: |
protected | property | The test run ID. | |
TestSetupTrait:: |
protected | function | Changes the database connection to the prefixed one. | |
TestSetupTrait:: |
protected | function | Gets the config schema exclusions for this test. | |
TestSetupTrait:: |
public static | function | Returns the database connection to the site running Simpletest. | |
TestSetupTrait:: |
protected | function | Generates a database prefix for running tests. | 2 |
UiHelperTrait:: |
protected | property | The current user logged in using the Mink controlled browser. | |
UiHelperTrait:: |
protected | property | The number of meta refresh redirects to follow, or NULL if unlimited. | |
UiHelperTrait:: |
protected | property | The number of meta refresh redirects followed during ::drupalGet(). | |
UiHelperTrait:: |
public | function | Returns WebAssert object. | 1 |
UiHelperTrait:: |
protected | function | Builds an a absolute URL from a system path or a URL object. | |
UiHelperTrait:: |
protected | function | Checks for meta refresh tag and if found call drupalGet() recursively. | |
UiHelperTrait:: |
protected | function | Clicks the element with the given CSS selector. | |
UiHelperTrait:: |
protected | function | Follows a link by complete name. | |
UiHelperTrait:: |
protected | function | Searches elements using a CSS selector in the raw content. | |
UiHelperTrait:: |
protected | function | Retrieves a Drupal path or an absolute path. | 3 |
UiHelperTrait:: |
protected | function | Logs in a user using the Mink controlled browser. | |
UiHelperTrait:: |
protected | function | Logs a user out of the Mink controlled browser and confirms. | |
UiHelperTrait:: |
protected | function | Executes a form submission. | |
UiHelperTrait:: |
protected | function | Returns whether a given user account is logged in. | |
UiHelperTrait:: |
protected | function | Takes a path and returns an absolute path. | |
UiHelperTrait:: |
protected | function | Retrieves the plain-text content from the current page. | |
UiHelperTrait:: |
protected | function | Get the current URL from the browser. | |
UiHelperTrait:: |
protected | function | Prepare for a request to testing site. | 1 |
UiHelperTrait:: |
protected | function | Fills and submits a form. | |
UserCreationTrait:: |
protected | function | Checks whether a given list of permission names is valid. | |
UserCreationTrait:: |
protected | function | Creates an administrative role. | |
UserCreationTrait:: |
protected | function | Creates a role with specified permissions. Aliased as: drupalCreateRole | |
UserCreationTrait:: |
protected | function | Create a user with a given set of permissions. Aliased as: drupalCreateUser | |
UserCreationTrait:: |
protected | function | Grant permissions to a user role. | |
UserCreationTrait:: |
protected | function | Switch the current logged in user. | |
UserCreationTrait:: |
protected | function | Creates a random user account and sets it as current user. | |
XdebugRequestTrait:: |
protected | function | Adds xdebug cookies, from request setup. |