اختبار الوحدات في لغة جافا سكريبت: الهيكل وال أفضل الممارسات

package calculator

import "testing"
// يمكن الوصول إلى الدوال والمتغيرات غير المعلنة

package calculator_test

import (
    "testing"
    "myproject/calculator"
)
// يمكن الوصول فقط إلى الدوال المعلنة (الموصى بها لواجهات API العامة)

package calculator

import "testing"

// يجب أن تبدأ دالة الاختبار بـ "Test"
func TestAdd(t *testing.T) {
    result := Add(2, 3)
    expected := 5
    
    if result != expected {
        t.Errorf("Add(2, 3) = %d; want %d", result, expected)
    }
}

func TestCalculate(t *testing.T) {
    tests := []struct {
        name     string
        a, b     int
        op       string
        expected int
        wantErr  bool
    }{
        {"addition", 2, 3, "+", 5, false},
        {"subtraction", 5, 3, "-", 2, false},
        {"multiplication", 4, 3, "*", 12, false},
        {"division", 10, 2, "/", 5, false},
        {"division by zero", 10, 0, "/", 0, true},
    }

    for _, tt := range tests {
        t.Run(tt.name, func(t *testing.T) {
            result, err := Calculate(tt.a, tt.b, tt.op)
            
            if (err != nil) != tt.wantErr {
                t.Errorf("Calculate() error = %v, wantErr %v", err, tt.wantErr)
                return
            }
            
            if result != tt.expected {
                t.Errorf("Calculate(%d, %d, %q) = %d; want %d", 
                    tt.a, tt.b, tt.op, result, tt.expected)
            }
        })
    }
}

# تشغيل الاختبارات في الدليل الحالي
go test

# تشغيل الاختبارات مع إخراج مفصل
go test -v

# تشغيل الاختبارات في جميع الدلائل الفرعية
go test ./...

# تشغيل اختبار معين
go test -run TestAdd

# تشغيل اختبارات مطابقة للنمط
go test -run TestCalculate/addition

# تشغيل الاختبارات بالتوازي (الافتراضي هو GOMAXPROCS)
go test -parallel 4

# تشغيل الاختبارات مع مهلة
go test -timeout 30s

# تشغيل الاختبارات مع تغطية
go test -cover

# إنشاء ملف تغطية
go test -coverprofile=coverage.out

# عرض التغطية في المتصفح
go tool cover -html=coverage.out

# عرض التغطية حسب الدالة
go tool cover -func=coverage.out

# تحديد وضع التغطية (set، count، atomic)
go test -covermode=count -coverprofile=coverage.out

func assertEqual(t *testing.T, got, want int) {
    t.Helper() // هذه السطر يُعتبر المُعلِّن
    if got != want {
        t.Errorf("got %d, want %d", got, want)
    }
}

func TestMath(t *testing.T) {
    result := Add(2, 3)
    assertEqual(t, result, 5) // خط الأخطاء يشير هنا
}

func TestMain(m *testing.M) {
    // الكود الخاص بالتهيئة
    setup()
    
    // تشغيل الاختبارات
    code := m.Run()
    
    // الكود الخاص بالإنهاء
    teardown()
    
    os.Exit(code)
}

func setupTestCase(t *testing.T) func(t *testing.T) {
    t.Log("setup test case")
    return func(t *testing.T) {
        t.Log("teardown test case")
    }
}

func TestSomething(t *testing.T) {
    teardown := setupTestCase(t)
    defer teardown(t)
    
    // كود الاختبار هنا
}

// الكود الإنتاجي
type Database interface {
    GetUser(id int) (*User, error)
}

type UserService struct {
    db Database
}

func (s *UserService) GetUserName(id int) (string, error) {
    user, err := s.db.GetUser(id)
    if err != nil {
        return "", err
    }
    return user.Name, nil
}

// كود الاختبار
type MockDatabase struct {
    users map[int]*User
}

func (m *MockDatabase) GetUser(id int) (*User, error) {
    if user, ok := m.users[id]; ok {
        return user, nil
    }
    return nil, errors.New("user not found")
}

func TestGetUserName(t *testing.T) {
    mockDB := &MockDatabase{
        users: map[int]*User{
            1: {ID: 1, Name: "Alice"},
        },
    }
    
    service := &UserService{db: mockDB}
    name, err := service.GetUserName(1)
    
    if err != nil {
        t.Fatalf("unexpected error: %v", err)
    }
    if name != "Alice" {
        t.Errorf("got %s, want Alice", name)
    }
}

import (
    "github.com/stretchr/testify/assert"
    "github.com/stretchr/testify/mock"
)

func TestWithTestify(t *testing.T) {
    result := Add(2, 3)
    assert.Equal(t, 5, result, "they should be equal")
    assert.NotNil(t, result)
}

// مثال على المساعد
type MockDB struct {
    mock.Mock
}

func (m *MockDB) GetUser(id int) (*User, error) {
    args := m.Called(id)
    return args.Get(0).(*User), args.Error(1)
}

func BenchmarkAdd(b *testing.B) {
    for i := 0; i < b.N; i++ {
        Add(2, 3)
    }
}

// تشغيل اختبارات الأداء
// go test -bench=. -benchmem

package user

import (
    "errors"
    "testing"
)

type User struct {
    ID    int
    Name  string
    Email string
}

func ValidateUser(u *User) error {
    if u.Name == "" {
        return errors.New("name cannot be empty")
    }
    if u.Email == "" {
        return errors.New("email cannot be empty")
    }
    return nil
}

// ملف الاختبار: user_test.go
func TestValidateUser(t *testing.T) {
    tests := []struct {
        name    string
        user    *User
        wantErr bool
        errMsg  string
    }{
        {
            name:    "valid user",
            user:    &User{ID: 1, Name: "Alice", Email: "alice@example.com"},
            wantErr: false,
        },
        {
            name:    "empty name",
            user:    &User{ID: 1, Name: "", Email: "alice@example.com"},
            wantErr: true,
            errMsg:  "name cannot be empty",
        },
        {
            name:    "empty email",
            user:    &User{ID: 1, Name: "Alice", Email: ""},
            wantErr: true,
            errMsg:  "email cannot be empty",
        },
    }

    for _, tt := range tests {
        t.Run(tt.name, func(t *testing.T) {
            err := ValidateUser(tt.user)
            
            if (err != nil) != tt.wantErr {
                t.Errorf("ValidateUser() error = %v, wantErr %v", err, tt.wantErr)
                return
            }
            
            if err != nil && err.Error() != tt.errMsg {
                t.Errorf("ValidateUser() error message = %v, want %v", err.Error(), tt.errMsg)
            }
        })
    }
}