{"id":57998,"date":"2023-08-29T11:14:19","date_gmt":"2023-08-29T05:44:19","guid":{"rendered":"https:\/\/www.tothenew.com\/blog\/?p=57998"},"modified":"2023-09-06T11:30:04","modified_gmt":"2023-09-06T06:00:04","slug":"concepts-of-unit-testing-in-drupal-9-with-example","status":"publish","type":"post","link":"https:\/\/www.tothenew.com\/blog\/concepts-of-unit-testing-in-drupal-9-with-example\/","title":{"rendered":"Concepts of Unit Testing in Drupal 9 with Example"},"content":{"rendered":"

Introduction<\/b><\/h2>\n

In the realm of Drupal 9 development, ensuring the dependability and stability of your applications stands as a paramount objective. The practice of unit testing emerges as a potent strategy to achieve this goal, allowing developers to validate individual building blocks of their codebase. This comprehensive guide takes a deep dive into the intricacies of unit testing within the Drupal 9 context, providing practical examples that underscore its importance.<\/span><\/p>\n

Grasping the essence of unit testing and its implications<\/b><\/h2>\n

In the dynamic world of software development, unit testing plays a pivotal role by breaking down code into manageable units for targeted evaluation. These discrete tests hold the power to unearth latent bugs, thereby promoting software reliability and performance. In the context of Drupal 9, these units can be functions, methods, or services, forming the bedrock of quality assurance.<\/span><\/p>\n

Configuring your local Drupal 9 environment for seamless unit testing<\/b><\/h2>\n

Before embarking on your unit testing journey, a local development environment equipped with PHPUnit and the “Drupal Test Traits” Composer package is indispensable. This toolkit, comprising traits and utilities tailored to Drupal testing, lays the foundation for effective unit testing. Ensure a smooth installation and alignment of PHPUnit with the package.<\/span><\/p>\n

Crafting your maiden Drupal 9 unit test<\/b><\/h2>\n

Let’s illustrate the concept with a scenario: Imagine a custom module containing a function that calculates the sum of two numbers. A simple yet illustrative unit test might look like this:<\/span><\/p>\n

namespace Drupal\\Tests\\test_module\\Unit;<\/span>\r\nuse Drupal\\Tests\\UnitTestCase; <\/span>\r\nuse Drupal\\test_module\\Calculator;\u00a0<\/span>\r\n\r\n\/** <\/span>\r\n* Testing the Calculator class. <\/span>\r\n*<\/span>\r\n* @group test_module\u00a0<\/span>\r\n\r\n*\/ <\/span>\r\nclass CalculatorTest extends UnitTestCase{ <\/span>\r\npublic function testSum() { <\/span>\r\n$calculator = new Calculator(); <\/span>\r\n$this->assertEquals(5, $calculator->sum(2, 3)); <\/span>\r\n} <\/span>\r\n}<\/span><\/pre>\n
Probing Deeper: Unveiling the secrets of testing Drupal services<\/b><\/h2>\n
The architecture of Drupal relies extensively on services. Delving into service testing, we leverage the “Container” trait, a gem from the “Drupal Test Traits” package. This example illustrates creating a service instance:<\/span><\/p>\n
namespace Drupal\\Tests\\test_module\\Unit;\u00a0<\/span>\r\n\r\nuse Drupal\\Tests\\UnitTestCase; <\/span>\r\nuse Drupal\\test_module\\MyService; <\/span>\r\nuse Drupal\\Core\\DependencyInjection\\ContainerBuilder; <\/span>\r\nuse Drupal\\Core\\DependencyInjection\\Container;\u00a0<\/span>\r\n\r\n\/** <\/span>\r\n* Testing the MyService class. <\/span>\r\n* <\/span>\r\n* @group test_module *\/\u00a0<\/span>\r\n\r\nclass MyServiceTest extends UnitTestCase { <\/span>\r\nprotected function setUp(): void { <\/span>\r\nparent::setUp(); <\/span>\r\n$this->container = new Container(new ContainerBuilder()); <\/span>\r\n}\u00a0<\/span>\r\n\r\npublic function testSomething() { <\/span>\r\n $my_service = new MyService($this->container);\u00a0<\/span>\r\n $result = $my_service->doSomething();\u00a0<\/span>\r\n $this->assertEquals('expected_result', $result);\u00a0<\/span>\r\n } <\/span>\r\n}<\/span><\/pre>\n
namespace Drupal\\Tests\\test_module\\Unit; <\/span>\r\n\r\nuse Drupal\\Tests\\UnitTestCase; <\/span>\r\nuse Drupal\\test_module\\MyService; <\/span>\r\nuse Prophecy\\Prophet;\u00a0<\/span>\r\n\r\n\/** <\/span>\r\n * Testing the MyService class.\u00a0<\/span>\r\n *\u00a0<\/span>\r\n * @group test_module *\/\u00a0<\/span>\r\nclass MyServiceTest extends UnitTestCase { \r\n<\/span>\r\npublic function testSomething() { <\/span>\r\n \u00a0\u00a0$prophet = new Prophet();\u00a0<\/span>\r\n \u00a0\u00a0$dependency = $prophet->prophesize(AnotherService::class);<\/span>\r\n\u00a0\u00a0\u00a0$dependency->someMethod()->willReturn('mocked_result');<\/span>\r\n\r\n \u00a0\u00a0$my_service = new MyService($dependency->reveal());\u00a0<\/span>\r\n \u00a0\u00a0$result = $my_service->doSomething();\u00a0<\/span>\r\n\u00a0\u00a0\u00a0$this->assertEquals('expected_result', $result);\u00a0<\/span>\r\n\r\n \u00a0\u00a0$prophet->checkPredictions();\u00a0<\/span>\r\n }\u00a0<\/span>\r\n}<\/span><\/pre>\n
Embracing diverse scenarios with data providers<\/b><\/h2>\n
Enhancing testing coverage is achievable through data providers. This technique enables tests to run with various inputs, effectively broadening their scope:<\/span><\/p>\n
namespace Drupal\\Tests\\test_module\\Unit;<\/span>\r\nuse Drupal\\Tests\\UnitTestCase;<\/span>\r\nuse Drupal\\test_module\\Calculator;<\/span>\r\n\r\n\/**<\/span>\r\n* Testing the Calculator class.<\/span>\r\n*<\/span>\r\n* @grouptest_module<\/span>\r\n*\/ class CalculatorTest extends UnitTestCase{<\/span>\r\n\r\n\/**<\/span>\r\n* @dataProvider sumDataProvider<\/span>\r\n*\/ public function testSum($a, $b, $expected) { $calculator = new Calculator();<\/span>\r\n $this->assertEquals($expected, $calculator->sum($a, $b));<\/span>\r\n }<\/span>\r\npublic function sumDataProvider() { return [ [2, 3, 5], [0, 0, 0], [-1, 1, 0], ];<\/span>\r\n}<\/span>\r\n}<\/span><\/pre>\n
Navigating the execution and Analysis of unit tests<\/b><\/h2>\n
Execute your tests with the command<\/span><\/p>\n
phpunit -c web\/core web\/modules\/custom\/test_module\/tests\/src\/Unit,<\/span><\/pre>\n
Where web\/core denotes the Drupal core directory, PHPUnit streamlines the identification of passed and failed tests, expediting issue resolution.<\/span><\/p>\n
In Conclusion<\/b><\/h2>\n
Elevating code integrity through thoughtful unit testing<\/span><\/p>\n
The realm of unit testing in Drupal 9 empowers developers to build robust applications of enduring quality. By scrutinizing discrete code units meticulously, latent defects are unearthed, paving the way for preemptive remediation. With the synergistic interplay of PHPUnit and the “Drupal Test Traits” package, the embrace of unit testing within the Drupal ecosystem emerges as a transformative endeavor.<\/span><\/p>\n
If you have any questions, please feel free to reach out via comments.<\/span><\/p>\n
 <\/p>\n
<\/div>","protected":false},"excerpt":{"rendered":"
Introduction In the realm of Drupal 9 development, ensuring the dependability and stability of your applications stands as a paramount objective. The practice of unit testing emerges as a potent strategy to achieve this goal, allowing developers to validate individual building blocks of their codebase. This comprehensive guide takes a deep dive into the intricacies […]<\/p>\n","protected":false},"author":1513,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"iawp_total_views":43},"categories":[3602,1816],"tags":[5152,5398,5400,5399],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/posts\/57998"}],"collection":[{"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/users\/1513"}],"replies":[{"embeddable":true,"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/comments?post=57998"}],"version-history":[{"count":5,"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/posts\/57998\/revisions"}],"predecessor-version":[{"id":58332,"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/posts\/57998\/revisions\/58332"}],"wp:attachment":[{"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/media?parent=57998"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/categories?post=57998"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/tags?post=57998"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}