ما هو نمط Singleton؟

Question

Accepted Answer

يضمن نمط **Singleton** أن تحتوي فئة على **مثيل واحد فقط** ويوفر نقطة وصول عامة له. يُستخدم عندما يجب أن يُنسّق كائن واحد بالضبط شيئًا ما (إعدادات، مجمع الاتصالات، logger)، على الرغم من أنه أيضًا مثير للجدل إلى حد ما.

## ما يفعله Singleton

```text
SINGLETON → guarantee a class has only ONE instance, with global access to it:
  → the class controls its own instantiation (private constructor)
  → returns the SAME instance every time it's requested
→ for: things there should only be ONE of, accessed from many places
```

## مثال

```js
class Config {
  static #instance;
  static getInstance() {
    if (!Config.#instance) {
      Config.#instance = new Config();   // create once
    }
    return Config.#instance;             // always return the same instance
  }
}
// Config.getInstance() always returns the same object
```

## الاستخدامات الشائعة والجدل حوله

```text
USES → configuration objects, loggers, connection pools, caches (one shared instance)
⚠️ CONTROVERSIAL → Singletons are often criticized:
  → GLOBAL STATE in disguise → hidden dependencies, hard to TEST (can't easily mock/replace),
    tight coupling, issues with concurrency
  → often better: DEPENDENCY INJECTION (pass the single instance in) → same "one instance"
    benefit but testable and explicit
→ use sparingly; consider DI as an alternative; valid for genuinely-single resources
```

## لماذا يهم هذا

فهم نمط Singleton مفيد لأنه أحد **أشهر أنماط التصميم** (يتم مواجهته ومناقشته بشكل متكرر)، وفهمه — بما في ذلك جدله — يعكس حكمًا تصميميًا جيدًا.

يضمن Singleton أن تحتوي فئة على مثيل واحد فقط مع وصول عام، ويُستخدم عندما يجب حقًا أن يكون هناك واحد فقط من شيء ما (إعدادات، logger، مجمع اتصالات، cache) يتم الوصول إليه من أماكن عديدة.

فهم ما يفعله (فئة تتحكم في إنشاء مثيلاتها الخاصة لإرجاع نفس المثيل في كل مرة) هو المعرفة الأساسية.

ومع ذلك، فهم **الجدل** نفس أهمية هذا ويعكس حكمًا ناضجًا: يُنتقد Singleton على نطاق واسع لأنه في الأساس **حالة عامة مقنعة**، مما يخلق **تبعيات مخفية** (الكود الذي يستخدم Singleton له تبعية غير معلنة)، مما يجعل الكود **صعب الاختبار** (لا يمكنك بسهولة محاكاة أو استبدال المثيل الواحد)، مما يسبب ارتباطًا وثيقًا، وينطوي على مشاكل التزامن.

فهم أن **حقن التبعيات غالبًا ما يكون بديلًا أفضل** (تمرير المثيل الواحد، توفير نفس فائدة "المثيل الواحد" ولكن بطريقة قابلة للاختبار وصريحة) يعكس الحكم التصميمي لتفضيل DI على Singletons في كثير من الحالات.

هذا الفهم المتوازن — معرفة النمط ولكن أيضًا مشاكله وبدائله الأفضل — هو ما يميز الاستخدام المدروس عن تقليد الأنماط دون فهم.