ما هو اختبار اللقطة (Snapshot Testing)؟

Question

Accepted Answer

**اختبار اللقطة** يلتقط "لقطة" من بعض المخرجات (عادة مخرجات مكون واجهة المستخدم المعروضة أو هيكل بيانات) ويقارن عمليات التشغيل المستقبلية مقابلها — مما يشير إلى الحالات التي تتغير فيها المخرجات. إنه مفيد للكشف عن التغييرات غير المقصودة، لكن له قيود يجب فهمها.

## كيفية عمل اختبار اللقطة

```text
1. First run → the test RECORDS the output (e.g. a rendered component) as a SNAPSHOT file
2. Later runs → COMPARE the current output to the saved snapshot:
   → MATCHES → pass; DIFFERS → fail (the output changed)
3. If the change is INTENTIONAL → UPDATE the snapshot (review the diff, then accept)
```

```js
// Jest snapshot test (e.g. a React component)
test('renders correctly', () => {
  const tree = render(<Button label="Click" />).toJSON();
  expect(tree).toMatchSnapshot();    // compares to the stored snapshot
});
```

## الاستخدامات والفوائد

```text
✓ Detect UNINTENDED CHANGES — flags when output changes unexpectedly (UI, serialized data)
✓ FAST to write — no manual assertions for complex output; auto-captures the expected result
✓ Good for UI components (catch unexpected rendering changes), config, large data structures
```

## القيود (استخدم بحذر)

```text
⚠️ Snapshots don't verify CORRECTNESS — they capture whatever output exists (even if WRONG);
   they only detect CHANGE, not that the output is RIGHT
⚠️ BLINDLY UPDATING snapshots (jest -u without reviewing) → defeats the purpose (accepting
   broken output) — a common bad habit
⚠️ Large/brittle snapshots → change often, get rubber-stamped, low value
→ Use for change detection; keep snapshots small/focused; REVIEW snapshot diffs;
  don't rely on them alone (combine with real assertions for behavior).
```

## لماذا يهم

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

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

فهم هذه الفوائد يشرح شعبيتها، خاصة في اختبار واجهات المستخدم.

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

**أكبر مشكلة هي تحديث اللقطات بشكل عمياء** (تشغيل أمر التحديث دون مراجعة الفرق)، وهذا يهزم الغرض بقبول مخرجات قد تكون معطوبة — عادة سيئة شائعة.

اللقطات الكبيرة والهشة التي تتغير كثيراً يتم الموافقة عليها دون اكتراث وتوفر قيمة قليلة.

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

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