# CronDelete

يُلغي مهمة cron مجدولة مسبقاً باستخدام `CronCreate`. يزيلها فوراً من مخزن الجلسة في الذاكرة. لا يُنتج أي أثر إذا كانت المهمة قد حُذفت تلقائياً بالفعل (تُحذف المهام أحادية التنفيذ بعد إطلاقها، وتنتهي صلاحية المهام المتكررة بعد 7 أيام).

## متى يُستخدم

- عندما يطلب المستخدم إيقاف مهمة مجدولة متكررة قبل انتهاء صلاحيتها التلقائية بعد 7 أيام.
- عندما لا تكون مهمة أحادية التنفيذ ضرورية بعد الآن وينبغي إلغاؤها قبل إطلاقها.
- عند الحاجة إلى تغيير تعبير الجدولة لمهمة موجودة — احذفها باستخدام `CronDelete`، ثم أعد إنشاءها باستخدام `CronCreate` بالتعبير الجديد.
- تنظيف عدة مهام قديمة للحفاظ على نظافة مخزن الجلسة.

## المعاملات

- `id` (string، مطلوب): معرّف المهمة الذي أعادته `CronCreate` عند إنشاء المهمة لأول مرة. يجب أن تتطابق هذه القيمة تماماً؛ لا يُدعم البحث التقريبي أو البحث بالاسم.

## أمثلة

### مثال 1: إلغاء مهمة متكررة قيد التشغيل

تم إنشاء مهمة متكررة مسبقاً بمعرّف `"cron_abc123"`. يطلب المستخدم إيقافها.

```
CronDelete({ id: "cron_abc123" })
```

تُزال المهمة من مخزن الجلسة ولن تُطلق مجدداً.

### مثال 2: إزالة مهمة أحادية التنفيذ قديمة قبل إطلاقها

جُدولت مهمة أحادية التنفيذ بمعرّف `"cron_xyz789"` للتشغيل بعد 30 دقيقة، لكن المستخدم قرر أنها لم تعد ضرورية.

```
CronDelete({ id: "cron_xyz789" })
```

تُلغى المهمة. لن تُنفَّذ أي إجراء عند وصول وقت الإطلاق الأصلي.

## ملاحظات

- يجب الحصول على `id` من القيمة المُعادة بواسطة `CronCreate`. لا توجد طريقة للبحث عن مهمة بالوصف أو الاستدعاء الخلفي — احفظ المعرّف إذا كنت قد تحتاج إلى الإلغاء لاحقاً.
- إذا كانت المهمة قد حُذفت تلقائياً بالفعل (أُطلقت كمهمة أحادية التنفيذ، أو وصلت إلى انتهاء الصلاحية المتكررة بعد 7 أيام)، فإن استدعاء `CronDelete` بذلك المعرّف لا يُنتج أي أثر ولن يُولّد خطأ.
- يؤثر `CronDelete` فقط على الجلسة الحالية في الذاكرة. إذا كانت بيئة التشغيل لا تحفظ حالة cron عبر إعادة التشغيل، ستُفقد المهام المجدولة عند إعادة التشغيل بغض النظر عمّا إذا كان `CronDelete` قد استُدعي أم لا.
- لا توجد عملية حذف جماعي؛ قم بإلغاء كل مهمة بشكل فردي باستخدام `id` الخاص بها.
