ما هو كائن process وماذا يمكنه أن يفعل؟

Question

Accepted Answer

**`process`** هو كائن عام يوفر معلومات والتحكم في **عملية Node.js الحالية**. إنه واجهتك للبيئة، ومعاملات سطر الأوامر، وتدفقات الإدخال/الإخراج، ودورة الحياة، والإشارات.

## قراءة متغيرات البيئة

```js
process.env.NODE_ENV;        // "production" | "development"
process.env.DATABASE_URL;    // configuration & secrets injected by the environment
const port = process.env.PORT || 3000;
```

`process.env` هي الطريقة القياسية لقراءة الإعدادات والأسرار (المعرّفة خارج الكود) — أساسية لإعداد twelve-factor.

## معاملات سطر الأوامر

```js
// node script.js --name=Ann
process.argv; // ["node", "/path/script.js", "--name=Ann"]
const args = process.argv.slice(2); // skip the first two
```

## تدفقات الإدخال/الإخراج القياسية

```js
process.stdout.write("output
");   // console.log writes here
process.stderr.write("error
");    // console.error writes here
process.stdin.on("data", (chunk) => { /* read input */ });
```

## دورة حياة العملية والخروج

```js
process.exit(0);   // exit with success code (1 = error)
process.exitCode = 1; // preferred: set code, let the process finish naturally
process.pid;       // the process id
process.cwd();     // current working directory
process.uptime();  // seconds the process has run
```

## معالجة الإشارات والأخطاء غير المُمسكة (للإغلاق الفعّال / شبكات الأمان)

```js
process.on("SIGTERM", () => { /* clean up, then exit — e.g. on container stop */ });
process.on("SIGINT", () => { /* Ctrl+C */ });
process.on("uncaughtException", (err) => { log(err); process.exit(1); });
process.on("unhandledRejection", (reason) => { log(reason); });
```

الاستماع إلى `SIGTERM`/`SIGINT` هي كيفية تنفيذ **الإغلاق الفعّال** (إنهاء الطلبات الجارية، إغلاق اتصالات قاعدة البيانات قبل الخروج)، وأجهزة معالجة الأخطاء غير المُمسكة هي شبكات أمان الملاذ الأخير.

## أعضاء مفيدون آخرون

```js
process.memoryUsage(); // heap stats (leak detection)
process.nextTick(cb);  // schedule a callback before the next event-loop phase
process.platform;      // "linux" | "darwin" | "win32"
```

## لماذا يهم هذا

`process` هو اتصال برنامجك ببيئة وقت التشغيل.

تستخدمه باستمرار: قراءة الإعدادات/الأسرار عبر `process.env`، التعامل مع معاملات CLI، وبشكل مهم للإنتاج — اكتشاف الإشارات للإغلاق الفعّال وأجهزة معالجة الأخطاء الملاذ الأخير.

فهمه أساسي لبناء تطبيقات Node قابلة للتكوين وقوية وجاهزة للإنتاج.