Патерн async disposer

Повне пояснення

Що це і навіщо

• Патерн async disposer забезпечує чисте завершення асинхронних ресурсів (файли, мережеві з’єднання, таймери). Без нього ресурси можуть залишатися відкритими, що призводить до витоків.

Ключові принципи

• Метод dispose() повертає Promise.
• Використовується в try…finally або новій синтаксичній конструкції using.
• Підтримується в TypeScript через інтерфейс AsyncDisposable.

Як це працює

class FileHandler implements AsyncDisposable {
  private fd: number;
  constructor(fd: number) { this.fd = fd; }
  async dispose() {
    await fs.promises.close(this.fd);
  }
}

async function process() {
  const fh = new FileHandler(fd);
  try {
    // робота з файлом
  } finally {
    await fh.dispose();
  }
}

Практика і реалізація

• У TS: interface AsyncDisposable { dispose(): Promise<void>; }.
• У JS (ES2024): using fh = new FileHandler(fd); автоматично викликає dispose().

Тестування

• Використовувати Jest/Vitest:

test('dispose called', async () => {
  const mock = jest.fn().mockResolvedValue(undefined);
  class Dummy implements AsyncDisposable { dispose() { return mock(); } }
  const d = new Dummy();
  await d.dispose();
  expect(mock).toHaveBeenCalled();
});

Оптимізація та edge‑cases

• Переконатися, що dispose() не блокує інші асинхронні операції.
• Обробляти помилки в dispose() через try…catch або finally.
• У випадку багатьох ресурсів використовувати Promise.allSettled() для одночасного закриття.

Часті помилки

1. Забудьте викликати dispose() → витік.
2. Не обробляйте помилки в dispose() → crash.
3. Використання синхронного close у асинхронному коді → блокування.
4. Не використовувати using у TS 5.0+ → не автоматичне закриття.
5. Перевантаження dispose() без очікування → непередбачувана послідовність.
6. Відсутність типу AsyncDisposable → помилки під час компіляції.
7. Виклик dispose() після вже закритого ресурсу → помилка.
8. Не врахування AbortSignal у dispose() → некоректне завершення.

Cheatsheet

• dispose(): Promise<void> – асинхронне закриття.
• using (ES2024) – автоматичний виклик dispose().
• TS: implements AsyncDisposable.
• Тест: await instance.dispose(); expect(mock).toHaveBeenCalled();