# 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`.
