ورقة غش واجهة برمجة تطبيقات Node.js الأساسية

دليل مرجعي سريع لواجهات برمجة تطبيقات وقت تشغيل Node.js الأساسية: الكائنات العامة، تشغيل العمليات الفرعية وتوليدها، تنسيق الفحص وتدفقات العمليات.

إعداد Cheat Sheets · تاريخ النشر24 أكتوبر 2026

Node.js هو بيئة تشغيل جافا سكريبت مبنية على محرك V8 في Chrome تنفذ تعليمات برمجية غير متزامنة موجهة بالأحداث على الخوادم.

المتغيرات العامة

المتغيرات العامة الشائعة على مستوى الوحدة في CommonJS:

__filename; // المسار المطلق لملف الوحدة الحالية
__dirname;  // المسار المطلق لمجلد الوحدة الحالية

العمليات الفرعية (Child Processes)

`child_process.exec()`

تخزين مخرجات العملية مؤقتا وتمرير stdout/stderr إلى رد الاتصال (مثالي للبرامج النصية الصغيرة):

const { exec } = require('child_process');

exec('ls -la | grep .js', (error, stdout, stderr) => {
  if (error) {
    console.error(`Execution error: ${error.message}`);
    return;
  }
  console.log(`Output: ${stdout}`);
});

`child_process.spawn()`

تدفق بيانات العملية دون تخزين مؤقت (مثالي للعمليات طويلة الأمد والمخرجات الكبيرة):

const { spawn } = require('child_process');

// وراثة stdin/stdout/stderr مباشرة في الطرفية
const child = spawn('npm', ['test'], { stdio: 'inherit' });

child.on('error', (err) => {
  if (err.code === 'ENOENT') console.error('الملف القابل للتنفيذ غير موجود');
  if (err.code === 'EACCES') console.error('تم رفض الإذن');
});

child.on('exit', (code, signal) => {
  console.log(`انتهت العملية برمز ${code}`);
});

التنسيق والفحص (util.inspect)

const util = require('util');

// فحص الكائنات المعقدة بعمق مع تلوين بناء الجملة
const output = util.inspect(complexObject, {
  showHidden: false,
  depth: null,
  colors: true
});

process.stdout.write(output + '\n');