class ConfigureAndExecuteTest
Tests that a rule can be configured and triggered when a node is edited.
@group RulesUi
Hierarchy
- class \Drupal\Tests\BrowserTestBase extends \PHPUnit\Framework\TestCase uses \Drupal\Core\Test\FunctionalTestSetupTrait, \Drupal\Tests\UiHelperTrait, \Drupal\Core\Test\TestSetupTrait, \Drupal\Tests\block\Traits\BlockCreationTrait, \Drupal\FunctionalTests\AssertLegacyTrait, \Drupal\Tests\RandomGeneratorTrait, \Drupal\Tests\node\Traits\NodeCreationTrait, \Drupal\Tests\node\Traits\ContentTypeCreationTrait, \Drupal\Tests\ConfigTestTrait, \Drupal\Tests\TestRequirementsTrait, \Drupal\Tests\user\Traits\UserCreationTrait, \Drupal\Tests\XdebugRequestTrait, \Drupal\Tests\Traits\PhpUnitWarnings, \Drupal\Tests\PhpUnitCompatibilityTrait, \Symfony\Bridge\PhpUnit\ExpectDeprecationTrait, \Drupal\Tests\ExtensionListTestTrait
- class \Drupal\Tests\rules\Functional\RulesBrowserTestBase extends \Drupal\Tests\BrowserTestBase
- class \Drupal\Tests\rules\Functional\ConfigureAndExecuteTest extends \Drupal\Tests\rules\Functional\RulesBrowserTestBase
- class \Drupal\Tests\rules\Functional\RulesBrowserTestBase extends \Drupal\Tests\BrowserTestBase
Expanded class hierarchy of ConfigureAndExecuteTest
File
-
tests/
src/ Functional/ ConfigureAndExecuteTest.php, line 13
Namespace
Drupal\Tests\rules\FunctionalView source
class ConfigureAndExecuteTest extends RulesBrowserTestBase {
/**
* {@inheritdoc}
*/
protected static $modules = [
'rules',
];
/**
* We use the minimal profile because we want to test local action links.
*
* @var string
*/
protected $profile = 'minimal';
/**
* A user with administration permissions.
*
* @var \Drupal\user\UserInterface
*/
protected $account;
/**
* The entity storage for Rules config entities.
*
* @var \Drupal\Core\Entity\EntityStorageInterface
*/
protected $storage;
/**
* The Rules expression manager.
*
* @var \Drupal\rules\Engine\ExpressionManagerInterface
*/
protected $expressionManager;
/**
* {@inheritdoc}
*/
protected function setUp() : void {
parent::setUp();
$this->storage = $this->container
->get('entity_type.manager')
->getStorage('rules_reaction_rule');
$this->expressionManager = $this->container
->get('plugin.manager.rules_expression');
// Create an article content type that we will use for testing.
$type = $this->container
->get('entity_type.manager')
->getStorage('node_type')
->create([
'type' => 'article',
'name' => 'Article',
]);
$type->save();
// Create the user with all needed permissions.
$this->account = $this->drupalCreateUser([
'create article content',
'edit any article content',
'administer rules',
'administer site configuration',
]);
$this->drupalLogin($this->account);
// Create a named role for use in conditions and actions.
$this->createRole([
'administer nodes',
], 'test-editor', 'Test Editor');
}
/**
* Helper function to create a reaction rule.
*
* @param string $label
* The label for the new rule.
* @param string $machine_name
* The internal machine-readable name.
* @param string $event
* The name of the event to react on.
* @param string $description
* Optional description for the reaction rule.
*
* @return ReactionRule
* The rule object created.
*/
protected function createRule($label, $machine_name, $event, $description = '') {
$this->drupalGet('admin/config/workflow/rules');
$this->clickLink('Add reaction rule');
$this->fillField('Label', $label);
$this->fillField('Machine-readable name', $machine_name);
$this->fillField('React on event', $event);
$this->fillField('Description', $description);
$this->pressButton('Save');
$this->assertSession()
->pageTextContains('Reaction rule ' . $label . ' has been created');
$config_factory = $this->container
->get('config.factory');
$rule = $config_factory->get('rules.reaction.' . $machine_name);
return $rule;
}
/**
* Tests creation of a rule and then triggering its execution.
*/
public function testConfigureAndExecute() {
// Set up a rule that will show a system message if the title of a node
// matches "Test title".
$this->createRule('Test rule', 'test_rule', 'rules_entity_presave:node');
$this->clickLink('Add condition');
$this->fillField('Condition', 'rules_data_comparison');
$this->pressButton('Continue');
$this->fillField('context_definitions[data][setting]', 'node.title.0.value');
$this->fillField('context_definitions[value][setting]', 'Test title');
$this->pressButton('Save');
$this->clickLink('Add action');
$this->fillField('Action', 'rules_system_message');
$this->pressButton('Continue');
$this->fillField('context_definitions[message][setting]', 'Title matched "Test title"!');
$this->fillField('context_definitions[type][setting]', 'status');
$this->pressButton('Save');
// One more save to permanently store the rule.
$this->pressButton('Save');
/** @var \Drupal\Tests\WebAssert $assert */
$assert = $this->assertSession();
// Add a node now and check if our rule triggers.
$this->drupalGet('node/add/article');
$this->fillField('Title', 'Test title');
$this->pressButton('Save');
$assert->pageTextContains('Title matched "Test title"!');
// Add a second node with the same title and check the rule triggers again.
// This tests that the cache update (or non-update) works OK.
// @see https://www.drupal.org/project/rules/issues/3108494
$this->drupalGet('node/add/article');
$this->fillField('Title', 'Test title');
$this->pressButton('Save');
$assert->pageTextContains('Title matched "Test title"!');
// Disable rule and make sure it doesn't get triggered.
$this->drupalGet('admin/config/workflow/rules');
$this->clickLink('Disable');
$this->drupalGet('node/add/article');
$this->fillField('Title', 'Test title');
$this->pressButton('Save');
$assert->pageTextNotContains('Title matched "Test title"!');
// Re-enable the rule and make sure it gets triggered again.
$this->drupalGet('admin/config/workflow/rules');
$this->clickLink('Enable');
$this->drupalGet('node/add/article');
$this->fillField('Title', 'Test title');
$this->pressButton('Save');
$assert->pageTextContains('Title matched "Test title"!');
// Edit the rule and negate the condition.
$this->drupalGet('admin/config/workflow/rules/reactions/edit/test_rule');
$this->clickLink('Edit', 0);
$this->getSession()
->getPage()
->checkField('negate');
$this->pressButton('Save');
// One more save to permanently store the rule.
$this->pressButton('Save');
// Create node with same title and check that the message is not shown.
$this->drupalGet('node/add/article');
$this->fillField('Title', 'Test title');
$this->pressButton('Save');
$assert->pageTextNotContains('Title matched "Test title"!');
}
/**
* Tests adding an event and then triggering its execution.
*/
public function testAddEventAndExecute() {
// Create an article.
$node = $this->drupalCreateNode([
'type' => 'article',
]);
// Create a rule with a single event and with an action.
$message = 'Rule is triggered';
$rule = $this->expressionManager
->createRule();
$rule->addAction('rules_system_message', ContextConfig::create()->setValue('message', $message)
->setValue('type', 'status'));
$config_entity = $this->storage
->create([
'id' => 'test_rule',
'label' => 'Test rule',
'events' => [
[
'event_name' => 'rules_entity_insert:node--article',
],
],
'expression' => $rule->getConfiguration(),
]);
$config_entity->save();
$this->drupalLogin($this->account);
/** @var \Drupal\Tests\WebAssert $assert */
$assert = $this->assertSession();
// Now add an event using the UI.
$this->drupalGet('admin/config/workflow/rules/reactions/edit/test_rule');
// Go to "Add event" page.
$this->clickLink('Add event');
$assert->pageTextContains('Add event to Test rule');
$assert->pageTextContains('Event selection');
$assert->pageTextContains('React on event');
// Select an event.
$this->findField('events[0][event_name]')
->selectOption('rules_entity_update:node');
$this->pressButton('Add');
// Select bundle 'article'.
$this->findField('bundle')
->selectOption('article');
$this->pressButton('Add');
// Update an article and assert that the event is triggered.
$this->drupalGet('node/' . $node->id() . '/edit/');
$this->submitForm([], 'Save');
$assert->pageTextContains($message);
}
/**
* Tests deleting an event and then triggering its execution.
*/
public function testDeleteEventAndExecute() {
// Create a rule with two events and an action.
$message = 'Rule is triggered';
$rule = $this->expressionManager
->createRule();
$rule->addAction('rules_system_message', ContextConfig::create()->setValue('message', $message)
->setValue('type', 'status'));
$config_entity = $this->storage
->create([
'id' => 'test_rule',
'label' => 'Test rule',
'events' => [
[
'event_name' => 'rules_entity_insert:node',
],
[
'event_name' => 'rules_entity_update:node',
],
],
'expression' => $rule->getConfiguration(),
]);
$config_entity->save();
$this->drupalLogin($this->account);
/** @var \Drupal\Tests\WebAssert $assert */
$assert = $this->assertSession();
// Create a node to ensure that the rule is triggered and the message is
// displayed when creating a node (the first of the two events).
$this->drupalGet('node/add/article');
$this->submitForm([
'title[0][value]' => 'Foo',
], 'Save');
$assert->pageTextContains($message);
// Delete an event using the UI.
$this->drupalGet('admin/config/workflow/rules/reactions/edit/test_rule');
// Click delete button for the first event.
$this->clickLinkByHref('event-delete/rules_entity_insert');
// Assert we are on the delete page.
$assert->pageTextContains('Are you sure you want to delete the event After saving a new content item entity from Test rule?');
// And confirm the delete.
$this->pressButton('Delete');
$assert->pageTextContains('Deleted event After saving a new content item entity from Test rule.');
// Create a node and assert that the event is not triggered.
$this->drupalGet('node/add/article');
$this->submitForm([
'title[0][value]' => 'Bar',
], 'Save');
$node = $this->drupalGetNodeByTitle('Bar');
$assert->pageTextNotContains($message);
// Update it and assert that the message now does get displayed.
$this->drupalGet('node/' . $node->id() . '/edit/');
$this->submitForm([], 'Save');
$assert->pageTextContains($message);
}
/**
* Tests creating and altering two rules reacting on the same event.
*/
public function testTwoRulesSameEvent() {
/** @var \Drupal\Tests\WebAssert $assert */
$assert = $this->assertSession();
// Create a rule that will show a system message when updating a node whose
// title contains "Two Rules Same Event".
$rule1 = $this->expressionManager
->createRule();
// Add the condition to the rule.
$rule1->addCondition('rules_data_comparison', ContextConfig::create()->map('data', 'node.title.value')
->setValue('operation', 'contains')
->setValue('value', 'Two Rules Same Event'));
// Add the action to the rule.
$message1 = 'RULE ONE is triggered';
$rule1->addAction('rules_system_message', ContextConfig::create()->setValue('message', $message1)
->setValue('type', 'status'));
// Add the event and save the rule configuration.
$config_entity = $this->storage
->create([
'id' => 'rule1',
'label' => 'Rule One',
'events' => [
[
'event_name' => 'rules_entity_presave:node',
],
],
'expression' => $rule1->getConfiguration(),
]);
$config_entity->save();
// Add a node and check that rule 1 is triggered.
$this->drupalGet('node/add/article');
$this->submitForm([
'title[0][value]' => 'Two Rules Same Event',
], 'Save');
$node = $this->drupalGetNodeByTitle('Two Rules Same Event');
$assert->pageTextContains($message1);
// Repeat to create a second similar rule.
$rule2 = $this->expressionManager
->createRule();
// Add the condition to the rule.
$rule2->addCondition('rules_data_comparison', ContextConfig::create()->map('data', 'node.title.value')
->setValue('operation', 'contains')
->setValue('value', 'Two Rules Same Event'));
// Add the action to the rule.
$message2 = 'RULE TWO is triggered';
$rule2->addAction('rules_system_message', ContextConfig::create()->setValue('message', $message2)
->setValue('type', 'status'));
// Add the event and save the rule configuration.
$config_entity = $this->storage
->create([
'id' => 'rule2',
'label' => 'Rule Two',
'events' => [
[
'event_name' => 'rules_entity_presave:node',
],
],
'expression' => $rule2->getConfiguration(),
]);
$config_entity->save();
// Edit the node and check that both rules are triggered.
$this->drupalGet('node/' . $node->id() . '/edit/');
$this->submitForm([], 'Save');
$assert->pageTextContains($message1);
$assert->pageTextContains($message2);
// Disable rule 2.
$this->drupalGet('admin/config/workflow/rules');
$this->clickLinkByHref('disable/rule2');
// Edit the node and check that only rule 1 is triggered.
$this->drupalGet('node/' . $node->id() . '/edit/');
$this->submitForm([], 'Save');
$assert->pageTextContains($message1);
$assert->pageTextNotContains($message2);
// Re-enable rule 2.
$this->drupalGet('admin/config/workflow/rules');
$this->clickLinkByHref('enable/rule2');
// Check that both rules are triggered.
$this->drupalGet('node/' . $node->id() . '/edit/');
$this->submitForm([], 'Save');
$assert->pageTextContains($message1);
$assert->pageTextContains($message2);
// Edit rule 1 and change the message text in the action.
$message1updated = 'RULE ONE has a new message.';
$this->drupalGet('admin/config/workflow/rules/reactions/edit/rule1');
$this->clickLink('Edit', 1);
$this->fillField('context_definitions[message][setting]', $message1updated);
// Save the action then save the rule.
$this->pressButton('Save');
$this->pressButton('Save');
// Check that rule 1 now shows the updated text message.
$this->drupalGet('node/' . $node->id() . '/edit/');
$this->submitForm([], 'Save');
$assert->pageTextNotContains($message1);
$assert->pageTextContains($message1updated);
$assert->pageTextContains($message2);
// Delete rule 1.
$this->drupalGet('admin/config/workflow/rules');
$this->clickLinkByHref('delete/rule1');
$this->pressButton('Delete');
// Check that only Rule 2's message is shown.
$this->drupalGet('node/' . $node->id() . '/edit/');
$this->submitForm([], 'Save');
$assert->pageTextNotContains($message1);
$assert->pageTextNotContains($message1updated);
$assert->pageTextContains($message2);
// Disable rule 2.
$this->drupalGet('admin/config/workflow/rules');
$this->clickLinkByHref('disable/rule2');
// Check that neither rule's message is shown.
$this->drupalGet('node/' . $node->id() . '/edit/');
$this->submitForm([], 'Save');
$assert->pageTextNotContains($message1);
$assert->pageTextNotContains($message1updated);
$assert->pageTextNotContains($message2);
}
/**
* Tests user input in context form for 'multiple' valued context variables.
*/
public function testMultipleInputContext() {
// Set up a rule. The event is not relevant, we just want a rule to use.
// Calling $rule = $this->createRule('Test Multiple Input via UI',
// 'test_rule', 'rules_entity_insert:node') works locally but fails
// $this->assertEquals($expected_config_value, $to) on drupal.org with
// 'null does not match expected type "array".', hence revert to the
// long-hand way of creating the rule.
$this->drupalGet('admin/config/workflow/rules');
$this->clickLink('Add reaction rule');
$this->fillField('Label', 'Test Multiple Input via UI');
$this->fillField('Machine-readable name', 'test_rule');
$this->fillField('React on event', 'rules_entity_insert:node');
$this->pressButton('Save');
// Add action rules_send_email because the 'to' field has 'multiple = TRUE'
// rendered as a textarea that we can use for this test.
$this->clickLink('Add action');
$this->fillField('Action', 'rules_send_email');
$this->pressButton('Continue');
$suboptimal_user_input = [
" \r\nwhitespace at beginning of input\r\n",
"text\r\n",
"trailing space \r\n",
"\rleading terminator\r\n",
" leading space\r\n",
"multiple words, followed by primitive values\r\n",
"0\r\n",
"0.0\r\n",
"128\r\n",
" false\r\n",
"true \r\n",
"null\r\n",
"terminator r\r",
"two empty lines\n\r\n\r",
"terminator n\n",
"terminator nr\n\r",
"whitespace at end of input\r\n \r\n",
];
$this->fillField('context_definitions[to][setting]', implode($suboptimal_user_input));
// Set the other required fields. These play no part in the test.
$this->fillField('context_definitions[subject][setting]', 'Hello');
$this->fillField('context_definitions[message][setting]', 'Dear Heart');
$this->pressButton('Save');
// One more save to permanently store the rule.
$this->pressButton('Save');
// Now examine the config to ensure the user input was parsed properly
// and that blank lines, leading and trailing whitespace, and wrong line
// terminators were removed.
$expected_config_value = [
"whitespace at beginning of input",
"text",
"trailing space",
"leading terminator",
"leading space",
"multiple words, followed by primitive values",
"0",
"0.0",
"128",
"false",
"true",
"null",
"terminator r",
"two empty lines",
"terminator n",
"terminator nr",
"whitespace at end of input",
];
// Need to get the $rule again, as the existing $rule does not have the
// changes added above and $rule->get('expression.actions...) is empty.
// @todo Is there a way to refresh $rule and not have to get it again?
$config_factory = $this->container
->get('config.factory');
$config_factory->clearStaticCache();
$rule = $config_factory->get('rules.reaction.test_rule');
$to = $rule->get('expression.actions.actions.0.context_values.to');
$this->assertEquals($expected_config_value, $to);
}
/**
* Tests the implementation of assignment restriction in context form.
*/
public function testAssignmentRestriction() {
// Create a rule.
$rule = $this->expressionManager
->createRule();
// Add a condition which is restricted to selector for 'data', restricted to
// input for 'operation' but unrestricted on 'value'.
$condition1 = $this->expressionManager
->createCondition('rules_data_comparison');
$rule->addExpressionObject($condition1);
// Add an action which is unrestricted on 'message' and 'type' but is
// restricted to input for 'repeat'.
$action1 = $this->expressionManager
->createAction('rules_system_message');
$rule->addExpressionObject($action1);
// As the ContextFormTrait is action/condition agnostic it is not necessary
// to check an action restricted by selector because the condition covers
// this. Save the rule to config. No event needed.
$config_entity = $this->storage
->create([
'id' => 'test_rule',
'expression' => $rule->getConfiguration(),
]);
$config_entity->save();
/** @var \Drupal\Tests\WebAssert $assert */
$assert = $this->assertSession();
// Display the rule edit page to show the actions and conditions.
$this->drupalGet('admin/config/workflow/rules/reactions/edit/test_rule');
$assert->statusCodeEquals(200);
// Edit the condition and assert that the page loads correctly.
$this->drupalGet('admin/config/workflow/rules/reactions/edit/test_rule/edit/' . $condition1->getUuid());
$assert->statusCodeEquals(200);
// Check that a switch button is not shown for 'data' and that the field is
// an autocomplete selector field not plain text entry.
$assert->buttonNotExists('edit-context-definitions-data-switch-button');
$assert->elementExists('xpath', '//input[@id="edit-context-definitions-data-setting" and contains(@class, "rules-autocomplete")]');
// Check that a switch button is not shown for 'operation'.
$assert->buttonNotExists('edit-context-definitions-operation-switch-button');
// Check that a switch button is shown for 'value' and that the default
// field is plain text entry not an autocomplete selector field.
$assert->buttonExists('edit-context-definitions-value-switch-button');
$assert->elementExists('xpath', '//input[@id="edit-context-definitions-value-setting" and not(contains(@class, "rules-autocomplete"))]');
// Edit the action and assert that page loads correctly.
$this->drupalGet('admin/config/workflow/rules/reactions/edit/test_rule/edit/' . $action1->getUuid());
$assert->statusCodeEquals(200);
// Check that a switch button is shown for 'message' and that the field is a
// plain text entry field not an autocomplete selector field.
$assert->buttonExists('edit-context-definitions-message-switch-button');
$assert->elementExists('xpath', '//input[@id="edit-context-definitions-message-setting" and not(contains(@class, "rules-autocomplete"))]');
// Check that a switch button is shown for 'type'.
$assert->buttonExists('edit-context-definitions-type-switch-button');
// Check that a switch button is not shown for 'repeat'.
$assert->buttonNotExists('edit-context-definitions-repeat-switch-button');
}
/**
* Tests upcasting in a condition.
*/
public function testUpcastInCondition() {
/** @var \Drupal\Tests\WebAssert $assert */
$assert = $this->assertSession();
// Create a rule.
$rule = $this->expressionManager
->createRule();
// Add a condition to check if the user has the 'test-editor' role.
$rule->addCondition('rules_user_has_role', ContextConfig::create()->map('user', '@user.current_user_context:current_user')
->setValue('roles', [
'test-editor',
]));
// Add an action to display a system message.
$message = '-- RULE to test upcasting in condition --';
$rule->addAction('rules_system_message', ContextConfig::create()->setValue('message', $message)
->setValue('type', 'status'));
// Set the even to User Login and save the configuration.
$expr_id = 'test_upcast';
$config_entity = $this->storage
->create([
'id' => $expr_id,
'expression' => $rule->getConfiguration(),
'events' => [
[
'event_name' => 'rules_user_login',
],
],
]);
$config_entity->save();
// Log in and check that the rule is triggered.
$this->drupalLogin($this->account);
$assert->pageTextNotContains($message);
// Add the required role to the user.
$this->account
->addRole('test-editor');
$this->account
->save();
// Log out and in and check that the rule is triggered.
$this->drupalLogout();
$this->drupalLogin($this->account);
$assert->pageTextContains($message);
// Remove the role from the user.
$this->account
->removeRole('test-editor');
$this->account
->save();
// Log out and in and check that the rule is not triggered.
$this->drupalLogout();
$this->drupalLogin($this->account);
$assert->pageTextNotContains($message);
}
/**
* Tests upcasting in an action.
*/
public function testUpcastInAction() {
// Log in.
$this->drupalLogin($this->account);
// Create a rule.
$rule = $this->expressionManager
->createRule();
// Add an action to add 'Editor' role to the current user. The role value
// here is just the machine name as text, and will be upcast to the full
// role object when the rule is triggered.
$rule->addAction('rules_user_role_add', ContextConfig::create()->map('user', '@user.current_user_context:current_user')
->setValue('roles', [
'test-editor',
]));
// Save the configuration.
$expr_id = 'test_upcast';
$config_entity = $this->storage
->create([
'id' => $expr_id,
'expression' => $rule->getConfiguration(),
'events' => [
[
'event_name' => 'rules_entity_insert:node',
],
],
]);
$config_entity->save();
// Check that the user does not have the 'test-editor' role.
$this->assertEmpty(array_intersect([
'test-editor',
], $this->account
->getRoles()));
// Create an article, which will trigger the rule, and add the role.
$this->drupalCreateNode([
'type' => 'article',
'title' => 'Upcasting role in action',
]);
// Reload the user account.
$account = User::load($this->account
->id());
// Check that the role has been added to the user.
$this->assertNotEmpty(array_intersect([
'test-editor',
], $account->getRoles()));
}
}
Members
Title Sort descending | Deprecated | Modifiers | Object type | Summary | Member alias | Overriden Title | Overrides |
---|---|---|---|---|---|---|---|
AssertLegacyTrait::assert | Deprecated | protected | function | ||||
AssertLegacyTrait::assertCacheTag | Deprecated | protected | function | Asserts whether an expected cache tag was present in the last response. | |||
AssertLegacyTrait::assertElementNotPresent | Deprecated | protected | function | Asserts that the element with the given CSS selector is not present. | |||
AssertLegacyTrait::assertElementPresent | Deprecated | protected | function | Asserts that the element with the given CSS selector is present. | |||
AssertLegacyTrait::assertEqual | Deprecated | protected | function | ||||
AssertLegacyTrait::assertEscaped | Deprecated | protected | function | Passes if the raw text IS found escaped on the loaded page, fail otherwise. | |||
AssertLegacyTrait::assertField | Deprecated | protected | function | Asserts that a field exists with the given name or ID. | |||
AssertLegacyTrait::assertFieldById | Deprecated | protected | function | Asserts that a field exists with the given ID and value. | |||
AssertLegacyTrait::assertFieldByName | Deprecated | protected | function | Asserts that a field exists with the given name and value. | |||
AssertLegacyTrait::assertFieldByXPath | Deprecated | protected | function | Asserts that a field exists in the current page by the given XPath. | |||
AssertLegacyTrait::assertFieldChecked | Deprecated | protected | function | Asserts that a checkbox field in the current page is checked. | |||
AssertLegacyTrait::assertFieldsByValue | Deprecated | protected | function | Asserts that a field exists in the current page with a given Xpath result. | |||
AssertLegacyTrait::assertHeader | Deprecated | protected | function | Checks that current response header equals value. | |||
AssertLegacyTrait::assertIdentical | Deprecated | protected | function | ||||
AssertLegacyTrait::assertIdenticalObject | Deprecated | protected | function | ||||
AssertLegacyTrait::assertLink | Deprecated | protected | function | Passes if a link with the specified label is found. | |||
AssertLegacyTrait::assertLinkByHref | Deprecated | protected | function | Passes if a link containing a given href (part) is found. | |||
AssertLegacyTrait::assertNoCacheTag | Deprecated | protected | function | Asserts whether an expected cache tag was absent in the last response. | |||
AssertLegacyTrait::assertNoEscaped | Deprecated | protected | function | Passes if the raw text is not found escaped on the loaded page. | |||
AssertLegacyTrait::assertNoField | Deprecated | protected | function | Asserts that a field does NOT exist with the given name or ID. | |||
AssertLegacyTrait::assertNoFieldById | Deprecated | protected | function | Asserts that a field does not exist with the given ID and value. | |||
AssertLegacyTrait::assertNoFieldByName | Deprecated | protected | function | Asserts that a field does not exist with the given name and value. | |||
AssertLegacyTrait::assertNoFieldByXPath | Deprecated | protected | function | Asserts that a field does not exist or its value does not match, by XPath. | |||
AssertLegacyTrait::assertNoFieldChecked | Deprecated | protected | function | Asserts that a checkbox field in the current page is not checked. | |||
AssertLegacyTrait::assertNoLink | Deprecated | protected | function | Passes if a link with the specified label is not found. | |||
AssertLegacyTrait::assertNoLinkByHref | Deprecated | protected | function | Passes if a link containing a given href (part) is not found. | |||
AssertLegacyTrait::assertNoOption | Deprecated | protected | function | Asserts that a select option does NOT exist in the current page. | |||
AssertLegacyTrait::assertNoPattern | Deprecated | protected | function | Triggers a pass if the Perl regex pattern is not found in the raw content. | |||
AssertLegacyTrait::assertNoRaw | Deprecated | protected | function | Passes if the raw text IS not found on the loaded page, fail otherwise. | |||
AssertLegacyTrait::assertNotEqual | Deprecated | protected | function | ||||
AssertLegacyTrait::assertNoText | Deprecated | protected | function | Passes if the page (with HTML stripped) does not contains the text. | |||
AssertLegacyTrait::assertNotIdentical | Deprecated | protected | function | ||||
AssertLegacyTrait::assertNoUniqueText | Deprecated | protected | function | Passes if the text is found MORE THAN ONCE on the text version of the page. | |||
AssertLegacyTrait::assertOption | Deprecated | protected | function | Asserts that a select option in the current page exists. | |||
AssertLegacyTrait::assertOptionByText | Deprecated | protected | function | Asserts that a select option with the visible text exists. | |||
AssertLegacyTrait::assertOptionSelected | Deprecated | protected | function | Asserts that a select option in the current page is checked. | |||
AssertLegacyTrait::assertPattern | Deprecated | protected | function | Triggers a pass if the Perl regex pattern is found in the raw content. | |||
AssertLegacyTrait::assertRaw | Deprecated | protected | function | Passes if the raw text IS found on the loaded page, fail otherwise. | |||
AssertLegacyTrait::assertResponse | Deprecated | protected | function | Asserts the page responds with the specified response code. | |||
AssertLegacyTrait::assertText | Deprecated | protected | function | Passes if the page (with HTML stripped) contains the text. | |||
AssertLegacyTrait::assertTextHelper | Deprecated | protected | function | Helper for assertText and assertNoText. | |||
AssertLegacyTrait::assertTitle | Deprecated | protected | function | Pass if the page title is the given string. | |||
AssertLegacyTrait::assertUniqueText | Deprecated | protected | function | Passes if the text is found ONLY ONCE on the text version of the page. | |||
AssertLegacyTrait::assertUrl | Deprecated | protected | function | Passes if the internal browser's URL matches the given path. | |||
AssertLegacyTrait::buildXPathQuery | Deprecated | protected | function | Builds an XPath query. | |||
AssertLegacyTrait::constructFieldXpath | Deprecated | protected | function | Helper: Constructs an XPath for the given set of attributes and value. | |||
AssertLegacyTrait::getAllOptions | Deprecated | protected | function | Get all option elements, including nested options, in a select. | |||
AssertLegacyTrait::getRawContent | Deprecated | protected | function | Gets the current raw content. | |||
AssertLegacyTrait::pass | Deprecated | protected | function | ||||
AssertLegacyTrait::verbose | Deprecated | protected | function | ||||
BlockCreationTrait::placeBlock | protected | function | Creates a block instance based on default settings. | Aliased as: drupalPlaceBlock | |||
BrowserHtmlDebugTrait::$htmlOutputBaseUrl | protected | property | The Base URI to use for links to the output files. | ||||
BrowserHtmlDebugTrait::$htmlOutputClassName | protected | property | Class name for HTML output logging. | ||||
BrowserHtmlDebugTrait::$htmlOutputCounter | protected | property | Counter for HTML output logging. | ||||
BrowserHtmlDebugTrait::$htmlOutputCounterStorage | protected | property | Counter storage for HTML output logging. | ||||
BrowserHtmlDebugTrait::$htmlOutputDirectory | protected | property | Directory name for HTML output logging. | ||||
BrowserHtmlDebugTrait::$htmlOutputEnabled | protected | property | HTML output enabled. | ||||
BrowserHtmlDebugTrait::$htmlOutputFile | protected | property | The file name to write the list of URLs to. | ||||
BrowserHtmlDebugTrait::$htmlOutputTestId | protected | property | HTML output test ID. | ||||
BrowserHtmlDebugTrait::formatHtmlOutputHeaders | protected | function | Formats HTTP headers as string for HTML output logging. | ||||
BrowserHtmlDebugTrait::getHtmlOutputHeaders | protected | function | Returns headers in HTML output format. | 1 | |||
BrowserHtmlDebugTrait::getResponseLogHandler | protected | function | Provides a Guzzle middleware handler to log every response received. | ||||
BrowserHtmlDebugTrait::htmlOutput | protected | function | Logs a HTML output message in a text file. | ||||
BrowserHtmlDebugTrait::initBrowserOutputFile | protected | function | Creates the directory to store browser output. | ||||
BrowserTestBase::$baseUrl | protected | property | The base URL. | ||||
BrowserTestBase::$configImporter | protected | property | The config importer that can be used in a test. | ||||
BrowserTestBase::$customTranslations | protected | property | An array of custom translations suitable for drupal_rewrite_settings(). | ||||
BrowserTestBase::$mink | protected | property | Mink session manager. | ||||
BrowserTestBase::$minkDefaultDriverArgs | protected | property | Mink default driver params. | ||||
BrowserTestBase::$minkDefaultDriverClass | protected | property | Mink class for the default driver to use. | 1 | |||
BrowserTestBase::$originalContainer | protected | property | The original container. | ||||
BrowserTestBase::$originalShutdownCallbacks | protected | property | The original array of shutdown function callbacks. | ||||
BrowserTestBase::$preserveGlobalState | protected | property | |||||
BrowserTestBase::$runTestInSeparateProcess | protected | property | Browser tests are run in separate processes to prevent collisions between code that may be loaded by tests. |
||||
BrowserTestBase::$timeLimit | protected | property | Time limit in seconds for the test. | ||||
BrowserTestBase::$translationFilesDirectory | protected | property | The translation file directory for the test environment. | ||||
BrowserTestBase::cleanupEnvironment | protected | function | Clean up the Simpletest environment. | ||||
BrowserTestBase::config | protected | function | Configuration accessor for tests. Returns non-overridden configuration. | ||||
BrowserTestBase::drupalGetHeader | Deprecated | protected | function | Gets the value of an HTTP response header. | |||
BrowserTestBase::filePreDeleteCallback | public static | function | Ensures test files are deletable. | ||||
BrowserTestBase::getDefaultDriverInstance | protected | function | Gets an instance of the default Mink driver. | ||||
BrowserTestBase::getDrupalSettings | protected | function | Gets the JavaScript drupalSettings variable for the currently-loaded page. | 1 | |||
BrowserTestBase::getHttpClient | protected | function | Obtain the HTTP client for the system under test. | ||||
BrowserTestBase::getMinkDriverArgs | protected | function | Gets the Mink driver args from an environment variable. | 1 | |||
BrowserTestBase::getOptions | protected | function | Helper function to get the options of select field. | ||||
BrowserTestBase::getSession | public | function | Returns Mink session. | ||||
BrowserTestBase::getSessionCookies | protected | function | Get session cookies from current session. | ||||
BrowserTestBase::getTestMethodCaller | protected | function | Retrieves the current calling line in the class under test. | Overrides BrowserHtmlDebugTrait::getTestMethodCaller | |||
BrowserTestBase::initFrontPage | protected | function | Visits the front page when initializing Mink. | 3 | |||
BrowserTestBase::initMink | protected | function | Initializes Mink sessions. | 1 | |||
BrowserTestBase::installDrupal | public | function | Installs Drupal into the Simpletest site. | 1 | |||
BrowserTestBase::registerSessions | protected | function | Registers additional Mink sessions. | ||||
BrowserTestBase::setUpAppRoot | protected | function | Sets up the root application path. | ||||
BrowserTestBase::setUpBeforeClass | public static | function | 1 | ||||
BrowserTestBase::tearDown | protected | function | 3 | ||||
BrowserTestBase::translatePostValues | protected | function | Transforms a nested array into a flat array suitable for submitForm(). | ||||
BrowserTestBase::xpath | protected | function | Performs an xpath search on the contents of the internal browser. | ||||
BrowserTestBase::__sleep | public | function | Prevents serializing any properties. | ||||
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. | ||||
ConfigureAndExecuteTest::$account | protected | property | A user with administration permissions. | ||||
ConfigureAndExecuteTest::$expressionManager | protected | property | The Rules expression manager. | ||||
ConfigureAndExecuteTest::$modules | protected static | property | Modules to enable. | Overrides BrowserTestBase::$modules | |||
ConfigureAndExecuteTest::$profile | protected | property | We use the minimal profile because we want to test local action links. | Overrides BrowserTestBase::$profile | |||
ConfigureAndExecuteTest::$storage | protected | property | The entity storage for Rules config entities. | ||||
ConfigureAndExecuteTest::createRule | protected | function | Helper function to create a reaction rule. | ||||
ConfigureAndExecuteTest::setUp | protected | function | Overrides BrowserTestBase::setUp | ||||
ConfigureAndExecuteTest::testAddEventAndExecute | public | function | Tests adding an event and then triggering its execution. | ||||
ConfigureAndExecuteTest::testAssignmentRestriction | public | function | Tests the implementation of assignment restriction in context form. | ||||
ConfigureAndExecuteTest::testConfigureAndExecute | public | function | Tests creation of a rule and then triggering its execution. | ||||
ConfigureAndExecuteTest::testDeleteEventAndExecute | public | function | Tests deleting an event and then triggering its execution. | ||||
ConfigureAndExecuteTest::testMultipleInputContext | public | function | Tests user input in context form for 'multiple' valued context variables. | ||||
ConfigureAndExecuteTest::testTwoRulesSameEvent | public | function | Tests creating and altering two rules reacting on the same event. | ||||
ConfigureAndExecuteTest::testUpcastInAction | public | function | Tests upcasting in an action. | ||||
ConfigureAndExecuteTest::testUpcastInCondition | public | function | Tests upcasting in a condition. | ||||
ContentTypeCreationTrait::createContentType | protected | function | Creates a custom content type based on default settings. | Aliased as: drupalCreateContentType | 1 | ||
ExtensionListTestTrait::getModulePath | protected | function | Gets the path for the specified module. | ||||
ExtensionListTestTrait::getThemePath | protected | function | Gets the path for the specified theme. | ||||
FunctionalTestSetupTrait::$apcuEnsureUniquePrefix | protected | property | The flag to set 'apcu_ensure_unique_prefix' setting. | 1 | |||
FunctionalTestSetupTrait::$classLoader | protected | property | The class loader to use for installation and initialization of setup. | ||||
FunctionalTestSetupTrait::$rootUser | protected | property | The "#1" admin user. | ||||
FunctionalTestSetupTrait::doInstall | protected | function | Execute the non-interactive installer. | 1 | |||
FunctionalTestSetupTrait::getDatabaseTypes | protected | function | Returns all supported database driver installer objects. | ||||
FunctionalTestSetupTrait::initConfig | protected | function | Initialize various configurations post-installation. | 1 | |||
FunctionalTestSetupTrait::initKernel | protected | function | Initializes the kernel after installation. | ||||
FunctionalTestSetupTrait::initSettings | protected | function | Initialize settings created during install. | ||||
FunctionalTestSetupTrait::initUserSession | protected | function | Initializes user 1 for the site to be installed. | ||||
FunctionalTestSetupTrait::installDefaultThemeFromClassProperty | protected | function | Installs the default theme defined by `static::$defaultTheme` when needed. | ||||
FunctionalTestSetupTrait::installModulesFromClassProperty | protected | function | Install modules defined by `static::$modules`. | 1 | |||
FunctionalTestSetupTrait::installParameters | protected | function | Returns the parameters that will be used when Simpletest installs Drupal. | 8 | |||
FunctionalTestSetupTrait::prepareEnvironment | protected | function | Prepares the current environment for running the test. | 22 | |||
FunctionalTestSetupTrait::prepareRequestForGenerator | protected | function | Creates a mock request and sets it on the generator. | ||||
FunctionalTestSetupTrait::prepareSettings | protected | function | Prepares site settings and services before installation. | 3 | |||
FunctionalTestSetupTrait::rebuildAll | protected | function | Resets and rebuilds the environment after setup. | ||||
FunctionalTestSetupTrait::rebuildContainer | protected | function | Rebuilds \Drupal::getContainer(). | ||||
FunctionalTestSetupTrait::resetAll | protected | function | Resets all data structures after having enabled new modules. | ||||
FunctionalTestSetupTrait::setContainerParameter | protected | function | Changes parameters in the services.yml file. | ||||
FunctionalTestSetupTrait::setupBaseUrl | protected | function | Sets up the base URL based upon the environment variable. | ||||
FunctionalTestSetupTrait::writeSettings | protected | function | Rewrites the settings.php file of the test site. | 1 | |||
NodeCreationTrait::createNode | protected | function | Creates a node based on default settings. | Aliased as: drupalCreateNode | |||
NodeCreationTrait::getNodeByTitle | public | function | Get a node from the database based on its title. | Aliased as: drupalGetNodeByTitle | |||
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::$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. | ||||
RefreshVariablesTrait::refreshVariables | protected | function | Refreshes in-memory configuration and state information. | 1 | |||
RulesBrowserTestBase::$defaultTheme | protected | property | The theme to install as the default for testing. | Overrides BrowserTestBase::$defaultTheme | |||
RulesBrowserTestBase::clickLinkByHref | public | function | Clicks a link identified via partial href using xpath. | ||||
RulesBrowserTestBase::fillField | public | function | Fills in field (input, textarea, select) with specified locator. | ||||
RulesBrowserTestBase::findButton | public | function | Finds button with specified locator. | ||||
RulesBrowserTestBase::findField | public | function | Finds field (input, textarea, select) with specified locator. | ||||
RulesBrowserTestBase::findLink | public | function | Finds link with specified locator. | ||||
RulesBrowserTestBase::pressButton | public | function | Presses button with specified locator. | ||||
SessionTestTrait::$sessionName | protected | property | The name of the session cookie. | ||||
SessionTestTrait::generateSessionName | protected | function | Generates a session cookie name. | ||||
SessionTestTrait::getSessionName | protected | function | Returns the session name in use on the child site. | ||||
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. | ||||
TestRequirementsTrait::getDrupalRoot | protected static | function | Returns the Drupal root directory. | ||||
TestSetupTrait::$configSchemaCheckerExclusions | protected static | property | An array of config object names that are excluded from schema checking. | 1 | |||
TestSetupTrait::$container | protected | property | The dependency injection container used in the test. | ||||
TestSetupTrait::$databasePrefix | protected | property | The database prefix of this test run. | ||||
TestSetupTrait::$kernel | protected | property | The DrupalKernel instance used in the test. | ||||
TestSetupTrait::$originalSite | protected | property | The site directory of the original parent site. | ||||
TestSetupTrait::$privateFilesDirectory | protected | property | The private file directory for the test environment. | ||||
TestSetupTrait::$publicFilesDirectory | protected | property | The public file directory for the test environment. | ||||
TestSetupTrait::$root | protected | property | The app root. | ||||
TestSetupTrait::$siteDirectory | protected | property | The site directory of this test run. | ||||
TestSetupTrait::$strictConfigSchema | protected | property | Set to TRUE to strict check all configuration saved. | 1 | |||
TestSetupTrait::$tempFilesDirectory | protected | property | The temporary file directory for the test environment. | ||||
TestSetupTrait::$testId | protected | property | The test run ID. | ||||
TestSetupTrait::changeDatabasePrefix | protected | function | Changes the database connection to the prefixed one. | ||||
TestSetupTrait::getConfigSchemaExclusions | protected | function | Gets the config schema exclusions for this test. | ||||
TestSetupTrait::getDatabaseConnection | public static | function | Returns the database connection to the site running Simpletest. | ||||
TestSetupTrait::prepareDatabasePrefix | protected | function | Generates a database prefix for running tests. | 1 | |||
UiHelperTrait::$loggedInUser | protected | property | The current user logged in using the Mink controlled browser. | ||||
UiHelperTrait::$maximumMetaRefreshCount | protected | property | The number of meta refresh redirects to follow, or NULL if unlimited. | ||||
UiHelperTrait::$metaRefreshCount | protected | property | The number of meta refresh redirects followed during ::drupalGet(). | ||||
UiHelperTrait::assertSession | public | function | Returns WebAssert object. | 1 | |||
UiHelperTrait::buildUrl | protected | function | Builds an absolute URL from a system path or a URL object. | ||||
UiHelperTrait::checkForMetaRefresh | protected | function | Checks for meta refresh tag and if found call drupalGet() recursively. | ||||
UiHelperTrait::click | protected | function | Clicks the element with the given CSS selector. | ||||
UiHelperTrait::clickLink | protected | function | Follows a link by complete name. | ||||
UiHelperTrait::cssSelect | protected | function | Searches elements using a CSS selector in the raw content. | ||||
UiHelperTrait::cssSelectToXpath | protected | function | Translates a CSS expression to its XPath equivalent. | ||||
UiHelperTrait::drupalGet | protected | function | Retrieves a Drupal path or an absolute path. | 2 | |||
UiHelperTrait::drupalLogin | protected | function | Logs in a user using the Mink controlled browser. | ||||
UiHelperTrait::drupalLogout | protected | function | Logs a user out of the Mink controlled browser and confirms. | ||||
UiHelperTrait::drupalPostForm | Deprecated | protected | function | Executes a form submission. | |||
UiHelperTrait::drupalUserIsLoggedIn | protected | function | Returns whether a given user account is logged in. | ||||
UiHelperTrait::getAbsoluteUrl | protected | function | Takes a path and returns an absolute path. | ||||
UiHelperTrait::getTextContent | protected | function | Retrieves the plain-text content from the current page. | ||||
UiHelperTrait::getUrl | protected | function | Get the current URL from the browser. | ||||
UiHelperTrait::isTestUsingGuzzleClient | protected | function | Determines if test is using DrupalTestBrowser. | ||||
UiHelperTrait::prepareRequest | protected | function | Prepare for a request to testing site. | 1 | |||
UiHelperTrait::submitForm | protected | function | Fills and submits a form. | ||||
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. | ||||
XdebugRequestTrait::extractCookiesFromRequest | protected | function | Adds xdebug cookies, from request setup. |