You really should be reading the various docblocks in the files under
+ tests/src/.
tests/src directory, so
+ they will not be loaded by the autoloader during normal bootstrap.
+ [your_module]/tests/src/Unit.[your_module]/tests/src/Kernel.[your_module]/tests/src/Functional.| Type | +Location | +Namespace | +Subclass of | +
| Unit Test | +[your_module]/tests/src/Unit | +Drupal\Tests\[your_module]\Unit\ | +Drupal\Tests\UnitTestCase | +
| Kernel Test | +[your_module]/tests/src/Kernel | +Drupal\Tests\[your_module]\Kernel\ | +Drupal\KernelTests\KernelTestBase | +
| Functional Test | +[your_module]/tests/src/Functional | +Drupal\Tests\[your_module]\Functional\ | +Drupal\Tests\BrowserTestBase | +
| FunctionalJavascript Test | +[your_module]/tests/src/FunctionalJavascript | +Drupal\Tests\[your_module]\FunctionalJavascript\ | +Drupal\Tests\JavascriptTestBase | +
| Shared Test Traits | +[your_module]/tests/src/Traits | +Drupal\Tests\[your_module]\Traits\ | +n/a | +
You can run PHPUnit from the command line or via the run-tests.sh command.
+You can specify which type of test you're running via +
phpunit --testsuiterun-tests.sh --types. +There are many options to phpunit, but, for instance, to run all of the + testing_example phpunit tests, you could +
+ + +{% endtrans %} diff --git a/testing_example/testing_example.info.yml b/testing_example/testing_example.info.yml new file mode 100644 index 0000000..07a6d52 --- /dev/null +++ b/testing_example/testing_example.info.yml @@ -0,0 +1,7 @@ +name: Testing example +type: module +description: Demonstrates Drupal core testing frameworks +package: Example modules +core: 8.x +dependencies: + - examples:examples diff --git a/testing_example/testing_example.links.menu.yml b/testing_example/testing_example.links.menu.yml new file mode 100644 index 0000000..256d007 --- /dev/null +++ b/testing_example/testing_example.links.menu.yml @@ -0,0 +1,3 @@ +testing_example.description: + title: Testing Example + route_name: testing_example.description diff --git a/testing_example/testing_example.module b/testing_example/testing_example.module new file mode 100644 index 0000000..e44d99b --- /dev/null +++ b/testing_example/testing_example.module @@ -0,0 +1,17 @@ +adminUser = $this->drupalCreateUser([ + 'access administration pages', + 'view the administration theme', + 'administer permissions', + 'administer nodes', + 'administer content types', + ]); + $this->authUser = $this->drupalCreateUser([], 'authuser'); + + // We have to create a content type because testing uses the 'testing' + // profile, which has no content types by default. + // Although we could have visited admin pages and pushed buttons to create + // the content type, there happens to be function we can use in this case. + $this->createContentType(['type' => 'test_content_type']); + } + + /** + * Demonstrate node creation via button-pushing. + */ + public function testNewPage() { + $this->drupalLogin($this->adminUser); + + $assert = $this->assertSession(); + + $this->drupalGet('node/add/test_content_type'); + $assert->statusCodeEquals(200); + + $nodeTitle = 'Test node for testNewPage'; + $edit = [ + 'title[0][value]' => $nodeTitle, + 'body[0][value]' => 'Body of test node', + ]; + $this->drupalPostForm(NULL, $edit, 'op'); + $assert->statusCodeEquals(200); + $assert->linkExists($nodeTitle); + + // Log in our normal user and navigate to the node. + $this->drupalLogin($this->authUser); + + /** @var \Drupal\node\NodeInterface $createdNode */ + $createdNode = $this->drupalGetNodeByTitle($nodeTitle); + $url = $createdNode->toUrl(); + $this->drupalGet($url); + $assert->statusCodeEquals(200); + + // Look at the *page* title. + $assert->titleEquals("{$nodeTitle} | Drupal"); + + // Find the title of the node itself. + $nodeTitleElement = $this->getSession() + ->getPage() + ->find('css', 'h1 span.field--name-title'); + $this->assertEquals($nodeTitleElement->getText(), $nodeTitle); + } + + /** + * Demonstrate node creation via NodeCreationTrait::createNode. + */ + public function testNewPageAPICreate() { + $assert = $this->assertSession(); + + $this->drupalLogin($this->adminUser); + + $nodeTitle = 'Test node for testNewPageAPICreate'; + + // Create new node using API. + $node = $this->drupalCreateNode([ + 'type' => 'test_content_type', // Default value: page. + 'title' => $nodeTitle, + 'body' => [ + [ + 'format' => filter_default_format($this->adminUser), + 'value' => 'Body of test node', + ], + ], + ]); + $node->save(); + $url = $node->toUrl(); + + // Confirm page creation. + $this->drupalGet($url); + $assert->statusCodeEquals(200); + + // Log in our normal user and navigate to the node. + $this->drupalLogin($this->authUser); + $this->drupalGet($url); + $assert->statusCodeEquals(200); + + // Look at the *page* title. + $assert->titleEquals("{$nodeTitle} | Drupal"); + + // Find the title of the node itself. + $nodeTitleElement = $this->getSession() + ->getPage() + ->find('css', 'h1 span.field--name-title'); + $this->assertEquals($nodeTitleElement->getText(), $nodeTitle); + } + +} diff --git a/testing_example/tests/src/Functional/TestingExampleMenuTest.php b/testing_example/tests/src/Functional/TestingExampleMenuTest.php new file mode 100644 index 0000000..35bfb8f --- /dev/null +++ b/testing_example/tests/src/Functional/TestingExampleMenuTest.php @@ -0,0 +1,49 @@ + '/examples/testing-example'] as $page => $path) { + $this->drupalGet($page); + $this->assertLinkByHref($path); + } + $this->drupalGet('/examples/testing-example'); + $this->assertResponse(200, 'Description page exists.'); + } + +} diff --git a/testing_example/tests/src/Kernel/ExampleKernelNodeTest.php b/testing_example/tests/src/Kernel/ExampleKernelNodeTest.php new file mode 100644 index 0000000..0830038 --- /dev/null +++ b/testing_example/tests/src/Kernel/ExampleKernelNodeTest.php @@ -0,0 +1,97 @@ +installSchema('system', ['sequences']); + + // Install *module* schema for node/user modules. + $this->installSchema('node', ['node_access']); + $this->installSchema('user', ['users_data']); + + // Install *entity* schema for the node entity. + $this->installEntitySchema('node'); + $this->installEntitySchema('user'); + + // Install any config provided by the enabled. + $this->installConfig(['field', 'node', 'text', 'filter', 'user']); + + $this->owner = $this->createUser([], 'testuser'); + } + + /** + * Create a user account using createUser() from the UserCreation trait. + */ + public function testNodeCreation() { + + // Unless there's a specific reason to do so, strings in tests do *not* need + // to be translatable with t(). + $nodeTitle = 'Test Node!'; + + /** @var \Drupal\node\NodeInterface $node */ + $node = $this->createNode([ + 'title' => $nodeTitle, + 'type' => 'page', + 'uid' => $this->owner->id(), + ]); + + self::assertEquals($nodeTitle, $node->getTitle()); + + // Test a few more things about your node here. + } + +} diff --git a/testing_example/tests/src/Kernel/ExampleKernelUserTest.php b/testing_example/tests/src/Kernel/ExampleKernelUserTest.php new file mode 100644 index 0000000..b21145b --- /dev/null +++ b/testing_example/tests/src/Kernel/ExampleKernelUserTest.php @@ -0,0 +1,86 @@ +installSchema('system', ['sequences']); + + // Install *module* schema for user module. + $this->installSchema('user', ['users_data']); + + // Install *entity* schema for the user entity. + $this->installEntitySchema('user'); + + // Install any config provided by the user module. + $this->installConfig(['user']); + + $this->authUser = $this->createUser([], 'testuser'); + } + + /** + * Create a user account using createUser() from the UserCreation trait. + */ + public function testUserCreation() { + + // Create a user named 'extrauser'. + $account = $this->createUser([], 'extrauser'); + // Assert that this user exists. + $this->assertEquals('extrauser', $account->getAccountName()); + + // Assert that our auth user is not the same user as extrauser. + $this->assertNotEquals($this->authUser->getAccountName(), $account->getAccountName()); + } + +}./vendor/phpunit/phpunit/phpunit -c core/ ./modules/examples/testing_example