The Katalon Blog

What is Unit Testing? A Complete Guide

Written by Katalon Team | Jul 19, 2023 4:36:00 AM

Imagine building a complex machine, and you want to ensure each tiny part works perfectly before assembling the whole thing. That's exactly what unit testing does in the world of software development. 

In this article, we’ll dive into what unit testing is, why it’s essential, and how it can make your code stronger and more reliable.

What is Unit Testing?

Unit testing is a software development practice that involves testing individual units or components of a software application in isolation. A unit is the smallest testable part of an application, usually a single function, method, procedure, module, or class. 
 

Together these code units form a complete application, and if they don’t work well individually, they definitely won’t work well together. Unit testing ensures that each component of the software works correctly on its own before integrating it into the larger system.

 

When Should Unit Testing Be Performed?

Unit testing is usually the very first level of testing, done before integration testing. The number of tests to perform in each cycle is huge, but the time it takes for each test is insignificant as these code units are relatively simple. Because of this, developers can quickly perform unit testing themselves.

 

Who Performs Unit Testing?

In certain teams, developers don’t want to allocate their limited bandwidth to do unit testing so that they can focus entirely on development. In these cases, QA engineers will take over unit testing and integrate this activity into their test plan, leveraging the existing testing tools to better execute and manage test results.

 

What is the Purpose of Unit Testing?

Unit testing is crucial to the software testing process for several reasons:

  1. Early bug detection: Unit testing catches bugs in early stages of development, ensuring that no bug is left undetected for too long and dependencies among software components become more complex. One single bug in an individual piece of code can easily affect many parts of the entire system without unit testing. Fixing these entrenched bugs is incredibly expensive and time-consuming.
  2. Better code writing: If developers have to take on unit testing, they must also adopt coding best practices and ensure that the code they write is maintainable. This is because unit testing requires that each unit has a well-defined responsibility that can be tested in isolation.
  3. Simplifies debugging: When a unit test fails, it provides valuable information about the specific unit and location where the problem occurred. This narrows down the root cause of the issue, making debugging faster and more efficient.
  4. Provides documentation: Unit tests act as examples that demonstrate how individual units of code should be used and what behavior is expected from them. They provide the perfect documentation for the entire logic of the software. This is especially useful for knowledge transferring to new members and regression prevention.

Read More: Unit Testing vs. Functional Testing: A Comparison

 

Anatomy of a Unit Test

1. Test Fixtures

Test fixtures are the components of a unit test responsible for preparing the necessary environment to execute the test case. Also called the “test context,” they create the initial states for the unit under test to ensure a more controlled execution. Test fixture is highly important for automated unit tests because it provides a consistent environment to repeat the testing process. 
 

For example, let’s say we have a blogging application and we want to test the Post Creation module. The test fixtures should include:

  • Post database connection
  • Sample post with titles, content, author information, etc.
  • Temporary storage for handling post attachments
  • Test configuration settings (default post visibility, formatting options, etc.)
  • Test user account
  • Sandbox environment (to isolate the test from the production environment and prevent tampering with actual blog data)

2. Test Case

A unit test case is simply a piece of code designed to verify the behavior of another unit of code, ensuring that the unit under test performs as expected and produces the desired results. Developers must also have an assertion to specifically define what those desired results are. For example, here is a unit test case for a function that calculates the sum of two numbers, and b:
 

use PHPUnit\Framework\TestCase;
 
class MathTest extends TestCase
{
    public function testSum()
    {
        // Arrange
        $a = 5;
        $b = 7;
        $expectedResult = 12;
 
        // Act
        $result = Math::sum($a, $b);
 
        // Assert
        $this->assertEquals($expectedResult, $result);
    }
}
 

The assertion used in this code is $this->assertEquals($expectedResult, $result); verifying that a + b indeed equals the expected result of 12.

 

3. Test Runner

The test runner is a framework to orchestrate the execution of multiple unit tests and also provide reporting and analysis of test results. It can scan the codebase or directories to file test cases and then execute them. The great thing is that test runners can run tests by priority while also managing the test environment and handling setup/teardown operations. With a test runner, the unit under test can be isolated from external dependencies.

 

4. Test Data

Test data should be chosen carefully to cover as many scenarios of that unit as possible, ensuring high test coverage. Generally, it is expected to prepare data for:

  • Normal cases: typical and expected input values for that unit
  • Boundary cases: input values at the boundary of the acceptable limit
  • Invalid/Error cases: invalid input values to see how the unit responds to errors (by error messages or certain behavior)
  • Corner cases: input values representing extreme scenarios that have significant impact on the unit or system

5. Mocking and Stubbing

Mocking and stubbing are essentially substitutes for real dependencies of the unit under test. In unit testing developers must focus on testing the specific unit in isolation, but in certain scenarios they’ll need two units to perform the test. 
 

For example, we can have a User class that depends on an external EmailSender class to send email notifications. The User class has a method sendWelcomeEmail() which calls the EmailSender to send a welcome email to a newly registered user. To test the sendWelcomeEmail() method in isolation without actually sending emails, we can create a mock object of the EmailSender class. The developer then won’t have to worry if the external unit (the EmailSender) is working well or not. The unit under test is truly tested in isolation.
 

Read More: Unit Testing vs. Integration Testing: What Are the Key Differences?

 

Characteristics of a Good Unit Test

Unit tests are generally:

  • Fast: These tests only check very simple and limited-in-scope units, so they can be executed in milliseconds. A mature project can have up to thousands of unit tests.
  • Isolated: They should be executed in isolation from external dependencies to ensure the most accurate results.
  • Easily automated: Due to their simple nature, unit tests are perfect candidates for automated testing. Developers can employ leading testing tools to help them run unit tests better.

 

How To Do Unit Testing?

  1. Identify the unit: Determine the specific code unit to be tested: either a function, method, class, or any other isolated component. Read the code and brainstorm the logic needed to test it. In this step developers should also have an idea of the cases they need to test for that unit to ensure high test coverage.
  2. Choose the approach: Similar to many other testing types, there are two major approaches to unit testing:
    1. Manual testing: Developers manually run the code and perform the necessary interactions to see if the code works well. 
    2. Automated testingDevelopers write a script that automates the interactions with the code. Read More: Manual Testing vs. Automation Testing Comparison
  3. Prepare the test environment: Set up the mock objects, prepare test data, configure the dependencies, as well as any other required preconditions. A confident developer would isolate the function for a more rigorous testing process. This practice involves copying and pasting the code into a dedicated testing environment, separate from its original context. By isolating the code, unnecessary dependencies between the code being tested and other units or data spaces in the product are uncovered.
  4. Write and execute test case: If the developer chooses the automated approach, they’ll start writing the test case, usually with a Unit Test Framework. This framework (or a test runner) can be used to execute the test and produce results (whether it passed or failed).
  5. Debug, fix, and confirm: If a test case fails, developers must debug it to identify the root cause, fix the issues, then rerun the tests to confirm that the bugs have indeed been fixed.

 

Unit Testing Techniques

There are several unit testing techniques commonly used to ensure thorough test coverage, including:

  • Black box testingThe internal structure and implementation details of the unit under test are not considered (similar to how the internals of a black box is not known). The tests focus on the external behavior and functionality of the unit. Test cases are designed based on the expected inputs, outputs, and specifications of the unit.
  • White box testingThe internal structure, logic, and implementation of the unit is taken into account, which contrasts with black box testing. Test cases are designed to explore different paths within the unit, ensuring that all code branches and segments are tested.

 

Top 4 Unit Testing Tools

1. JUnit

JUnit is an open-source unit testing tool in Java. It does not require the creation of class objects or the definition of the main method to run tests. It has an assertion library for evaluating test results. Annotations in JUnit are used to execute test methods. JUnit is commonly used to run automation suites with multiple test cases.

 

2. NUnit

NUnit, an open-source unit testing framework based on .NET, inherits many of its features directly from JUnit. Like JUnit, NUnit offers robust support for Test-Driven Development (TDD) and shares similar functionalities. NUnit enables the execution of automated tests in batches through its console runner.

 

3. TestNG

TestNG, short for Test Next Generation, is a robust framework that offers comprehensive control over the testing and execution of unit test cases. It incorporates features from both JUnit and NUnit, providing support for various test categories such as unit, functional, and integration testing. TestNG stands out as one of the most powerful unit testing tools due to its user-friendly functionalities.

 

4. PHPUnit

PHPUnit is a programmer-oriented unit testing framework specifically designed for PHP. It adheres to the xUnit architecture commonly utilized by unit testing frameworks such as NUnit and JUnit. PHPUnit operates exclusively through command-line execution and does not have direct compatibility with web browsers.

 

Test-Driven Development and Unit Testing

Test-Driven Development (TDD) and unit testing are two connected practices. The process of TDD involves writing automated unit tests prior to writing the code. These tests will surely fail, since there is no code written yet. After that, they will use the results from these tests to guide their code writing. Once they have developed the feature, they’ll re-execute the previously failed tests to confirm that their code indeed delivers the intended functionality. 
 

TDD is a systematic development approach that consistently offers feedback, facilitating quick bug detection and debugging. Imagine a situation where many frustrated users complain about a major problem that makes the app extremely slow. In an effort to fix this issue, your team quickly releases a patch. Unfortunately, this rushed solution introduces an even bigger problem, resulting in a widespread system failure.
 

With Test-Driven Development, you can effectively prevent such incidents. Generally, developers that follow the TDD approach will go through a three-step process:

  1. Fail: Write unit tests that will surely fail because no code is written.
  2. Pass: Write code until those tests pass.
  3. Refactor: Improve the code, then continue to run unit tests for the next features.

Read More: TDD vs. BDD: A Comparison

Unit Testing Best Practices

  1. Unit tests should be fast: Usually unit tests are huge in quantity, and if they require a lot of time to execute, developers will be hesitant in taking on this task. The goal of having unit tests is to boost the developers’ confidence in the existing code so that they can proceed with the next features, so they should be short and straight to the point. 
  2. Unit tests should be simple: Each unit test should focus on verifying a specific behavior or functionality (follow the “one assertion per test” rule). Structure your test on the AAA pattern to maintain clarity and readability in your unit tests. Choose descriptive, meaningful, but simple names for your test methods so that you have an easier time managing thousands of them. 
  3. Unit tests should be executed in isolation: Code isolation is a highly recommended practice to eliminate any external influences. Test input data should also be controlled, so try to avoid using dynamically generated data that may influence test results. Also ensure that you have reset the state for each unit test run, so there can be no interference with previous tests.
  4. Test results should be highly consistent: The more deterministic your unit tests are, the better. In other words, their results should always be consistent, no matter what changes were made to the code or what order you run your tests in.
  5. Regularly refactor unit tests: Treat your unit test code with the same care and attention as your production code. Refactor tests when necessary to improve readability, maintainability, and adherence to best practices.
  6. Continuous integration and test automation: Incorporate unit tests into your continuous integration (CI) pipeline and automate their execution. This ensures that tests are run regularly, providing timely feedback on the health of your codebase.

Challenges of Unit Testing

Unit testing comes with a host of challenges for developers:

  1. Managing thousands of unit tests without a dedicated test management tool is a resource-intensive task.
  2. Writing test scripts and maintaining them across code updates is also time-consuming.
  3. Setting up test environment for a wide variety of tests requires effort.
  4. Unit testing activities need to be seamlessly integrated into the development workflow.

What Makes Katalon Ideal for Unit Testing?

Katalon is a modern, AI-augmented test automation and quality management platform for web, mobile, API, and desktop applications. It provides a unified platform for teams to plan, design, execute, and manage automated testing efforts. 

 

First, let's see how easy it is to create a test with Katalon's Record-and-Playback:

 

After you've created your tests, you can immediately execute them in the environment of your choice:

 

Aside from the no-code testing, you also have access to a keyword library that are essentially code snippets to command the system to perform the action you want. For advanced users, there is also the option to switch to scripting in Java and Groovy. You can flexibly switch between these modes and enjoy the best of three worlds!

 

Start unit testing better with Katalon