Əsas məzmuna keçin

Test Adlandırma Konvensiyaları

Yaxşı adlandırma konvensiyaları test oxunaqlığını artırır və developerlərə test məqsədlərini tez başa düşməyə kömək edir.

Test Adlandırma üçün Ümumi Prinsiplər​

  1. Təsviri olun: Adlar nəyin test edildiyini aydın şəkildə göstərməlidir
  2. Tutarlı olun: Layihə boyu tutarlı naxış izləyin
  3. Qısa olun: Adlar məlumatverici olmalı, lakin həddindən artıq uzun olmamalıdır
  4. Davranışa diqqət yetirin: Adlar tətbiq təfərrüatlarını deyil, gözlənilən davranışı təsvir etməlidir
  5. Kontekst daxil edin: Adlar test edilən ssenari və ya şərtləri göstərməlidir

Test Class Naming Conventions​

Common Patterns​

PatternExample
[ClassUnderTest]TestUserServiceTest
Test[ClassUnderTest]TestUserService
[ClassUnderTest]TestsUserServiceTests
[ClassUnderTest]SpecUserServiceSpec (common in BDD)
[ClassUnderTest]ShouldUserServiceShould (common in BDD)

Language-Specific Conventions​

Java (JUnit)​

Koda bax
// Class under test: UserService
public class UserServiceTest { }

C# (.NET)​

// Class under test: UserService
public class UserServiceTests { }

JavaScript/TypeScript (Jest)​

// File naming: user-service.test.js or user-service.spec.js
describe('UserService', () => { });

Python (pytest)​

# File naming: test_user_service.py
class TestUserService:
    pass

Test Method Naming Conventions​

Common Patterns​

  1. MethodName_StateUnderTest_ExpectedBehavior

    @Test
    void getUserById_UserExists_ReturnsUser() { }

  2. should_ExpectedBehavior_When_StateUnderTest

    @Test
    void should_ReturnUser_When_UserExists() { }

  3. test[Feature being tested]

    @Test
    void testUserRetrieval() { }

Java Examples​

Koda bax
@Test
void getUserById_WithValidId_ReturnsCorrectUser() { }

@Test
void createUser_WithExistingUsername_ThrowsDuplicateException() { }

Naming in Different Testing Types​

Unit Tests​

Koda bax
@Test
void calculateTotal_WithValidItems_ReturnsSumOfPrices() { }

Integration Tests​

Koda bax
@Test
void userController_SavesUserToDatabase_WhenValidUserSubmitted() { }

End-to-End Tests​

Koda bax
@Test
void userRegistration_WithValidCredentials_CreatesAccountAndRedirectsToDashboard() { }

BDD-Style Naming (Given-When-Then)​

Behavior-Driven Development uses a specific pattern:

Given [precondition]
When [action]
Then [expected result]

Example in Cucumber:

Scenario: User login with valid credentials
  Given a user exists with username "john" and password "password123"
  When the user attempts to login with username "john" and password "password123"
  Then the user should be successfully logged in
  And redirected to the dashboard page

Best Practices​

  1. Avoid technical details in test names (e.g., avoid mentioning specific HTTP status codes)
  2. Avoid implementation details that might change (focus on behavior, not how it's implemented)
  3. Use domain language that business stakeholders can understand
  4. Be consistent within your team and project
  5. Update test names when requirements or behaviors change
  6. Group related tests using nested classes or describe blocks