Extension در Swift: چیست، نحو و چگونه متدها را اضافه کنیم

Extension در Swift چیست؟

Extension در Swift یک ساختار زبانی است که امکان گسترش نوع موجود (کلاس، ساختار، enum، پروتکل) با قابلیت‌های جدید را فراهم می‌کند. این مشابه دسته‌بندی‌ها در Objective-C است، اما با قابلیت‌های بیشتر.

Extension می‌تواند اضافه کند:

• ویژگی‌های محاسبه‌شده نمونه و نوع
• متدها نمونه و نوع
• مقداردهنده‌ها (convenience init)
• زیرنویس‌ها
• انواع تو در تو
• Protocol conformances

طبق مستندات Apple، extension نمی‌تواند متدهای موجود (dynamic dispatch) را بازنویسی کند و نمی‌تواند stored properties اضافه کند. این محدودیت‌ها یکپارچگی نوع اصلی را حفظ می‌کنند.

نحو افزونه‌ها

Extension با کلمه کلیدی extension و ذکر نوع گسترش‌یافته اعلام می‌شود.

extension Double {
    var km: Double { return self * 1000.0 }
    var cm: Double { return self / 100.0 }
    var mm: Double { return self / 1000.0 }
}

let distance = 5.0.km
print("5 km = \(distance) متر") // 5000.0

شما می‌توانید نه تنها انواع خود، بلکه انواع کتابخانه استاندارد Swift، Foundation، UIKit و سایر فریمورک‌ها را گسترش دهید. این باعث می‌شود extension ابزاری قدرتمند برای افزودن قابلیت‌های خاص دامنه باشد.

افزودن متدها از طریق extension

Extension امکان افزودن متدهای نمونه و نوع به هر نوع موجود را فراهم می‌کند.

extension String {
    func isValidEmail() -> Bool {
        let emailRegex = "[A-Z0-9a-z._%+-]+@[A-Za-z0-9.-]+\\.[A-Za-z]{2,}"
        return self.range(of: emailRegex, options: .regularExpression) != nil
    }

    static func random(length: Int) -> String {
        let letters = "abcdefghijklmnopqrstuvwxyz0123456789"
        return String((0..<length).map { _ in letters.randomElement()! })
    }
}

let email = "user@example.com"
print(email.isValidEmail()) // true
let code = String.random(length: 8) // "a3f8k2m1"

متدهای تغییردهنده انواع مقداری (struct, enum) را گسترش می‌دهند و می‌توانند self را تغییر دهند. برای کلاس‌ها تغییردهنده لازم نیست. Extension می‌تواند حتی به انواع کتابخانه استاندارد متدهای تغییردهنده اضافه کند.

Computed Properties در extension

Extension فقط می‌تواند ویژگی‌های محاسبه‌شده اضافه کند — stored properties ممنوع هستند. این منطقی است: extension حافظه نوع اصلی را مدیریت نمی‌کند.

extension Date {
    var isPast: Bool {
        return self < Date()
    }

    var isToday: Bool {
        return Calendar.current.isDateInToday(self)
    }
}

let someDate = Date().addingTimeInterval(3600)
print(someDate.isPast) // false (یک ساعت بعد از الان آینده است)

Computed properties در extension تابع همان قوانین پیاده‌سازی اصلی هستند: می‌توان ویژگی‌های { get } و { get set } ایجاد کرد. Swift محدودیتی برای تعداد extension برای یک نوع قائل نمی‌شود. شما می‌توانید هر تعداد extension برای یک نوع در فایل‌های مختلف اعلام کنید — این یک روش استاندارد در پروژه‌های بزرگ است.

پیاده‌سازی پروتکل‌ها از طریق extension

Extension روش ترجیحی برای پیاده‌سازی پروتکل‌ها است. به جای شلوغ کردن اعلام اصلی نوع، تمام متدهای پروتکل در یک extension جداگانه قرار می‌گیرند.

struct User {
    let id: Int
    let name: String
    let email: String
}

// Extension به ازای پروتکل — جداسازی تمیز
extension User: Equatable {
    static func == (lhs: User, rhs: User) -> Bool {
        return lhs.id == rhs.id
    }
}

extension User: Codable {
    enum CodingKeys: String, CodingKey {
        case id, name, email
    }
}

این رویکرد مسئولیت‌ها را جدا می‌کند: ساختار اصلی فقط شامل stored properties است، extensions — پیاده‌سازی پروتکل‌ها. Swift حتی اجازه می‌دهد پروتکل از طریق extension برای انواعی که کنترل نمی‌کنیم پیاده‌سازی شود.

Extension و سازماندهی کد

Extension نه فقط یک امکان زبانی، بلکه ابزاری برای سازماندهی معماری است. استفاده صحیح از extensions کد را خوانا و قابل نگهداری می‌کند.

• گروه‌بندی بر اساس پروتکل‌ها — هر پروتکل در یک extension جداگانه
• علامت‌گذاری (MARK) — // MARK: - Equatable برای ناوبری
• تقسیم فایل‌ها — extensions برای پروتکل‌های مختلف در فایل‌های جداگانه
• کمک‌گیرنده‌های خصوصی — متدهای خصوصی در extension با private مشخص می‌شوند

// MARK: - User + Displayable
extension User: Displayable {
    var displayName: String {
        return "\(name) (\(email))"
    }
}

طبق Swift API Design Guidelines، extensions خوانایی را بهبود می‌بخشند: توسعه‌دهنده ساختار داده را در اعلام اصلی و منطق را در extensions می‌بیند. این با اصل جداسازی رابط (Interface Segregation) مطابقت دارد.

Extension با محدودیت‌های where متدها را فقط برای انواع خاص اضافه می‌کند: extension Array where Element: Equatable { func isUnique() -> Bool }. چنین کدی مختصر و نوع‌امن است — متد isUnique فقط در آرایه‌هایی با عناصر Equatable ظاهر می‌شود و خطاها را در مرحله کامپایل حذف می‌کند و API را تمیزتر، امن‌تر و قابل‌فهم‌تر برای سایر توسعه‌دهندگان می‌کند.