Unajuaje jinsi ya kueneza michakato ya nje kwa kutumia child_process?

Question

Accepted Answer

Moduli ya **`child_process`** inaruhusu Node kueneza **programu/amri nyingine** (amri za shell, hati, bainari nyingine) kama michakato tofauti ya OS. Muhimu kwa kumita zana za mfumo, kueneza kazi nzito ya CPU nje ya mchakato mkuu, au kuandaa programu nyingine.

## Njia nne kuu

```text
exec      → run a shell command, buffer all output (simple, small output)
execFile  → run a file directly (no shell — safer, faster)
spawn     → stream output (for large output / long-running processes)
fork      → spawn a new NODE process with an IPC channel (Node-to-Node)
```

## exec — rahisi, buffered

```js
import { exec } from "child_process";

exec("ls -la", (err, stdout, stderr) => {
  if (err) return console.error(err);
  console.log(stdout); // the entire output, buffered into memory
});
```

`exec` ni rahisi kwa amri fupi lakini hubuffer matokeo yote — hatari kwa amri zenye matokeo makubwa (inaweza kuzidi kiwango cha buffer).

## spawn — streaming (kwa matokeo makubwa/endelevu)

```js
import { spawn } from "child_process";

`spawn` inavogezesha matokeo kadri inavyozalishwa (kumbukumbu ya kawaida) na inachukua hoja kama **array** (si kamba ya shell) — chaguo sahihi kwa michakato ya muda mrefu au matokeo makubwa.

## Onyo wa usalama: command injection

```js
// ❌ DANGEROUS — user input in a shell command enables injection
exec(`convert ${userFilename} out.png`); // userFilename = "; rm -rf /" → disaster

// ✅ use execFile/spawn with an args array — no shell interpolation
execFile("convert", [userFilename, "out.png"]); // args passed safely, not parsed by a shell
```

Usiweke ingizo lisilotegemeana katika kamba ya shell ya `exec` — inaruhusu **command injection**. Tumia `execFile`/`spawn` na array ya hoja ili ingizo litumike kama data, si sintaksi ya shell.

## Matumizi ya Promise

```js
import { promisify } from "util";
const execAsync = promisify(exec);
const { stdout } = await execAsync("git rev-parse HEAD");
```

## Kwa nini umuhimu

`child_process` inaruhusu Node kuunganisha na mfumo mkubwa — kueneza zana za CLI (git, ffmpeg, imagemagick), kubadilisha kazi nzito ya CPU kwa michakato tofauti (kuzuia kuzuia event loop), na kuandaa programu nyingine.

Kujua ni njia gani ya kutumia (`spawn` kwa streaming/matokeo makubwa, `exec` kwa amri rahisi, `fork` kwa subprocesses za Node) na — muhimu — **hatari ya command-injection** ya `exec` kwa ingizo la mtumiaji (kupunguzwa kwa `execFile`/`spawn` na arrays ya hoja) ni muhimu kwa kuitumia kwa ufanisi na salama.