Apakah utiliti yang membantu bekerja dengan kod async (promisify, AbortController)?

Question

Accepted Answer

Node menyediakan beberapa utiliti yang menjadikan kod async lebih kemas dan lebih terkawal — menukar API callback lama kepada Promises, membatalkan operasi, dan menyelaraskan berbilang tugas async.

## promisify — tukar API callback kepada Promises

```js
import { promisify } from "util";
import fs from "fs";

// turn an error-first callback function into a Promise-returning one
const readFileAsync = promisify(fs.readFile);
const data = await readFileAsync("file.txt", "utf8"); // now awaitable
```

`promisify` membungkus mana-mana fungsi callback `(args..., (err, result) => {})` standard supaya anda boleh `await` ia — berguna untuk pustaka lama yang wujud sebelum Promises. (Banyak built-in kini menawarkan versi promise secara terus, cth. `fs/promises`.)

## AbortController — batalkan operasi async

```js
const controller = new AbortController();

// pass the signal to a cancellable operation
const promise = fetch("https://api.example.com", { signal: controller.signal });

// cancel it (e.g. on timeout or user navigation)
setTimeout(() => controller.abort(), 5000); // abort after 5s

try {
  await promise;
} catch (err) {
  if (err.name === "AbortError") console.log("request cancelled");
}
```

`AbortController` menyediakan cara standard untuk **membatalkan** operasi yang sedang berjalan (fetch, timers, streams, banyak pustaka) — penting untuk timeouts dan mengelakkan kerja terbuang apabila sesuatu keputusan tidak lagi diperlukan.

## Promise combinators — selaraskan berbilang tugas async

```js
// run in parallel, wait for ALL (fails fast if any rejects)
const [a, b, c] = await Promise.all([getA(), getB(), getC()]);

// wait for all, get each result OR error (never short-circuits)
const results = await Promise.allSettled([getA(), getB()]);

// the first to settle (resolve OR reject) wins
const fastest = await Promise.race([fetchPrimary(), fetchBackup()]);

// the first to FULFILL (ignores rejections until one succeeds)
const first = await Promise.any([source1(), source2()]);
```

Combinators ini menyatakan corak biasa: `all` untuk selari-dan-tunggu, `allSettled` apabila anda memerlukan setiap hasil tanpa mengira kegagalan, `race` untuk timeouts/pantas-menang, `any` untuk sumber sandaran.

## setTimeout sebagai Promise (moden)

```js
import { setTimeout as sleep } from "timers/promises";
await sleep(1000); // await a delay without wrapping in a Promise manually
```

## Mengapa ia penting

Utiliti ini menjadikan kod async Node dunia sebenar lebih kemas dan lebih kukuh: `promisify` merapatkan API callback lama ke dalam async/await, `AbortController` menambah pembatalan dan timeouts (mencegah operasi tergantung atau terbuang), dan Promise combinators (`all`/`allSettled`/`race`/`any`) menyatakan corak penyelarasan biasa secara ringkas dan tepat.

Mengetahuinya membolehkan anda mengendalikan keselarian, pembatalan, dan sandaran dengan elegan dan bukannya mencipta semula — keperluan biasa dalam sebarang aplikasi async yang bukan remeh.