مرجع سريع

ورقة غش كائن process في Node.js

دليل مرجعي سريع لكائن process العام في Node.js: وسيطات سطر الأوامر، متغيرات البيئة، رموز الخروج، مجلد العمل واعتراض الأحداث.

· تاريخ النشر

يوفر كائن process العام في Node.js معلومات وتحكما في عملية Node.js الجارية حاليا دون الحاجة إلى استيراده عبر require.

وسيطات الأوامر ومعلومات البيئة

// مصفوفة وسيطات سطر الأوامر
// عند التشغيل: node script.js --mode=prod input.txt
process.argv;
// => ['/path/to/node', '/path/to/script.js', '--mode=prod', 'input.txt']

// قاموس متغيرات البيئة
const port = process.env.PORT || 3000;
const isDev = process.env.NODE_ENV !== 'production';

// معرف العملية ومعمارية نظام التشغيل
process.pid;      // Process ID integer
process.platform; // 'darwin', 'linux', 'win32'
process.arch;     // 'x64', 'arm64'

التنقل في المجلدات ومسار العمل

// مسار مجلد العمل الحالي
console.log(process.cwd()); // e.g. "/Users/project"

// تغيير مسار مجلد العمل
process.chdir('/tmp');

إنهاء العملية ورموز الخروج (Exit Codes)

// إنهاء سليم وناجح للعملية
process.exit(0);

// إنهاء مع خطأ (رمز خروج غير صفري)
process.exit(1);

// اعتراض حدث الخروج
process.on('exit', (code) => {
  console.log(`Process exited with code: ${code}`);
});

// اعتراض الاستثناءات غير المعالجة لمنع الانهيار الصامت
process.on('uncaughtException', (err) => {
  console.error('Fatal crash:', err);
  process.exit(1);
});

مراجع ذات صلة

موضوعات ذات صلة